Initializer

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

Declaration 宣言

convenience init?(bytesNoCopy bytes: UnsafeMutableRawPointer, 
           length len: Int, 
         encoding: UInt, 
     freeWhenDone freeBuffer: Bool)

Parameters パラメータ

bytes: A buffer of bytes interpreted in the encoding specified by encoding. encodingによって指定される符号化において解釈されるバイトのバッファ。
len: The number of bytes to use from bytes. bytesから使用するバイト数。
encoding: The character encoding of bytes. For possible values, see NSStringEncoding. bytesの文字符号化。可能な値として、NSStringEncodingを見てください。
freeBuffer: If true, the receiver releases the memory with free() when it no longer needs the data; if false it won’t. trueならば、レシーバはメモリをfree()を使って解放します、それがもはやデータを必要としない時に；falseならばそれはそうしません。

Return Value 戻り値

An initialized NSString object containing length bytes from bytes interpreted using the encoding encoding. The returned object may be different from the original receiver. 初期化されたNSStringオブジェクト、符号化encodingを使って解釈されるbytesからlengthバイトを含んでいます。返されるオブジェクトは、元のレシーバと異なるかもしれません。

Discussion 議論

If an error occurs during the creation of the string, then bytes isn’t freed even if flag is true. In this case, the caller is responsible for freeing the buffer. This allows the caller to continue trying to create a string with the buffer, without having the buffer deallocated. エラーが文字列の作成の間に起こったならば、そのときbytesは自由にされません、たとえflagがtrueであるとしてもです。この場合には、呼出し側はバッファを自由にすることに対して責任があります。これは呼出し側に、文字列をバッファを使って作成する試みを継続させます、バッファをデアロケートしてしまうことなく。

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(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?(cString: UnsafePointer<CChar>, encoding: UInt)

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

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コード単位に対する型。