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

getLineStart(_:end:contentsEnd:for:)

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

Declaration 宣言 

func getLineStart(_ startPtr: UnsafeMutablePointer<Int>?, 
              end lineEndPtr: UnsafeMutablePointer<Int>?, 
      contentsEnd contentsEndPtr: UnsafeMutablePointer<Int>?, 
              for range: NSRange)

Parameters パラメータ

startIndex

Upon return, contains the index of the first character of the line 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を渡してください、もしあなたがこの値を必要としないならば（その場合には値を算定する仕事は実行されません）。

lineEndIndex

Upon return, contains the index of the first character past the terminator of the line 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 line 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. レシーバ内のある範囲。値は、レシーバの境界を越えてはいけません。

Raises an NSRangeException if aRange is invalid. NSRangeExceptionを引き起こします、もしaRangeが無効ならば。

Discussion 議論

A line is delimited by any of these characters, the longest possible sequence being preferred to any shorter: 行は、これらの文字のどれかによって区切られます、最も長い可能なシーケンスがいくらかでもより短いものより選ばれます：

  • U+000A Unicode Character 'LINE FEED (LF)' (\n) U+000A ユニコード文字 'LINE FEED (LF)' (\n)

  • U+000D Unicode Character 'CARRIAGE RETURN (CR)' (\r) U+000D ユニコード文字 'CARRIAGE RETURN (CR)' (\r)

  • U+0085 Unicode Character 'NEXT LINE (NEL)' U+0085 ユニコード文字 'NEXT LINE (NEL)'

  • U+2028 Unicode Character 'LINE SEPARATOR' U+2028 ユニコード文字 'LINE SEPARATOR'

  • U+2029 Unicode Character 'PARAGRAPH SEPARATOR' U+2029 ユニコード文字 'PARAGRAPH SEPARATOR'

  • \r\n, in that order (also known as CRLF) \r\n、その順番で（またCRLFとして知られます）

If aRange is contained with a single line, of course, the returned indexes all belong to that line. You can use the results of this method to construct ranges for lines by using the start index as the range’s location and the difference between the end index and the start index as the range’s length. aRangeが単一の行で含まれるならば、もちろん、返されるインデックスはその行に属します。あなたは、このメソッドを使って行いくらかに対する範囲を構築することが、開始インデックスをその範囲の持つ位置としてそして終わりインデックスと開始インデックスの間の差を範囲の持つ長さとして使うことで可能です。

Special Considerations 特別な注意事項

This method detects all invalid ranges (including those with negative lengths). For applications linked against macOS 10.6 and later, this error causes an exception; for applications linked against earlier releases, this error causes a warning, which is displayed just once per application execution. このメソッドは、すべての無効な範囲を検知します（負の長さでのそれらを含めて）。macOS 10.6以降に対して結び付けられるアプリケーションに対して、このエラーは例外をもたらします；以前のリリースに関連するアプリケーションに対して、このエラーは警告をもたらします、それはアプリケーション例外ごとに一度だけ表示されます。

See Also 参照

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

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

Related Documentation 関連文書

func substring(with: NSRange) -> String
Returns a string object containing the characters of the receiver that lie within a given range. 与えられた範囲内に置かれている、レシーバの文字を含んでいる文字列オブジェクトを返します。