Instance Method
インスタンスメソッド
initWithCString:encoding:
Returns an NSString
object initialized using the characters in a given C array, interpreted according to a given encoding.
NSString
オブジェクトを返します、与えられたC配列の中の文字を使って初期化されます、与えられた符号化によって解釈されます。
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.
いくらかの文字からなるC配列。配列は、NULL
文字で終わらなければなりません;中間にあるNULL
文字は許可されません。
encoding
The encoding of nullTerminatedCString
. For possible values, see NSStringEncoding
.
nullTerminatedCString
の符号化。可能な値として、NSStringEncoding
を見てください。
Return Value
戻り値
An NSString
object initialized using the characters from nullTerminatedCString
. The returned object may be different from the original receiver
あるNSString
オブジェクト、初期化をnullTerminatedCString
からの文字を使ってされます。返されるオブジェクトは、元のレシーバとは異なるかもしれません。
Discussion
議論
If nullTerminatedCString
is not a NULL
-terminated C string, or encoding
does not match the actual character encoding, the results are undefined.
nullTerminatedCString
が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
オブジェクトを返します、別の与えられた文字列から文字をコピーすることによって初期化されます。
- 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.
与えられた書式設定文字列を、それへと残りの引数値が現在のロケールに従って置き換えられるテンプレートとして使うことで作成される文字列を返します。
+ 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.
別の与えられた文字列から文字をコピーすることによって作成される文字列を返します。
+ stringWithCString:encoding:
Returns a string containing the bytes in a given C array, interpreted according to a given encoding.
与えられたCはい列の中のバイトを含んでいる文字列を返します、与えられた符号化に従って解釈されます。
+ 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コード単位に対する型。
Related Documentation
関連文書
- initWithCStringNoCopy:length:freeWhenDone:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
defaultCStringEncoding
Returns the C-string encoding assumed for any method accepting a C string as an argument.
C文字列を引数として受け入れる何らかのメソッドのために仮定されるC文字列符号化を返します。