Functions

Core Foundation String Services provides these functions:

CFShow Prints a description of a Core Foundation object. This function can be called in debuggers that support function calls.
CFShowStr Prints the attributes of a CFString object.
CFSTR Creates an immutable CFString object from a constant compile-time string.
CFStringAppend Appends the characters of a CFString object to those of a a mutable CFString object.
CFStringAppendCharacters Appends a buffer of Unicode characters to the character contents of a mutable CFString object.
CFStringAppendCString Appends a C string to the character contents of a mutable CFString object.
CFStringAppendFormat Appends a formatted string to the character contents of a mutable CFString object.
CFStringAppendPascalString Appends a Pascal string to the character contents of a mutable CFString object.
CFStringCapitalize Changes the first character represented by a CFString object to uppercase (if it is a lowercase alphabetical character).
CFStringCompare Compares one CFString object with another CFString object.
CFStringCompareWithOptions Compares a range of the characters in one CFString object with that of another CFString object.
CFStringConvertEncodingToIANACharSetName Obtains the name of the IANA registry "charset" that is the closest mapping to a specified string encoding.
CFStringConvertEncodingToNSStringEncoding Obtains the Cocoa (Yellow Box) encoding constant that maps most closely to a given Core Foundation encoding constant.
CFStringConvertEncodingToWindowsCodepage Obtains the Windows codepage identifier that maps most closely to a given Core Foundation encoding constant.
CFStringConvertIANACharSetNameToEncoding Obtains the Core Foundation encoding constant that is the closest mapping to a given IANA registry "charset" name.
CFStringConvertNSStringEncodingToEncoding Obtains the Core Foundation encoding constant that is the closest mapping to a given Cocoa (Yellow Box) encoding.
CFStringConvertWindowsCodepageToEncoding Obtains the Core Foundation encoding constant that is the closest mapping to a given Windows codepage identifier.
CFStringCreateArrayBySeparatingStrings Creates an array of CFString objects from a single CFString object.
CFStringCreateArrayWithFindResults Searches a CFString object for multiple occurrences of a substring and creates an array of ranges identifying the locations of these substrings within the target string.
CFStringCreateByCombiningStrings Creates a single CFString object from the individual CFString objects that comprise the elements of a CFArray object.
CFStringCreateCopy Creates a copy of a CFString object.
CFStringCreateExternalRepresentation Creates an "external representation" of a CFString object, that is, a CFData object.
CFStringCreateFromExternalRepresentation Creates a CFString object from its "external representation."
CFStringCreateMutable Creates an empty mutable CFString object.
CFStringCreateMutableCopy Creates a copy of a CFString object that can be modified.
CFStringCreateMutableWithExternalCharactersNoCopy Creates a mutable CFString object whose Unicode character buffer is controlled externally.
CFStringCreateWithBytes Creates a CFString object from a buffer containing characters in a specified encoding.
CFStringCreateWithCharacters Creates a CFString object from a buffer of Unicode characters.
CFStringCreateWithCharactersNoCopy Creates a CFString object from a buffer of Unicode characters that might serve as the backing store for the object.
CFStringCreateWithCString Creates an immutable CFString object from a C string.
CFStringCreateWithCStringNoCopy Creates a CFString object from an external C string buffer that might serve as the backing store for the object.
CFStringCreateWithFormat Creates an immutable CFString object from a formatted string and a variable number of arguments.
CFStringCreateWithFormatAndArguments Creates an immutable CFString object from a formatted string and a variable number of arguments (specified in a parameter of type va_list).
CFStringCreateWithPascalString Creates an immutable CFString object from a Pascal string.
CFStringCreateWithPascalStringNoCopy Creates a CFString object from an external Pascal string buffer that might serve as the backing store for the object.
CFStringCreateWithSubstring Creates an immutable CFString object from a segment (substring) of an existing CFString object.
CFStringDelete Deletes a range of characters in a mutable CFString object.
CFStringFind Searches for a substring within a CFString object and, if it is found, yields the range of the substring within the object's characters.
CFStringFindWithOptions Searches for a substring within a range of the characters represented by a CFString object and, if the substring is found, returns its range within the object's characters.
CFStringGetBytes Fetches a range of the characters represented by a CFString object into a byte buffer after converting the characters to a specified encoding. This function enables lossy conversion and handles any external represenation of the characters.
CFStringGetCharacterAtIndex Obtains the Unicode character at a specified location in a CFString object.
CFStringGetCharacterFromInlineBuffer Obtains the Unicode character at a specific location in an in-line buffer.
CFStringGetCharacters Copies a range of the Unicode characters represented by a CFString object to a a user-provided buffer.
CFStringGetCharactersPtr Quickly obtains a pointer to the contents of a CFString object as a buffer of Unicode characters.
CFStringGetCString Copies the character contents of a CFString object to a local C string buffer after converting the characters to a given encoding.
CFStringGetCStringPtr Quickly obtains a pointer to a C-string buffer containing the characters of a CFString object in a given encoding.
CFStringGetDoubleValue Obtains the primary double value represented by a CFString object.
CFStringGetFastestEncoding Obtains the encoding for the characters in a CFString that requires the least conversion time.
CFStringGetIntValue Obtains the integer value represented by a CFString object.
CFStringGetLength Obtains the number of Unicode characters in a CFString object.
CFStringGetLineBounds Given a range of characters in a CFString object, obtains the line bounds, that is, the indexes of the first character and the final characters of the lines containing the range.
CFStringGetListOfAvailableEncodings Obtains a pointer to a list of string encodings supported by the current system.
CFStringGetMaximumSizeForEncoding Obtains the maximum number of bytes a string of a specified length (in Unicode characters) will take up if encoded in a specified encoding. The number of bytes that the encoding ends up requiring could be less.
CFStringGetNameOfEncoding Obtains the localized name of a specified string encoding.
CFStringGetPascalString Copies the character contents of a CFString object to a local Pascal string buffer after converting the characters to a requested encoding.
CFStringGetPascalStringPtr Quickly obtains a pointer to a Pascal buffer containing the characters of a CFString object in a given encoding.
CFStringGetSmallestEncoding Obtains the smallest encoding on the current system for the character contents of a CFString object.
CFStringGetSystemEncoding Obtains the default encoding used by the operating system when it creates strings.
CFStringGetTypeID Obtains the type ID for the CFString opaque type.
CFStringHasPrefix Determines if the character data of a CFString object begin with a specified sequence of characters.
CFStringHasSuffix Determines if the character data of a CFString object end with a specified sequence of characters.
CFStringInitInlineBuffer Initializes an in-line buffer to use for efficient access of a CFString's characters.
CFStringInsert Inserts a string at a specified location in the character buffer of a mutable CFString object.
CFStringIsEncodingAvailable Determines whether a given Core Foundation string encoding is available on the current system.
CFStringLowercase Changes all uppercase alphabetical characters in a mutable CFString to lowercase.
CFStringPad Enlarges the string represented by a CFString object, padding it with specified characters, or truncates the string.
CFStringReplace Replaces part of the character contents of a mutable CFString object with another string.
CFStringReplaceAll Replaces all characters of a mutable CFString object with other characters.
CFStringSetExternalCharactersNoCopy Notifies a mutable CFString object that its external backing store of Unicode characters has changed.
CFStringTrim Trims a specified substring from the beginning and end of the character contents represented by a mutable CFString object.
CFStringTrimWhitespace Trims whitespace from the beginning and end of the characters represented by a mutable CFString object.
CFStringUppercase Changes all lowercase alphabetical characters in a mutable CFString object to uppercase.

© 1999 Apple Computer, Inc. — (Last Updated 9/15/99)