withCStringNoCopy
Returns an OSSymbol created from a C string, without copying that string, or the existing unique instance of the same value.
Declaration
static const OSSymbol * withCStringNoCopy(
const char *cString);Parameters
- cString:
The C string to look up or use.
Return Value
An instance of OSSymbol representing the same characters as cString; NULL.
Overview
Avoid using this function; OSSymbols should own their internal string buffers.
This function returns the unique OSSymbol instance representing the string value of cString. You can compare it with other OSSymbols using the == operator.
OSSymbols are reference-counted normally. This function either returns a new OSSymbol with a retain count of 1, or increments the retain count of the existing instance.