CFStringCreateWithSubstring

Header: CFString.h Carbon status: Supported

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

CFStringRef CFStringCreateWithSubstring (
    CFAllocatorRef alloc, 
    CFStringRef str, 
    CFRange range
);
Parameter descriptions
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.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)