CFStringCreateWithSubstringHeader: CFString.h

Creates an immutable CFString object from a segment (substring) of an existing CFString object.

CFStringRef CFStringCreateWithSubstring (
    CFAllocatorRef alloc, 
    CFStringRef str, 
    CFRange range
);
alloc

Pass a reference to an allocator to be used to create the CFString object or pass NULL to request the default allocator.

str

Pass a reference to the CFString object containing the substring that will be used in creating the new CFString object.

range

Pass a structure of type CFRange that specifies the starting location and length of the substring in str.

function result

A reference to an immutable CFString object or NULL if there was a problem creating the object.


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