Instance Method

initWithCString:encoding:

Returns an NSString object initialized using the characters in a given C array, interpreted according to a given encoding.

Declaration

- (instancetype)initWithCString:(const char *)nullTerminatedCString encoding:(NSStringEncoding)encoding;

Parameters

nullTerminatedCString

A C array of characters. The array must end with a NULL character; intermediate NULL characters are not allowed.

encoding

The encoding of nullTerminatedCString. For possible values, see NSStringEncoding.

Return Value

An NSString object initialized using the characters from nullTerminatedCString. The returned object may be different from the original receiver

Discussion

If nullTerminatedCString is not a NULL-terminated C string, or encoding does not match the actual character encoding, the results are undefined.

Special Considerations

Only 8-bit encodings are supported, as encodings that have a greater width, such as UTF-16, may include a NULL byte in a single unit, which would result in the premature termination of the C string.

See Also

Creating and Initializing Strings

+ string

Returns an empty string.

- init

Returns an initialized NSString object that contains no characters.

- initWithBytes:length:encoding:

Returns an initialized NSString object containing a given number of bytes from a given buffer of bytes interpreted in a given encoding.

- initWithBytesNoCopy:length:encoding:freeWhenDone:

Returns an initialized NSString object that contains a given number of bytes from a given buffer of bytes interpreted in a given encoding, and optionally frees the buffer.

- initWithCharacters:length:

Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units.

- initWithCharactersNoCopy:length:freeWhenDone:

Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units.

- initWithString:

Returns an NSString object initialized by copying the characters from another given string.

- initWithUTF8String:

Returns an NSString object initialized by copying the characters from a given C array of UTF8-encoded bytes.

- initWithFormat:

Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted.

- initWithFormat:arguments:

Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted without any localization.

- initWithFormat:locale:

Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted according to given locale.

- initWithFormat:locale:arguments:

Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted according to given locale information. This method is meant to be called from within a variadic function, where the argument list will be available.

- initWithData:encoding:

Returns an NSString object initialized by converting given data into UTF-16 code units using a given encoding.

+ stringWithFormat:

Returns a string created by using a given format string as a template into which the remaining argument values are substituted.

+ localizedStringWithFormat:

Returns a string created by using a given format string as a template into which the remaining argument values are substituted according to the current locale.

+ localizedUserNotificationStringForKey:arguments:

Returns a localized string intended for display in a notification alert.

+ stringWithCharacters:length:

Returns a string containing a given number of characters taken from a given C array of UTF-16 code units.

+ stringWithString:

Returns a string created by copying the characters from another given string.

+ stringWithCString:encoding:

Returns a string containing the bytes in a given C array, interpreted according to a given encoding.

+ stringWithUTF8String:

Returns a string created by copying the data from a given C array of UTF8-encoded bytes.

unichar

Type for UTF-16 code units.