[TS-1833] Deprecate TSMimeHdrFieldValueStringInsert() (and family)

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Invalid
• Component/s: TS API
• Labels: api-change
• Assignee: Unassigned
• Reporter: Leif Hedstrom
• Created: 18/Apr/13 23:48
• Updated: 11/Jun/15 19:26
• Resolved: 11/Jun/15 19:26

Description

It seems to be that TSMimeHdrFieldValueStringInsert() is really just a subset of TSMimeHdrFieldValueStringSet(). This just makes for confusing APIs, i.e. which one do I use when? The alternative would be to remove the "idx" argument to the TSMimeHdrFieldValueStringSet() method, but that would then break API and ABI compatibility.

Also, as James found out, the docs are less than clear. Set() needs to be called with an idx of -1 for it to actually be a Set() operation. With idx >=0, TSMimeHdrFieldValueStringSet() is actually identical to TSMimeHdrFieldValueStringInsert()....