CFStringInsert |
||||
Header: | CFString.h | Carbon status: | Supported | |
Inserts a string at a specified location in the character buffer of a mutable CFString object.
void CFStringInsert ( CFMutableStringRef str, CFIndex index, CFStringRef insertedStr );
Pass a reference to a mutable CFString object. It the referenced object is not a mutable CFString object, an assertion is raised.
Pass an integer specifying the index of the character in the mutable CFString object after which the new characters are to be inserted. The function raises an assertion if the index is out of bounds.
Pass a reference to a CFString object containing the characters to be inserted in the mutable CFString object referenced by the first parameter.
The CFStringInsert function inserts the characters contained by a CFString object in a mutable CFString object. To accomodate the new characters, it moves any existing characters to the right of the inserted characters the appropriate number of positions.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)