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

getParagraphStart:end:contentsEnd:forRange:

Returns by reference the beginning of the first paragraph and the end of the last paragraph touched by the given range. 与えられた範囲による最初の段落の始まりと到達される最後の段落の終わりを参照渡しによって返します。

Declaration 宣言 

- (void)getParagraphStart:(NSUInteger *)startPtr 
                      end:(NSUInteger *)parEndPtr 
              contentsEnd:(NSUInteger *)contentsEndPtr 
                 forRange:(NSRange)range;

Parameters パラメータ

startIndex

Upon return, contains the index of the first character of the paragraph containing the beginning of aRange. Pass NULL if you do not need this value (in which case the work to compute the value isn’t performed). 戻りでは、aRangeの始まりを含んでいる段落の最初の文字のインデックスを含みます。NULLを渡してください、もしあなたがこの値を必要としないならば（その場合には値を算定する仕事は実行されません）。

endIndex

Upon return, contains the index of the first character past the terminator of the paragraph containing the end of aRange. Pass NULL if you do not need this value (in which case the work to compute the value isn’t performed). 戻りでは、aRangeの終わりを含んでいる段落の終端子をすぎた最初の文字のインデックスを含みます。NULLを渡してください、もしあなたがこの値を必要としないならば（その場合には値を算定する仕事は実行されません）。

contentsEndIndex

Upon return, contains the index of the first character of the terminator of the paragraph containing the end of aRange. Pass NULL if you do not need this value (in which case the work to compute the value isn’t performed). 戻りでは、aRangeの終わりを含んでいる段落の終端子の最初の文字のインデックスを含みます。NULLを渡してください、もしあなたがこの値を必要としないならば（その場合には値を算定する仕事は実行されません）。

aRange

A range within the receiver. The value must not exceed the bounds of the receiver. レシーバ内のある範囲。値は、レシーバの境界を越えてはいけません。

Discussion 議論

A paragraph is any segment of text delimited by a carriage return (U+000D), newline (U+000A), or paragraph separator (U+2029). 段落は、キャリッジリターン（U+000D）、または改行（U+000A）または段落分離子（U+2029）によって境界を定められるテキストのいくらかの分節です。

If aRange is contained with a single paragraph, of course, the returned indexes all belong to that paragraph. Similar to getLineStart:end:contentsEnd:forRange:, you can use the results of this method to construct the ranges for paragraphs. aRangeが単一の段落に含まれるならば、もちろん、返されるインデックスは全てその段落に属します。getLineStart:end:contentsEnd:forRange:と同様に、あなたはこのメソッドの結果を使って段落いくらかに対する範囲を組み立てることができます。

See Also 参照

Determining Line and Paragraph Ranges 行と段落範囲を特定する

- getLineStart:end:contentsEnd:forRange:
Returns by reference the beginning of the first line and the end of the last line touched by the given range. 与えられた範囲による最初の行の始まりと到達される最後の行の終わりを参照渡しによって返します。
- lineRangeForRange:
Returns the range of characters representing the line or lines containing a given range. 与えられた範囲を含んでいる行または複数行を表している文字の範囲を返します。
- paragraphRangeForRange:
Returns the range of characters representing the paragraph or paragraphs containing a given range. 与えられた範囲を含んでいる段落または複数段落を表している文字の範囲を返します。