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

getCharacters:range:

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

Declaration 宣言 

- (void)getCharacters:(unichar *)buffer 
                range:(NSRange)range;

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は、範囲aRange（aRange.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 characterAtIndex: repeatedly, correctly extracting the characters, though very inefficiently. Subclasses should override it to provide a fast implementation. このメソッドの抽象的な実装は、characterAtIndex:を繰り返し使って、文字を正しく抽出しています、大変に非効率であるけれども。サブクラスは、それをオーバーライドして高速な列挙を提供すべきです。

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

See Also 参照

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

- characterAtIndex:
Returns the character at a given UTF-16 code unit index. 与えられたUTFー16コード単位インデックスでの文字を返します。
- getBytes:maxLength:usedLength:encoding:options:range:remainingRange:
Gets a given range of characters as bytes in a specified encoding. 与えられた範囲の文字をバイトとしてある指定された符号化で取得します。