CFSTRHeader: CFString.h

Creates an immutable CFString object from a constant compile-time string.

CFStringRef CFSTR (
    const char *cStr
);
cStr

Pass a C string (that is, text enclosed in double-quotation marks) from which the CFString object is to be created. The characters enclosed by the quotation marks must be ASCII characters or the behavior is undefined.

function result

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

DISCUSSION

The CFSTR macro is a convenience for creating CFString objects from constant compile-time strings. These strings are uniqued; if there are two or more exact instances of a constant string in an executable, only one is stored. You should not release objects created with this macro.


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