NSString класс

Определение диапазонов строк и абзацев

Методы:

getLineStart:end:contentsEnd:forRange:
lineRangeForRange:
getParagraphStart:end:contentsEnd:forRange:
paragraphRangeForRange:

 

getLineStart:end:contentsEnd:forRange:

Возвращает по ссылке начало первой строки и конец последней строки затронутые в заданном диапазоне.

- (void)getLineStart:(NSUInteger *)startIndex end:(NSUInteger *)lineEndIndex contentsEnd:(NSUInteger *)contentsEndIndex forRange:(NSRange)aRange

Аргументы:

startIndexпо возвращении содержит индекс первого символа строки, начинающейся с aRange. Укажите NULL, если вам не нужно это значение (в этом случае расчет значения не производится).
lineEndIndexпо возвращении содержит индекс первого символа, следующего за ограничителем строки, содержащейся на конце aRange. Укажите NULL, если вам не нужно это значение (в этом случае расчет значения не производится).
contentsEndIndexпо возвращении содержит индекс первого символа ограничителя строки, содержащемся на конце aRange. Укажите NULL, если вам не нужно это значение (в этом случае расчет значения не производится).
aRangeдиапазон, в объекте-приемнике. Значение не должно превышать пределы объекта-приемника.

Важно: Возбуждает NSRangeException если любая часть aRange лежит за пределами строки.

Рассмотрение:

Предложения отделены любым из этих символов, самая длинная последовательность является предпочтительной перед любой короткой:
  • U+000D (\r или CR)
  • U+2028 (Unicode конец строки)
  • U+000A (\n или LF)
  • U+2029 (Unicode сепаратор абзаца)
  • \r\n, именно в таком порядке (также известно как CRLF)

Если aRange содержится, с одном предложении, то, все возвращенные индексы принадлежат к этому предложению. Вы можете использовать результаты этого метода для построения диапазонов для предложений с помощью начального индекса, как местоположение и разницу между индексом конца и начала, как индекс длины диапазона.

Этот метод обнаруживает все недопустимые диапазоны (в том числе и с отрицательной длинной). Для приложений, скомпилированных под Mac OS X 10.6 и выше, эта ошибка вызывает исключение; для приложений скомпилированных под более раннии версии, эта ошибка вызывает предупреждение, которое отображается только один раз во время выполнения приложения.

Доступно:

OS X 10.0 и выше, iOS 2.0 и выше

Задекларирован:

NSString.h

lineRangeForRange:

Возвращает диапазон символов, представляющих строки или содержащие строки в заданном диапазоне.

- (NSRange)lineRangeForRange:(NSRange)aRange

Аргументы:

aRangeдиапазон, в объекте-приемнике.

Возвращаемое значение:

Диапазон символов, представляющих строки или содержащие строки в заданном aRange, в том числе символы завершения строки.

Доступно:

OS X 10.0 и выше, iOS 2.0 и выше

Задекларирован:

NSString.h

getParagraphStart:end:contentsEnd:forRange:

Возвращает по ссылке начало первого абзаца и конц последнего абзаца затронутых в заданном диапазоне.

- (void)getParagraphStart:(NSUInteger *)startIndex end:(NSUInteger *)endIndex contentsEnd:(NSUInteger *)contentsEndIndex forRange:(NSRange)aRange

Аргументы:

startIndexпо возвращении содержит индекс первого символа абзаца, содержащего начало aRange. Укажите NULL, если вам не нужно это значение (в этом случае расчет значения не производится).
endIndexпо возвращении содержит индекс первого символа, следующего за ограничителем абзаца, лежащего в конеце aRange. Укажите NULL, если вам не нужно это значение (в этом случае расчет значения не производится).
contentsEndIndexпо возвращении содержит индекс первого символа ограничителя абзаца, лежащего в конеце aRange. Укажите NULL, если вам не нужно это значение (в этом случае расчет значения не производится).
aRangeдиапазон, в объекте-приемнике. Значение не должно превышать пределы объекта-приемника.

Рассмотрение:

Если aRange содержится в одном абзаце, то все возвращеные индексы принадлежат к этому абзацу. Как и в getLineStart:end:contentsEnd:forRange:, вы можете использовать результаты этого метода для построения диапазонов абзацев.

Доступно:

OS X 10.3 и выше, iOS 2.0 и выше

Задекларирован:

NSString.h

paragraphRangeForRange:

Возвращает диапазон символов, представляющих абзац или абзацы в заданном диапазоне.

- (NSRange)paragraphRangeForRange:(NSRange)aRange

Аргументы:

aRangeдиапазон, в объекте-приемнике. Диапазон не должен превышать пределы объекта-приемника.

Возвращаемое значение:

Диапазон символов, представляющих абзац или абзацы в заданном aRange, в том числе символы завершения строки.

Доступно:

OS X 10.3 и выше, iOS 2.0 и выше

Задекларирован:

NSString.h
 
 
homeЗаметили ошибкукарта сайта 
   Made on a Mac