Initializer

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

Declaration 宣言

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

Parameters パラメータ

characters

A C array of UTF-16 code units. UTF-16コード単位からなるC配列。

length

The number of characters to use from characters. charactersから使う文字の数。

flag

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 that contains length characters from characters. The returned object may be different from the original receiver. ある初期化されたNSStringオブジェクト、length文字をcharactersから含みます。返されるオブジェクトは、元のレシーバと異なるかもしれません。

Discussion 議論

If an error occurs during the creation of the string, then bytes is not 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は自由にされません、たとえflagtrueであるとしてもです。この場合には、呼出し側はバッファを自由にすることに対して責任があります。これは呼出し側に、文字列をバッファを使って作成する試みを継続させます、バッファをデアロケートしてしまうことなく。

See Also 参照

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

Related Documentation 関連文書