Type Method 型メソッド

stringWithCString:encoding:

Returns a string containing the bytes in a given C array, interpreted according to a given encoding. 与えられたCはい列の中のバイトを含んでいる文字列を返します、与えられた符号化に従って解釈されます。

Declaration 宣言 

+ (instancetype)stringWithCString:(const char *)cString 
                         encoding:(NSStringEncoding)enc;

Parameters パラメータ

cString

A C array of bytes. The array must end with a NULL byte; intermediate NULL bytes are not allowed. バイトからなるC配列。配列は、NULLバイトで終わらなければなりません；中間にあるNULLバイトは許可されません。

enc

The encoding of cString. For possible values, see NSStringEncoding. cStringの符号化。可能な値として、NSStringEncodingを見てください。

Return Value 戻り値

A string containing the characters described in cString. cStringにおいて記述される文字を含んでいる文字列。

Discussion 議論

If cString is not a NULL-terminated C string, or encoding does not match the actual encoding, the results are undefined. cStringがNULL終端のC文字列でないならば、またはencodingが実際の符号化と合致しないならば、結果は未定義です。

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. 8-bit符号化だけがサポートされます、より大きな幅を持つような符号化、例えばUTF-16などは、NULLバイトを単一の単位に含むかもしれません、それはC文字列の早まった終端という結果になるでしょう。

See Also 参照

Creating and Initializing Strings 文字列の作成と初期化

+ string
Returns an empty string. 空の文字列を返します。
- init
Returns an initialized NSString object that contains no characters. 初期化されたNSStringオブジェクトを返します、それは文字を含みません。
- 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. 初期化されたNSStringオブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトの、ある与えられたバッファから含みます。
- 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. 初期化されたNSStringオブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトのある与えられたバッファから含みます、そして任意にバッファを解放します。
- initWithCharacters:length:
Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units. 初期化されたNSStringオブジェクトを返します、それは与えられた数の文字を、UTF-16コード単位からなる与えられたC配列から含んでいます。
- 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. 初期化されたNSStringオブジェクトを返します、それは与えられた数の文字を、UTF-16コード単位からなる与えられたC配列から含んでいます。
- initWithString:
Returns an NSString object initialized by copying the characters from another given string. NSStringオブジェクトを返します、別の与えられた文字列から文字をコピーすることによって初期化されます。
- initWithCString:encoding:
Returns an NSString object initialized using the characters in a given C array, interpreted according to a given encoding. NSStringオブジェクトを返します、与えられたC配列の中の文字を使って初期化されます、与えられた符号化によって解釈されます。
- initWithUTF8String:
Returns an NSString object initialized by copying the characters from a given C array of UTF8-encoded bytes. NSStringオブジェクトを返します、UTF8符号化されたバイトからなる与えられたC配列から文字をコピーすることによって初期化されます。
- initWithFormat:
Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted. 与えられた書式設定文字列を、それへと残りの引数値が置き換えられるテンプレートとして使うことによって初期化されるNSStringオブジェクトを返します。
- 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. あるNSStringオブジェクトを返します、与えられた書式設定文字列をテンプレートとして使って、それへと残りの引数値が何らローカライズなしに置き換えられることによって初期化されます。
- 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. NSStringオブジェクトを返します、与えられた書式設定文字列を、それへと残りの引数値がある与えられたロケールに従って置き換えられるテンプレートとして使うことによって初期化されます。
- 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. NSStringオブジェクトを返します、与えられた書式設定文字列を、それへと残りの引数値が指定ロケール情報に従って置き換えられるあるテンプレートとして使うことによって初期化されます。このメソッドは、可変長引数関数内から呼び出されるためのものです、そこでは引数リストが利用可能です。
- initWithData:encoding:
Returns an NSString object initialized by converting given data into UTF-16 code units using a given encoding. NSStringオブジェクトを返します、与えられたデータをUTFー16コード単位へとある与えられた符号化を使って変換することによって初期化されます。
+ 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. UTF-16コード単位からなるある与えられたC配列から取られる与えられた数の文字を含んでいる文字列を返します。
+ stringWithString:
Returns a string created by copying the characters from another given string. 別の与えられた文字列から文字をコピーすることによって作成される文字列を返します。
+ stringWithUTF8String:
Returns a string created by copying the data from a given C array of UTF8-encoded bytes. UTF8符号化されたバイトからなるある与えられたC配列からデータをコピーすることによって作成される文字列を返します。
unichar
Type for UTF-16 code units. UTF-16コード単位に対する型。