Instance Method インスタンスメソッド

getCharacters(_:range:)

Copies characters from a given range in the receiver into a given buffer. レシーバの中の与えられた範囲からある与えられたバッファに文字をコピーします。

Declaration 宣言

func getCharacters(_ buffer: UnsafeMutablePointer<unichar>, 
             range: NSRange)

Parameters パラメータ

buffer

Upon return, contains the characters from the receiver. buffer must be large enough to contain the characters in the range aRange (aRange.length*sizeof(unichar)). 戻りでは、レシーバからの文字を含みます。bufferは、範囲aRangeaRange.length*sizeof(unichar))での文字を含むのに十分に大きくなければいけません。

aRange

The range of characters to retrieve. The range must not exceed the bounds of the receiver. とってくる文字の範囲。範囲は、レシーバの境界を越えてはいけません。

Discussion 議論

This method does not add a NULL character. このメソッドは、NULL文字を加えません。

The abstract implementation of this method uses character(at:) repeatedly, correctly extracting the characters, though very inefficiently. Subclasses should override it to provide a fast implementation. このメソッドの抽象的な実装は、character(at:)を繰り返し使って、文字を正しく抽出しています、大変に非効率であるけれども。サブクラスは、それをオーバーライドして高速な列挙を提供すべきです。

You should always use the rangeOfComposedCharacterSequence(at:) or rangeOfComposedCharacterSequences(for:) method to determine character boundaries, so that any surrogate pairs or character clusters are handled correctly. あなたは、常にrangeOfComposedCharacterSequence(at:)またはrangeOfComposedCharacterSequences(for:)メソッドを使って文字境界を決定すべきです、それで何らかのサロゲートペアまたは文字クラスタは正しく取り扱われます。

See Also 参照

Getting Characters and Bytes 文字とバイトを取得する