Initializer

init(cString:encoding:)

Returns an NSString object initialized using the characters in a given C array, interpreted according to a given encoding. NSStringオブジェクトを返します、与えられたC配列の中の文字を使って初期化されます、与えられた符号化によって解釈されます。

Declaration 宣言

convenience init?(cString nullTerminatedCString: UnsafePointer<CChar>, 
         encoding: UInt)

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 文字列の作成と初期化

init()

Returns an initialized NSString object that contains no characters. 初期化されたNSStringオブジェクトを返します、それは文字を含みません。

init?(bytes: UnsafeRawPointer, length: Int, encoding: UInt)

Returns an initialized NSString object containing a given number of bytes from a given buffer of bytes interpreted in a given encoding. 初期化されたNSStringオブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトの、ある与えられたバッファから含みます。

init?(bytesNoCopy: UnsafeMutableRawPointer, length: Int, encoding: UInt, freeWhenDone: Bool)

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オブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトのある与えられたバッファから含みます、そして任意にバッファを解放します。

init(characters: UnsafePointer<unichar>, length: Int)

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配列から含んでいます。

init(charactersNoCopy: UnsafeMutablePointer<unichar>, length: Int, freeWhenDone: Bool)

init(string: String)

Returns an NSString object initialized by copying the characters from another given string. NSStringオブジェクトを返します、別の与えられた文字列から文字をコピーすることによって初期化されます。

init?(utf8String: UnsafePointer<CChar>)

Returns an NSString object initialized by copying the characters from a given C array of UTF8-encoded bytes. NSStringオブジェクトを返します、UTF8符号化されたバイトからなる与えられたC配列から文字をコピーすることによって初期化されます。

init(format: String, arguments: CVaListPointer)

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オブジェクトを返します、与えられた書式設定文字列をテンプレートとして使って、それへと残りの引数値が何らローカライズなしに置き換えられることによって初期化されます。

init(format: String, locale: Any?, arguments: CVaListPointer)

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オブジェクトを返します、与えられた書式設定文字列を、それへと残りの引数値が指定ロケール情報に従って置き換えられるあるテンプレートとして使うことによって初期化されます。このメソッドは、可変長引数関数内から呼び出されるためのものです、そこでは引数リストが利用可能です。

init?(data: Data, encoding: UInt)

Returns an NSString object initialized by converting given data into UTF-16 code units using a given encoding. NSStringオブジェクトを返します、与えられたデータをUTFー16コード単位へとある与えられた符号化を使って変換することによって初期化されます。

class func localizedUserNotificationString(forKey: String, arguments: [Any]?) -> String

Returns a localized string intended for display in a notification alert. ローカライズされた文字列を返します、通知アラートにおいて表示されるのを意図されます。

class func localizedStringWithFormat(NSString, CVarArg...) -> Self

typealias unichar

Type for UTF-16 code units. UTF-16コード単位に対する型。