NSString

Наследование

NSObject
NSString
NSMutableString
NSSimpleCString

NSObject
NSString
NSMutableString

Соответствует

AnyObject
CKRecordValue
CVarArgType
Сопоставимый
Hashable
NSCoding
NSCopying
NSMutableCopying
NSObjectProtocol
NSSecureCoding
Печатаемый
Reflectable
StringLiteralConvertible
NSCopying
NSMutableCopying
NSObject
NSSecureCoding

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

NSString класс объявляет программируемый интерфейс для объекта, управляющего неизменными строками. Неизменная строка является текстовой строкой, определяющейся, когда она создается и впоследствии не может быть изменена. NSString реализован для представления массива символов Unicode, другими словами, текстовой строки.

Непостоянный подкласс NSString NSMutableString.

NSString класс имеет два примитивных метода —length и characterAtIndex:— это обеспечивает основание для всех других методов в его интерфейсе. length метод возвращает общее количество символов Unicode в строке. characterAtIndex: предоставляет доступ к каждому символу в строке индексом, с индексными значениями, запускающимися в 0.

NSString объявляет методы для нахождения и сравнения строк. Это также объявляет методы для чтения числовых значений от строк для объединения строк в различных способах, и для преобразования строки к различным формам (таким как кодирование и изменения случая).

Набор Приложения также использует NSParagraphStyle и его подкласс NSMutableParagraphStyle инкапсулировать абзац или атрибуты линейки, используемые NSAttributedString классы. Кроме того, методы для поддержки строкового получения описаны в Дополнениях NSString, найденных в Наборе Приложения.

NSString “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFStringRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации о бесплатном образовании моста.

Строковые объекты

NSString объекты представляют символьные строки в платформах. Представление строк как объекты позволяет Вам использовать строки везде, где Вы используете другие объекты. Это также предоставляет преимущества инкапсуляции, так, чтобы строковые объекты могли использовать любое кодирование, и хранение необходимы для эффективности при простом появлении как массивы символов. Два общедоступных класса кластера, NSString и NSMutableString, объявите программируемый интерфейс для недоступных для редактирования и доступных для редактирования строк, соответственно.

Объекты Вы создаете использование NSString и NSMutableString упоминаются, поскольку строка возражает (или, когда никакой беспорядок не закончится, просто как строки). Термин струна до относится к стандарту char * ввести. Из-за природы кластеров класса строковые объекты не являются фактическими экземплярами NSString или NSMutableString классы, но одного из их частных подклассов. Несмотря на то, что строковый класс объекта является частным, его интерфейс общедоступен, как объявлено этими абстрактными суперклассами, NSString и NSMutableString. Строковые классы принимают NSCopying и NSMutableCopying протоколы, делая удобным преобразовать строку одного типа к другому.

Понимание символов

Строковый объект представляет себя как массив символов Unicode (Unicode является зарегистрированной торговой маркой Unicode, Inc.). Можно определить, сколько символов строковый объект содержит с length метод и может получить определенный символ с characterAtIndex: метод. Эти два «примитивных» метода обеспечивают основной доступ к строковому объекту.

Большая часть использования строк, однако, в более высоком уровне со строками, обрабатываемыми как единственные объекты: Вы сравниваете строки с друг другом, ищете их подстроки, комбинируете их в новые строки и т.д. Если необходимо получить доступ к строковому символу объектов символом, необходимо понять кодировку символов Unicode, в частности проблемы, связанные с составленными последовательностями символов. Для получения дополнительной информации посмотрите Стандарт Unicode, Версия 4.0 (Консорциум Unicode, Бостон: Аддисон-Уэсли, 2003, ISBN 0-321-18578-1) и Консорциальный веб-сайт Unicode: http://www .unicode.org/. См. также Символы и Кластеры Графемы в Строковом Руководстве по программированию.

Сравнения локализованной строки основываются на Алгоритме сопоставления Unicode, как адаптировано для различных языков CLDR (Общий Репозиторий данных Локали). Оба - проекты Консорциума Unicode.

Интерпретация UTF-16-encoded данные

При создании NSString объект от строки UTF-16-encoded (или поток байтов, интерпретируемый как UTF-16), если порядок байтов иначе не указан, NSString предполагает, что символы UTF-16 являются обратным порядком байтов, если нет BOM (метка порядка байтов), когда BOM диктует порядок байтов. При создании NSString объект от массива символов Unicode, возвращаемая строка всегда является собственным порядком байтов, так как массив всегда содержит символы Unicode в собственном порядке байтов.

Распределенные объекты

По распределенным соединениям объектов передаются непостоянные строковые объекты, и неизменные строковые объекты ссылкой передаются копией.

Разделение на подклассы примечаний

Возможно разделить на подклассы NSString (и NSMutableString), но выполнение так требует обеспечения складов для строки (который не наследован подклассами), и реализация двух примитивных методов. Краткий обзор NSString и NSMutableString классы являются открытым интерфейсом кластера класса, состоящего главным образом из частных, реальных классов, создающих и возвращающих строковый объект, подходящий для данной ситуации. Создание Вашего собственного конкретного подкласса этого кластера налагает определенные требования (обсужденный в Методах для Переопределения).

Удостоверьтесь свои причины разделения на подклассы NSString допустимы. Экземпляры Вашего подкласса должны представлять строку и не что-то еще. Таким образом единственные атрибуты, которые должен иметь подкласс, являются длиной символьного буфера, которым это управляет и доступ к отдельным символам в буфере. Допустимые причины того, чтобы сделать подкласс NSString включайте обеспечение различного запоминающего устройства (возможно, для лучшей производительности) или реализация некоторого аспекта поведения объекта по-другому, такого как управление памятью. Если Ваша цель состоит в том, чтобы добавить несущественные атрибуты или метаданные к Вашему подклассу NSString, лучшая альтернатива была бы объектным составом (см. Альтернативы Разделению на подклассы). Какао уже обеспечивает пример этого с NSAttributedString класс.

Методы для переопределения

Любой подкласс NSString должен переопределить примитивные методы экземпляра length и characterAtIndex:. Эти методы должны воздействовать на запоминающее устройство, что Вы предусматриваете символы строки. Для этого запоминающего устройства можно использовать статический массив, динамично выделенный буфер, стандарт NSString объект, или некоторый другой тип данных или механизм. Можно также принять решение переопределить, частично или полностью, любой другой NSString метод, для которого Вы хотите обеспечить альтернативную реализацию. Например, для лучшей производительности рекомендуется переопределить getCharacters:range: и дайте ему быстрое внедрение.

Вы могли бы хотеть реализовать инициализатор для своего подкласса, подходящего для запоминающего устройства, которым управляет подкласс. NSString класс не имеет определяемого инициализатора, таким образом, Ваш инициализатор должен только вызвать init метод super. NSString класс принимает NSCopying, NSMutableCopying, и NSCoding протоколы; если Вы хотите экземпляры своего собственного подкласса, создаваемого из копирования или кодирования, переопределяете методы в этих протоколах.

Альтернативы разделению на подклассы

Часто лучшая и более простая альтернатива созданию подкласса NSString— или любого другого краткого обзора, общедоступный класс кластера класса, в этом отношении — является объектным составом. Это в особенности имеет место, когда Ваше намерение состоит в том, чтобы добавить к метаданным подкласса или некоторому другому атрибуту, который не важен для строкового объекта. В объектном составе Вы имели бы NSString возразите как одна переменная экземпляра Вашего пользовательского класса (обычно подкласс NSObject) и одна или более переменных экземпляра, хранящих метаданные, которые Вы хотите для пользовательского объекта. Тогда просто разработайте свой интерфейс подкласса для включения методов доступа для объекта встроенной строки и метаданных.

Если поведение Вы могли бы записать категорию на, Вы хотите добавить дополнения тот из существующего класса NSString. Следует иметь в виду, однако, что эта категория будет иметь силу для всех экземпляров NSString то, что Вы используете, и это могло бы иметь непреднамеренные последствия.

Создание и инициализация строк

+ строка

Возвращает пустую строку.

Объявление

Objective C

+ (instancetype)string

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

Пустая строка.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– init
init () - init Определяемый инициализатор

Возвращает инициализированный NSString объект, не содержащий символов.

Объявление

Swift

init()

Objective C

- (instancetype)init

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

Инициализированный NSString объект, не содержащий символов. Возвращенный объект может отличаться от исходного получателя.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ строка


    
    init (bytes:length:encoding:)
    - initWithBytes:length:encoding:

Возвращает инициализированный NSString объект, содержащий данное число байтов от данного буфера байтов, интерпретируется в данном кодировании.

Объявление

Swift

convenience init?(bytes bytes: UnsafePointer<Void>, length length: Int, encoding encoding: UInt)

Objective C

- (instancetype)initWithBytes:(const void *)bytes length:(NSUInteger)length encoding:(NSStringEncoding)encoding

Параметры

`bytes`	Буфер байтов, интерпретируемых в кодировании, указанном `encoding`.
`length`	Число байтов для использования от `bytes`.
`encoding`	Кодировка символов применилась к `bytes`.

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

Инициализированный NSString объектный содержащий length байты от bytes интерпретируемое использование кодирования encoding. Возвращенный объект может отличаться от исходного получателя.

Строкам байтов возврата позволяют быть незавершенными.

Если длина строки байтов больше, чем указанная длина a nil значение возвращается.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithBytesNoCopy:length:encoding:freeWhenDone:


    
    init (bytesNoCopy:length:encoding:freeWhenDone:)
    - initWithBytesNoCopy:length:encoding:freeWhenDone:

Возвращает инициализированный NSString объект, содержащий данное число байтов от данного буфера байтов, интерпретируемых в данном кодировании, и дополнительно освобождающий буфер.

Объявление

Swift

convenience init?(bytesNoCopy bytes: UnsafeMutablePointer<Void>, length length: Int, encoding encoding: UInt, freeWhenDone flag: Bool)

Objective C

- (instancetype)initWithBytesNoCopy:(void *)bytes length:(NSUInteger)length encoding:(NSStringEncoding)encoding freeWhenDone:(BOOL)flag

Параметры

`bytes`	Буфер байтов, интерпретируемых в кодировании, указанном `encoding`.
`length`	Число байтов для использования от `bytes`.
`encoding`	Кодировка символов `bytes`.
`flag`	Если `YEStrue`, получатель освобождает память, когда этому больше не нужны данные; если `NOfalse` это не будет.

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

Специальные замечания

Если ошибка происходит во время создания строки, то bytes не освобожден даже если flag YEStrue. В этом случае вызывающая сторона ответственна за освобождение буфера. Это позволяет вызывающей стороне продолжать пытаться создать строку с буфером, не освобождая буфер.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithBytes:length:encoding:


    
    init (characters:length:)
    - initWithCharacters:length:

Возвращает инициализированный NSString объект, содержащий данное число символов от данного массива C символов Unicode.

Объявление

Swift

convenience init(characters characters: UnsafePointer<unichar>, length length: Int)

Objective C

- (instancetype)initWithCharacters:(const unichar *)characters length:(NSUInteger)length

Параметры

`characters`	Массив C символов Unicode; значение не должно быть `NULL`. Важный Повышает исключение если `characters` `NULL`, даже если `length` `0`.
`length`	Число символов для использования от `characters`.

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

Инициализированный NSString объектный содержащий length символы, взятые от characters. Возвращенный объект может отличаться от исходного получателя.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithCharacters:length:


    
    init (charactersNoCopy:length:freeWhenDone:)
    - initWithCharactersNoCopy:length:freeWhenDone:

Объявление

Swift

convenience init(charactersNoCopy characters: UnsafeMutablePointer<unichar>, length length: Int, freeWhenDone flag: Bool)

Objective C

- (instancetype)initWithCharactersNoCopy:(unichar *)characters length:(NSUInteger)length freeWhenDone:(BOOL)flag

Параметры

`characters`	Массив C символов Unicode.
`length`	Число символов для использования от `characters`.
`flag`	Если `YEStrue`, получатель освободит память, когда этому больше не будут нужны символы; если `NOfalse` это не будет.

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

Инициализированный NSString содержащий объект length символы от characters. Возвращенный объект может отличаться от исходного получателя.

Специальные замечания

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithCharacters:length:


    
    init (строка:)
    - initWithString:

Возвраты NSString объект, инициализированный путем копирования символов с другой данной строки.

Объявление

Swift

convenience init(string aString: String)

Objective C

- (instancetype)initWithString:(NSString *)aString

Параметры


      aString

Строка, с которой можно скопировать символы. Это значение не должно быть nil.

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

NSString объект, инициализированный путем копирования символов с aString. Возвращенный объект может отличаться от исходного получателя.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithString:


    
    init (CString:encoding:)
    - initWithCString:encoding:

Возвраты NSString объект инициализировал использование символов в данном массиве C, интерпретируемом согласно данному кодированию.

Объявление

Swift

convenience init?(CString nullTerminatedCString: UnsafePointer<Int8>, encoding encoding: UInt)

Objective C

- (instancetype)initWithCString:(const char *)nullTerminatedCString encoding:(NSStringEncoding)encoding

Параметры

`nullTerminatedCString`	Массив C символов. Массив должен закончиться a `NULL` символ; промежуточное звено `NULL` символы не позволяются.
`encoding`	Кодирование `nullTerminatedCString`.

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

NSString объект инициализировал использование символов от nullTerminatedCString. Возвращенный объект может отличаться от исходного получателя

Обсуждение

Если nullTerminatedCString не a NULL- завершенная струна до, или encoding не соответствует фактическое кодирование, результаты не определены.

Специальные замечания

Поскольку NULL байты не позволяются, 16-разрядные кодировки не поддерживаются, потому что их содержание будет обычно включать NULL байты.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithCString:
– initWithCStringNoCopy:length:freeWhenDone:
+ defaultCStringEncoding


    
    init (UTF8String:)
    - initWithUTF8String:

Возвраты NSString объект, инициализированный путем копирования символов с данного массива C UTF8-закодированных байтов.

Объявление

Swift

convenience init?(UTF8String bytes: UnsafePointer<Int8>)

Objective C

- (instancetype)initWithUTF8String:(const char *)bytes

Параметры


      bytes

A NULL- завершенный массив C байтов в кодировании UTF-8. Это значение не должно быть NULL.

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

NSString объект, инициализированный путем копирования байтов с bytes. Возвращенный объект может отличаться от исходного получателя.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithUTF8String:


    
    - initWithFormat:

Возвраты NSString объект инициализировал при помощи данной строки формата как шаблон, в который заменяют остающимися значениями аргументов.

Объявление

Objective C

- (instancetype)initWithFormat:(NSString *)format, ...

Параметры


      format

Строка формата. Посмотрите Строковые Объекты Форматирования для примеров того, как использовать этот метод и Спецификаторы Формата строки для списка спецификаторов формата. Это значение не должно быть nil.

...

Список разделенных запятой значений параметров для замены в format.

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

NSString объект, инициализированный при помощи format как шаблон, в который остающимися значениями аргументов заменяют согласно системной локали. Возвращенный объект может отличаться от исходного получателя.

Обсуждение

Вызывает initWithFormat:locale:arguments: с nil как локаль, следовательно с помощью системной локали для форматирования чисел. Это полезно, например, если Вы хотите произвести «нелокализованное» форматирование, которое должно быть выписано к файлам и проанализировало назад позже.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithFormat:
– initWithFormat:locale:arguments:


    
    init (format:arguments:)
    - initWithFormat:arguments:

Возвраты NSString объект инициализировал при помощи данной строки формата как шаблон, в который остающимися значениями аргументов заменяют согласно текущей локали.

Объявление

Swift

convenience init(format format: String, arguments argList: CVaListPointer)

Objective C

- (instancetype)initWithFormat:(NSString *)format arguments:(va_list)argList

Параметры


      format


      argList

Список параметров для замены в format.

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

NSString объект, инициализированный при помощи format как то, шаблон, в который значения в argList заменены согласно текущей локали. Возвращенный объект может отличаться от исходного получателя.

Обсуждение

Вызывает initWithFormat:locale:arguments: с nil как локаль.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithFormat:


    
    - initWithFormat:locale:

Возвраты NSString объект инициализировал при помощи данной строки формата как шаблон, в который остающимися значениями аргументов заменяют согласно данной локали.

Объявление

Objective C

- (instancetype)initWithFormat:(NSString *)format locale:(id)locale, ...

Параметры

`format`	Строка формата. Посмотрите Строковые Объекты Форматирования для примеров того, как использовать этот метод и Спецификаторы Формата строки для списка спецификаторов формата. Это значение не должно быть `nil`. Важный Повышения `NSInvalidArgumentException` если `format` `nil`.
`locale`	`NSLocale` объект, указывающий локаль для использования. Использовать текущую локаль, передача [`NSLocalecurrentLocale`]. Использовать системную локаль, передачу `nil`. Для устаревшей поддержки это может быть экземпляром `NSDictionary` содержа информацию о локали.
`...`	Список разделенных запятой значений параметров для замены в `format`.

Обсуждение

Вызывает initWithFormat:locale:arguments: с locale как локаль.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ localizedStringWithFormat:


    
    init (format:locale:arguments:)
    - initWithFormat:locale:arguments:

Возвраты NSString объект инициализировал при помощи данной строки формата как шаблон, в который остающимися значениями аргументов заменяют согласно данной информации о локали.

Объявление

Swift

convenience init(format format: String, locale locale: AnyObject?, arguments argList: CVaListPointer)

Objective C

- (instancetype)initWithFormat:(NSString *)format locale:(id)locale arguments:(va_list)argList

Параметры

`format`	Строка формата. Посмотрите Строковые Объекты Форматирования для примеров того, как использовать этот метод и Спецификаторы Формата строки для списка спецификаторов формата. Это значение не должно быть `nil`. Важный Повышения `NSInvalidArgumentException` если `format` `nil`.
`locale`	`NSLocale` объект, указывающий локаль для использования. Использовать текущую локаль (указанный пользовательскими настройками), передача [`NSLocalecurrentLocale`]. Использовать системную локаль, передачу `nil`. Для устаревшей поддержки это может быть экземпляром `NSDictionary` содержа информацию о локали.
`argList`	Список параметров для замены в `format`.

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

NSString объект, инициализированный при помощи format как то, шаблон, в который значения в argList заменены согласно информации о локали в locale. Возвращенный объект может отличаться от исходного получателя.

Обсуждение

Следующий фрагмент кода иллюстрирует, как создать строку из myArgs, который получен из строкового объекта со значением «Стоимость»: и интервал со значением 32:

      va_list myArgs;
 
NSString *myString = [[NSString alloc] initWithFormat:@"%@:  %d\n"
        locale:[NSLocale currentLocale]
        arguments:myArgs];

Получившая строка имеет значение “Cost: 32\n”.

См. Строковое Руководство по программированию для получения дополнительной информации.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithFormat:arguments:


    
    init (data:encoding:)
    - initWithData:encoding:

Возвраты NSString объект, инициализированный путем преобразования определенных данных в символы Unicode с помощью данного кодирования.

Объявление

Swift

convenience init?(data data: NSData, encoding encoding: UInt)

Objective C

- (instancetype)initWithData:(NSData *)data encoding:(NSStringEncoding)encoding

Параметры

`data`	`NSData` объект, содержащий байты в `encoding` и формат обычного текста по умолчанию (т.е. чистое содержание без атрибутов или других разметок) для того кодирования.
`encoding`	Кодирование, используемое `data`.

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

NSString объект, инициализированный путем преобразования байтов в data в использование символов Unicode encoding. Возвращенный объект может отличаться от исходного получателя. Возвраты nil если инициализация перестала работать по некоторым причинам (например, если data не представляет допустимые данные для encoding).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    + stringWithFormat:

Возвращает строку, создаваемую при помощи данной строки формата как шаблон, в который заменяют остающимися значениями аргументов.

Объявление

Objective C

+ (instancetype)stringWithFormat:(NSString *)format, ...

Параметры


      format

...

Список разделенных запятой значений параметров для замены в format.

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

Строка, создаваемая при помощи format как шаблон, в который остающимися значениями аргументов заменяют согласно системной локали.

Обсуждение

Этот метод подобен localizedStringWithFormat:, но с помощью системной локали для форматирования чисел. Это полезно, например, если Вы хотите произвести «нелокализованное» форматирование, которое должно быть выписано к файлам и проанализировало назад позже.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithFormat:
+ localizedStringWithFormat:


    
    + localizedStringWithFormat:

Возвращает строку, создаваемую при помощи данной строки формата как шаблон, в который остающимися значениями аргументов заменяют согласно текущей локали.

Объявление

Objective C

+ (instancetype)localizedStringWithFormat:(NSString *)format, ...

Параметры


      format

Повышения NSInvalidArgumentException если format nil.

...

Список разделенных запятой значений параметров для замены в format.

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

Строка, создаваемая при помощи format как шаблон, в который следующими значениями аргументов заменяют согласно информации о форматировании в текущей локали.

Обсуждение

Этот метод эквивалентен использованию initWithFormat:locale: и передача текущей локали как параметр локали.

Как пример форматирования, этот метод заменяет десятичное число согласно локали в %f и %d замены и вызовы descriptionWithLocale: вместо description в случае необходимости.

Эта выборка кода создает строку из другой строки и плавания:

      NSString *myString = [NSString localizedStringWithFormat:@"%@:  %f\n", @"Cost", 1234.56];

Получившая строка имеет значение “Cost: 1234.560000\n” если локаль en_US, и “Cost: 1234,560000\n” если локаль fr_FR.

Посмотрите Строковые Объекты Форматирования для получения дополнительной информации.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithFormat:
– initWithFormat:locale:


    
    + stringWithCharacters:length:

Возвращает строку, содержащую данное число символов, взятых от данного массива C символов Unicode.

Объявление

Objective C

+ (instancetype)stringWithCharacters:(const unichar *)chars length:(NSUInteger)length

Параметры

`chars`	Массив C символов Unicode; значение не должно быть `NULL`. Важный Повышает исключение если `chars` `NULL`, даже если `length` `0`.
`length`	Число символов для использования от `chars`.

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

Строка, содержащая length Взятые символы Unicode (начиная с первого) от chars.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithCharacters:length:


    
    + stringWithString:

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

Объявление

Objective C

+ (instancetype)stringWithString:(NSString *)aString

Параметры


      aString

Строка, с которой можно скопировать символы. Это значение не должно быть nil.

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

Строка, создаваемая путем копирования символов с aString.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithString:


    
    + stringWithCString:encoding:

Возвращает строку, содержащую байты в данном массиве C, интерпретируемом согласно данному кодированию.

Объявление

Objective C

+ (instancetype)stringWithCString:(const char *)cString encoding:(NSStringEncoding)enc

Параметры

`cString`	Массив C байтов. Массив должен закончиться a `NULL` байт; промежуточное звено `NULL` байты не позволяются.
`enc`	Кодирование `cString`.

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

Строка, содержащая символы, описанные в cString.

Обсуждение

Если cString не a NULL- завершенная струна до, или encoding не соответствует фактическое кодирование, результаты не определены.

Специальные замечания

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithCString:encoding:


    
    + stringWithUTF8String:

Возвращает строку, создаваемую путем копирования данных с данного массива C UTF8-закодированных байтов.

Объявление

Objective C

+ (instancetype)stringWithUTF8String:(const char *)bytes

Параметры


      bytes

A NULL- завершенный массив C байтов в кодировании UTF8.

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

Строка, создаваемая путем копирования данных с bytes.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithString:

+ stringWithCString: (iOS 2.0)

Создает новую строку с помощью данной струны до.

Оператор осуждения

Использовать stringWithCString:encoding: вместо этого.

Объявление

Objective C

+ (id)stringWithCString:(const char *)bytes

Обсуждение

cString должен содержать данные в кодировании струны до по умолчанию. Если параметр передал stringWithCString: не завершенная нулем струна до, результаты не определены.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

+ stringWithCString:encoding:
- initWithCString: (iOS 2.0)

Инициализирует получатель, недавно выделенный NSString объект, путем преобразования данных в данной струне до от кодирования струны до по умолчанию в кодировку символов Unicode.

Оператор осуждения

Использовать initWithCString:encoding: вместо этого.

Объявление

Objective C

- (id)initWithCString:(const char *)bytes

Обсуждение

cString должен быть завершенная нулем струна до в кодировании струны до по умолчанию и может не быть NULL. Возвращает инициализированный объект, который мог бы отличаться от исходного получателя.

Для создания неизменной строки из неизменного буфера струны до не пытайтесь использовать этот метод. Вместо этого используйте initWithCStringNoCopy:length:freeWhenDone:.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– initWithCString:encoding:
+ stringWithCString:length: (iOS 2.0)

Возвращает строку, содержащую символы в данной струне до.

Оператор осуждения

Использовать stringWithCString:encoding: вместо этого.

Объявление

Objective C

+ (id)stringWithCString:(const char *)bytes length:(NSUInteger)length

Обсуждение

cString не должен быть NULL. cString должен содержать символы в кодировании струны до по умолчанию. Этот метод преобразовывает length * sizeof(char) байты от cString и не резко останавливается в a NULL символ.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

+ stringWithCString:encoding:
- initWithCString:length: (iOS 2.0)

Инициализирует получатель, недавно выделенный NSString объект, путем преобразования данных в данной струне до от кодирования струны до по умолчанию в кодировку символов Unicode.

Оператор осуждения

Использовать initWithBytes:length:encoding: вместо этого.

Объявление

Objective C

- (id)initWithCString:(const char *)bytes length:(NSUInteger)length

Обсуждение

Этот метод преобразовывает length * sizeof(char) байты от cString и не резко останавливается в нулевом символе. cString должен содержать байты в кодировании струны до по умолчанию и может не быть NULL. Возвращает инициализированный объект, который мог бы отличаться от исходного получателя.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– initWithCString:encoding:
- initWithCStringNoCopy:length:freeWhenDone: (iOS 2.0)

Инициализирует получатель, недавно выделенный NSString объект, путем преобразования данных в данной струне до от кодирования струны до по умолчанию в кодировку символов Unicode.

Оператор осуждения

Использовать initWithBytesNoCopy:length:encoding:freeWhenDone: вместо этого.

Объявление

Objective C

- (id)initWithCStringNoCopy:(char *)bytes length:(NSUInteger)length freeWhenDone:(BOOL)freeBuffer

Обсуждение

Этот метод преобразовывает length * sizeof(char) байты от cString и не резко останавливается в нулевом символе. cString должен содержать данные в кодировании струны до по умолчанию и может не быть NULL. Получатель становится владельцем cString; если flag YEStrue это освободит память, когда этому больше не будет нужен он, но если flag NOfalse это не будет. Возвращает инициализированный объект, который мог бы отличаться от исходного получателя.

Можно использовать этот метод для создания неизменной строки из неизменного (const char *) Буфер струны до. При получении предупреждающего сообщения можно игнорировать его; его цель состоит в том, чтобы просто предупредить Вас, что струна до передала, поскольку может быть изменен первый параметр метода. Если Вы удостоверяетесь freeWhenDone параметр initWithStringNoCopy NOfalse, струна до передала, поскольку первый параметр метода не может быть изменен, таким образом, можно безопасно использовать initWithStringNoCopy создать неизменную строку из неизменного (const char *) Буфер струны до.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– initWithCString:encoding:

Создание и инициализация строки от файла


    
    + stringWithContentsOfFile:encoding:error:

Возвращает строку, создаваемую путем чтения данных из файла в данном пути, интерпретируемом с помощью данного кодирования.

Объявление

Objective C

+ (instancetype)stringWithContentsOfFile:(NSString *)path encoding:(NSStringEncoding)enc error:(NSError **)error

Параметры

`path`	Путь к файлу.
`enc`	Кодирование файла в `path`.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, передаете в `NULL`.

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

Строка, создаваемая путем чтения данных из файла, названного path использование кодирования, enc. Если файл не может быть открыт или существует ошибка кодирования, возвраты nil.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithContentsOfFile:encoding:error:


    
    init (contentsOfFile:encoding:error:)
    - initWithContentsOfFile:encoding:error:

Возвраты NSString объект, инициализированный путем чтения данных из файла в данном пути с помощью данного кодирования.

Объявление

Swift

convenience init?(contentsOfFile path: String, encoding enc: UInt, error error: NSErrorPointer)

Objective C

- (instancetype)initWithContentsOfFile:(NSString *)path encoding:(NSStringEncoding)enc error:(NSError **)error

Параметры

`path`	Путь к файлу.
`enc`	Кодирование файла в `path`.
`error`	Если ошибка происходит, по возврату содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, передаете в `NULL`.

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

NSString объект, инициализированный путем чтения данных из файла, названного path использование кодирования, enc. Возвращенный объект может отличаться от исходного получателя. Если файл не может быть открыт или существует ошибка кодирования, возвраты nil.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithContentsOfFile:encoding:error:
– initWithContentsOfFile:usedEncoding:error:


    
    + stringWithContentsOfFile:usedEncoding:error:

Возвращает строку, создаваемую путем чтения данных из файла в данном пути, и возвращается ссылкой, кодирование раньше интерпретировало файл.

Объявление

Objective C

+ (instancetype)stringWithContentsOfFile:(NSString *)path usedEncoding:(NSStringEncoding *)enc error:(NSError **)error

Параметры

`path`	Путь к файлу.
`enc`	По возврату, если файл читается успешно, содержит кодирование, используемое для интерпретации файла в `path`.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, можно передать в `NULL`.

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

Строка, создаваемая путем чтения данных из файла, названного path. Если файл не может быть открыт или существует ошибка кодирования, возвраты nil.

Обсуждение

Этот метод пытается определить кодирование файла в path.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– initWithContentsOfFile:encoding:error:


    
    init (contentsOfFile:usedEncoding:error:)
    - initWithContentsOfFile:usedEncoding:error:

Возвраты NSString объект, инициализированный путем чтения данных из файла в данном пути и возвратах ссылкой кодирование раньше, интерпретировал символы.

Объявление

Swift

convenience init?(contentsOfFile path: String, usedEncoding enc: UnsafeMutablePointer<UInt>, error error: NSErrorPointer)

Objective C

- (instancetype)initWithContentsOfFile:(NSString *)path usedEncoding:(NSStringEncoding *)enc error:(NSError **)error

Параметры

`path`	Путь к файлу.
`enc`	По возврату, если файл читается успешно, содержит кодирование, используемое для интерпретации файла в `path`.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, передаете в `NULL`.

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

NSString объект, инициализированный путем чтения данных из файла, названного path. Возвращенный объект может отличаться от исходного получателя. Если файл не может быть открыт или существует ошибка кодирования, возвраты nil.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithContentsOfFile:encoding:error:
– initWithContentsOfFile:encoding:error:

+ stringWithContentsOfFile: (iOS 2.0)

Возвращает строку, создаваемую путем чтения данных из файла, названного данным путем.

Оператор осуждения

Использовать stringWithContentsOfFile:encoding:error: или stringWithContentsOfFile:usedEncoding:error: вместо этого.

Объявление

Objective C

+ (id)stringWithContentsOfFile:(NSString *)path

Обсуждение

Если содержание начинается с метки порядка байтов Unicode (U+FEFF или U+FFFE), интерпретирует содержание как символы Unicode. Если содержание начинается с метки порядка байтов UTF-8 (EFBBBF), интерпретирует содержание как UTF-8. Иначе, интерпретирует содержание как данные в кодировании струны до по умолчанию. Так как кодирование струны до по умолчанию будет меняться в зависимости от конфигурации пользователя, не зависьте от этого метода, если Вы не используете Unicode или UTF-8, или можно проверить кодирование струны до по умолчанию. Возвраты nil если не может быть открыт файл.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

+ stringWithContentsOfFile:encoding:error:
+ stringWithContentsOfFile:usedEncoding:error:
- initWithContentsOfFile: (iOS 2.0)

Инициализирует получатель, недавно выделенный NSString объект, путем чтения данных из файла, названного path.

Оператор осуждения

Использовать initWithContentsOfFile:encoding:error: или initWithContentsOfFile:usedEncoding:error: вместо этого.

Объявление

Objective C

- (id)initWithContentsOfFile:(NSString *)path

Обсуждение

Инициализирует получатель, недавно выделенный NSString объект, путем чтения данных из файла, названного path. Если содержание начинается с метки порядка байтов (U+FEFF или U+FFFE), интерпретирует содержание как символы Unicode; иначе интерпретирует содержание как данные в кодировании струны до по умолчанию. Возвращает инициализированный объект, который мог бы отличаться от исходного получателя, или nil если не может быть открыт файл.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– initWithContentsOfFile:encoding:error:
– initWithContentsOfFile:usedEncoding:error:

Создание и инициализация строки от URL


    
    + stringWithContentsOfURL:encoding:error:

Возвращает строку, создаваемую путем чтения данных из данного URL, интерпретируемого с помощью данного кодирования.

Объявление

Objective C

+ (instancetype)stringWithContentsOfURL:(NSURL *)url encoding:(NSStringEncoding)enc error:(NSError **)error

Параметры

`url`	URL для чтения.
`enc`	Кодирование данных в `url`.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, можно передать в `NULL`.

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

Строка, создаваемая путем чтения данных из URL использование кодирования, enc. Если URL не может быть открыт или существует ошибка кодирования, возвраты nil.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithContentsOfURL:usedEncoding:error:
– initWithContentsOfURL:encoding:error:


    
    init (contentsOfURL:encoding:error:)
    - initWithContentsOfURL:encoding:error:

Возвраты NSString объект, инициализированный путем чтения данных из данного URL, интерпретировал использование данного кодирования.

Объявление

Swift

convenience init?(contentsOfURL url: NSURL, encoding enc: UInt, error error: NSErrorPointer)

Objective C

- (instancetype)initWithContentsOfURL:(NSURL *)url encoding:(NSStringEncoding)enc error:(NSError **)error

Параметры

`url`	URL для чтения.
`enc`	Кодирование файла в `path`.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, передаете в `NULL`.

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

NSString объект, инициализированный путем чтения данных из url. Возвращенный объект может отличаться от исходного получателя. Если URL не может быть открыт или существует ошибка кодирования, возвраты nil.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithContentsOfURL:encoding:error:


    
    + stringWithContentsOfURL:usedEncoding:error:

Возвращает строку, создаваемую путем чтения данных из данного URL, и возвращается ссылкой, кодирование раньше интерпретировало данные.

Объявление

Objective C

+ (instancetype)stringWithContentsOfURL:(NSURL *)url usedEncoding:(NSStringEncoding *)enc error:(NSError **)error

Параметры

`url`	URL, из которого можно считать данные.
`enc`	По возврату, если `url` читается успешно, содержит кодирование, используемое для интерпретации данных.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, можно передать в `NULL`.

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

Строка, создаваемая путем чтения данных из url. Если URL не может быть открыт или существует ошибка кодирования, возвраты nil.

Обсуждение

Этот метод пытается определить кодирование в url.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithContentsOfURL:encoding:error:
– initWithContentsOfURL:usedEncoding:error:


    
    init (contentsOfURL:usedEncoding:error:)
    - initWithContentsOfURL:usedEncoding:error:

Возвраты NSString объект, инициализированный путем чтения данных из данного URL и возвратов ссылкой кодирование раньше, интерпретировал данные.

Объявление

Swift

convenience init?(contentsOfURL url: NSURL, usedEncoding enc: UnsafeMutablePointer<UInt>, error error: NSErrorPointer)

Objective C

- (instancetype)initWithContentsOfURL:(NSURL *)url usedEncoding:(NSStringEncoding *)enc error:(NSError **)error

Параметры

`url`	URL, из которого можно считать данные.
`enc`	По возврату, если `url` читается успешно, содержит кодирование, используемое для интерпретации данных.
`error`	Если ошибка происходит, по возвратам содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь возможными ошибками, передаете в `NULL`.

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

NSString объект, инициализированный путем чтения данных из url. Если url не может быть открыт или кодирование не может быть определено, возвраты nil. Возвращенный инициализированный объект мог бы отличаться от исходного получателя

Обсуждение

Считывать данные с неизвестным кодированием, передачей 0 как enc параметр как в:

          NSURL *textFileURL = …;
    NSStringEncoding encoding = 0;
    NSError *error = nil;
    NSString *string = [[NSString alloc] initWithContentsOfURL:textFileURL usedEncoding:&encoding error:&error];

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ stringWithContentsOfURL:usedEncoding:error:

+ stringWithContentsOfURL: (iOS 2.0)

Возвращает строку, создаваемую путем чтения данных из файла, названного данным URL.

Оператор осуждения

Использовать stringWithContentsOfURL:encoding:error: или stringWithContentsOfURL:usedEncoding:error: вместо этого.

Объявление

Objective C

+ (id)stringWithContentsOfURL:(NSURL *)url

Обсуждение

Если содержание начинается с метки порядка байтов (У+ФЕВ или У+ФФФ), интерпретирует содержание как символы Unicode. Если содержание начинается с метки порядка байтов UTF-8 (EFBBBF), интерпретирует содержание как UTF-8. Иначе интерпретирует содержание как данные в кодировании струны до по умолчанию. Так как кодирование струны до по умолчанию будет меняться в зависимости от конфигурации пользователя, не зависьте от этого метода, если Вы не используете Unicode или UTF-8, или можно проверить кодирование струны до по умолчанию. Возвраты nil если не может быть открыто расположение.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

+ stringWithContentsOfURL:encoding:error:
+ stringWithContentsOfURL:usedEncoding:error:
- initWithContentsOfURL: (iOS 2.0)

Инициализирует получатель, недавно выделенный NSString объект, путем чтения данных из расположения называет данный URL.

Оператор осуждения

Использовать initWithContentsOfURL:encoding:error: или initWithContentsOfURL:usedEncoding:error: вместо этого.

Объявление

Objective C

- (id)initWithContentsOfURL:(NSURL *)url

Обсуждение

Инициализирует получатель, недавно выделенный NSString объект, путем чтения данных из расположения, названного aURL. Если содержание начинается с метки порядка байтов (U+FEFF или U+FFFE), интерпретирует содержание как символы Unicode; иначе интерпретирует содержание как данные в кодировании струны до по умолчанию. Возвращает инициализированный объект, который мог бы отличаться от исходного получателя, или nil если не может быть открыто расположение.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– initWithContentsOfURL:encoding:error:
– initWithContentsOfURL:usedEncoding:error:

Запись в файл или URL


    
    writeToFile (_: atomically:encoding:error:)
    - writeToFile:atomically:encoding:error:

Пишет содержание получателя к файлу в данном пути с помощью данного кодирования.

Объявление

Swift

func writeToFile(_ path: String, atomically useAuxiliaryFile: Bool, encoding enc: UInt, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)writeToFile:(NSString *)path atomically:(BOOL)useAuxiliaryFile encoding:(NSStringEncoding)enc error:(NSError **)error

Параметры

`path`	Файл, в который можно записать получатель. Если `path` содержит тильду (`~`) символ, необходимо развернуть его с `stringByExpandingTildeInPath` прежде, чем вызвать этот метод.
`useAuxiliaryFile`	Если `YEStrue`, получатель записан во вспомогательный файл, и затем вспомогательный файл переименован к `path`. Если `NOfalse`, получатель записан непосредственно в `path`. `YEStrue` опция гарантирует это `path`, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи.
`enc`	Кодирование для использования для вывода.
`error`	Если существует ошибка, по возврату содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь подробными данными ошибок, можно передать в `NULL`.

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

YEStrue если файл записан успешно, иначе NOfalse (если была проблема, пишущая в файл или с кодированием).

Обсуждение

Этот метод перезаписывает любой существующий файл в path.

Этот метод хранит указанное кодирование файлом в расширенном атрибуте под именем com.apple.TextEncoding. Значение содержит имя IANA для кодирования и CFStringEncoding значение для кодирования, разделенного точкой с запятой. CFStringEncoding значение записано как строка ASCII, содержащая 32-разрядное десятичное целое число без знака, и не завершается нулевым символом. Один или оба из этих значений может отсутствовать. Примеры записанного значения включают следующее:

      MACINTOSH;0
UTF-8;134217984
UTF-8;
;3071

Методы initWithContentsOfFile:usedEncoding:error:, initWithContentsOfURL:usedEncoding:error:, stringWithContentsOfFile:usedEncoding:error:, и stringWithContentsOfURL:usedEncoding:error: используйте эту информацию для открытия файла с помощью правильного кодирования.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

- writeToFile:atomically: (iOS 2.0)

Пишет содержание получателя к файлу, указанному данным путем.

Оператор осуждения

Использовать writeToFile:atomically:encoding:error: вместо этого.

Объявление

Objective C

- (BOOL)writeToFile:(NSString *)path atomically:(BOOL)useAuxiliaryFile

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

YEStrue если файл записан успешно, иначе NOfalse.

Обсуждение

Пишет содержание получателя к файлу, указанному path (перезаписывающий любой существующий файл в path). path записан в кодировании струны до по умолчанию, если бы возможный (т.е. если никакая информация не была бы потеряна), в Unicode, кодирующем иначе.

Если flag YEStrue, получатель записан во вспомогательный файл, и затем вспомогательный файл переименован к path. Если flag NOfalse, получатель записан непосредственно в path. YEStrue опция гарантирует это path, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи.

Если path содержит тильду (~) символ, необходимо развернуть его с stringByExpandingTildeInPath прежде, чем вызвать этот метод.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– writeToFile:atomically:encoding:error:


    
    writeToURL (_: atomically:encoding:error:)
    - writeToURL:atomically:encoding:error:

Пишет содержание получателя к URL, указанному url использование указанного кодирования.

Объявление

Swift

func writeToURL(_ url: NSURL, atomically useAuxiliaryFile: Bool, encoding enc: UInt, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)writeToURL:(NSURL *)url atomically:(BOOL)useAuxiliaryFile encoding:(NSStringEncoding)enc error:(NSError **)error

Параметры

`url`	URL, в который можно записать получатель. Только файл URLs поддерживается.
`useAuxiliaryFile`	Если `YEStrue`, получатель записан во вспомогательный файл, и затем вспомогательный файл переименован к `url`. Если `NOfalse`, получатель записан непосредственно в `url`. `YEStrue` опция гарантирует это `url`, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи. `useAuxiliaryFile` параметр проигнорирован если `url` не имеет типа, к которому можно получить доступ атомарно.
`enc`	Кодирование для использования для вывода.
`error`	Если существует ошибка, по возврату содержит `NSError` объект, описывающий проблему. Если Вы не интересуетесь подробными данными ошибок, можно передать в `NULL`.

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

YEStrue если URL записан успешно, иначе NOfalse (если была проблема, пишущая в URL или с кодированием).

Обсуждение

      MACINTOSH;0
UTF-8;134217984
UTF-8;
;3071

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

- writeToURL:atomically: (iOS 2.0)

Пишет содержание получателя к расположению, указанному данным URL.

Оператор осуждения

Использовать writeToURL:atomically:encoding:error: вместо этого.

Объявление

Objective C

- (BOOL)writeToURL:(NSURL *)url atomically:(BOOL)atomically

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

YEStrue если расположение записано успешно, иначе NOfalse.

Обсуждение

Если atomically YEStrue, получатель записан во вспомогательное расположение, и затем вспомогательное расположение переименовано к aURL. Если atomically NOfalse, получатель записан непосредственно в aURL. YEStrue опция гарантирует это aURL, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи.

atomically параметр проигнорирован если aURL не имеет типа, к которому можно получить доступ атомарно.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– writeToURL:atomically:encoding:error:

Получение длины строки

length Свойство

Число символов Unicode в получателе. (только для чтения)

Объявление

Swift

var length: Int { get }

Objective C

@property(readonly) NSUInteger length

Обсуждение

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

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– lengthOfBytesUsingEncoding:
sizeWithAttributes: (NSString Дополнения)
lengthOfBytesUsingEncoding (_:) - lengthOfBytesUsingEncoding:

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

Объявление

Swift

func lengthOfBytesUsingEncoding(_ enc: UInt) -> Int

Objective C

- (NSUInteger)lengthOfBytesUsingEncoding:(NSStringEncoding)enc

Параметры

enc

Кодирование, для которого можно определить длину получателя.

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

Число байтов, требуемых сохранить получатель в кодировании enc в невнешнем представлении. Длина не включает пространство для завершения NULL символ. Возвраты 0 если бы объем памяти, требуемый для хранения результатов преобразования кодирования, превысил бы, если указанное кодирование не может использоваться для преобразования получателя или NSIntegerMax.

Обсуждение

Результат точен и возвращается в O(n) время.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– maximumLengthOfBytesUsingEncoding:
– длина
maximumLengthOfBytesUsingEncoding (_:) - maximumLengthOfBytesUsingEncoding:

Возвращается максимальное количество байтов должно было сохранить получатель в данном кодировании.

Объявление

Swift

func maximumLengthOfBytesUsingEncoding(_ enc: UInt) -> Int

Objective C

- (NSUInteger)maximumLengthOfBytesUsingEncoding:(NSStringEncoding)enc

Параметры

enc

Кодирование, для которого можно определить длину получателя.

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

Максимальное количество байтов должно было сохранить получатель в encoding в невнешнем представлении. Длина не включает пространство для завершения NULL символ. Возвраты 0 если бы объем памяти, требуемый для хранения результатов преобразования кодирования, превысил бы NSIntegerMax.

Обсуждение

Результат является оценкой и возвращается в O(1) время; оценка может быть значительно больше, чем необходимая фактическая длина.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– lengthOfBytesUsingEncoding:
– длина

Получение символов и байтов


    
    characterAtIndex (_:)
    - characterAtIndex:

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

Объявление

Swift

func characterAtIndex(_ index: Int) -> unichar

Objective C

- (unichar)characterAtIndex:(NSUInteger)index

Параметры


      index

Индекс символа для получения. Индексное значение не должно лежать вне границ получателя.

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

Символ в позиции массива, данной index.

Обсуждение

Повышения NSRangeException если index лежит за пределами конца получателя.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getCharacters:range:


    
    getCharacters (_:)
    - getCharacters:

(iOS 4.0)

Копии все символы от получателя в данный буфер.

Оператор осуждения

Этот метод небезопасен, потому что он мог потенциально вызвать переполнение буфера. Использовать getCharacters:range: вместо этого.

Объявление

Swift

func getCharacters(_ buffer: UnsafeMutablePointer<unichar>)

Objective C

- (void)getCharacters:(unichar *)buffer

Параметры


      buffer

По возврату, содержит символы от получателя. buffer должно быть достаточно большим для содержания всех символов в строке ([string length]*sizeof(unichar)).

Обсуждение

Вызывает getCharacters:range: с buffer и вся степень получателя как диапазон.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 4.0.

См. также

– длина


    
    getCharacters (_: диапазон:)
    - getCharacters:range:

Символы копий от данного диапазона в получателе в данный буфер.

Объявление

Swift

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

Objective C

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

Параметры

`buffer`	По возврату, содержит символы от получателя. `buffer` должно быть достаточно большим для содержания символов в диапазоне `aRange` (`aRange.length*sizeof(unichar)`).
`aRange`	Диапазон символов для получения. Диапазон не должен превышать границы получателя. Важный Повышения `NSRangeException` если любая часть `aRange` лежит за пределами границ получателя.

Обсуждение

Этот метод не добавляет a NULL символ.

Абстрактная реализация этого метода использование characterAtIndex: неоднократно, правильно извлекая символы, хотя очень неэффективно. Подклассы должны переопределить его для обеспечения внедрения FAST.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    getBytes (_: maxLength:usedLength:encoding:options:range:remainingRange:)
    - getBytes:maxLength:usedLength:encoding:options:range:remainingRange:

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

Объявление

Swift

func getBytes(_ buffer: UnsafeMutablePointer<Void>, maxLength maxBufferCount: Int, usedLength usedBufferCount: UnsafeMutablePointer<Int>, encoding encoding: UInt, options options: NSStringEncodingConversionOptions, range range: NSRange, remainingRange leftover: NSRangePointer) -> Bool

Objective C

- (BOOL)getBytes:(void *)buffer maxLength:(NSUInteger)maxBufferCount usedLength:(NSUInteger *)usedBufferCount encoding:(NSStringEncoding)encoding options:(NSStringEncodingConversionOptions)options range:(NSRange)range remainingRange:(NSRangePointer)leftover

Параметры

`buffer`	Буфер, в который можно сохранить байты от получателя. Возвращенные байты не `NULL`- завершенный.
`maxBufferCount`	Максимальное количество байтов для записи в `buffer`.
`usedBufferCount`	Число байтов, используемых от `buffer`. Передача `NULL` если Вам не нужно это значение.
`encoding`	Кодирование для использования для возвращенных байтов.
`options`	Маска для указания опций использовать для преобразования содержания получателя к `encoding` (если преобразование необходимо).
`range`	Диапазон символов в получателе для получения.
`leftover`	Остающийся диапазон. Передача `NULL` Если Вам не нужно это значение.

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

YEStrue если некоторые символы были преобразованы, иначе NOfalse.

Обсуждение

Преобразование могло бы остановиться, когда буфер заполняется, но это могло бы также остановиться, когда преобразование не возможно вследствие выбранного кодирования.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Получение струн до

cStringUsingEncoding (_:) - cStringUsingEncoding:

Возвращает представление получателя как струна до с помощью данного кодирования.

Объявление

Swift

func cStringUsingEncoding(_ encoding: UInt) -> UnsafePointer<Int8>

Objective C

- (const char *)cStringUsingEncoding:(NSStringEncoding)encoding

Параметры

encoding

Кодирование для возвращенной струны до.

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

Представление струны до получателя с помощью кодирования, указанного encoding. Возвраты NULL если получатель не может быть без потерь преобразован в encoding.

Обсуждение

Возвращенная струна до, как гарантируют, будет допустима только, пока или получатель не будет освобожден, или пока текущая память не освобождена, какой бы ни происходит сначала. Необходимо скопировать струну до или использование getCString:maxLength:encoding: если это должно сохранить струну до вне этого времени.

Можно использовать canBeConvertedToEncoding: проверять, может ли строка быть без потерь преобразована в encoding. Если это не может, можно использовать dataUsingEncoding:allowLossyConversion: получить использование представления струны до encoding, разрешение некоторой потери информации (отмечают что данные, возвращенные dataUsingEncoding:allowLossyConversion: не строгая струна до, так как она не имеет a NULL разделитель).

Специальные замечания

UTF16 и UTF32 не считаются кодировками струны до и не должны использоваться с этим методом — результаты передачи NSUTF16StringEncoding, NSUTF32StringEncoding, или любой из их вариантов не определен.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getCString:
– canBeConvertedToEncoding:
+ defaultCStringEncoding
– cStringLength
– UTF8String


    
    getCString (_: maxLength:encoding:)
    - getCString:maxLength:encoding:

Преобразовывает содержание получателя в данное кодирование и хранит их в буфере.

Объявление

Swift

func getCString(_ buffer: UnsafeMutablePointer<Int8>, maxLength maxBufferCount: Int, encoding encoding: UInt) -> Bool

Objective C

- (BOOL)getCString:(char *)buffer maxLength:(NSUInteger)maxBufferCount encoding:(NSStringEncoding)encoding

Параметры

`buffer`	По возврату, содержит преобразованную струну до плюс `NULL` байт завершения. Буфер должен включать комнату для `maxBufferCount` байты.
`maxBufferCount`	Максимальное количество байтов в строке для возврата в буфере (включая `NULL` байт завершения).
`encoding`	Кодирование для возвращенной струны до.

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

YEStrue если работа была успешна, иначе NOfalse. Возвраты NOfalse если преобразование не возможно вследствие кодирования ошибок или если buffer является слишком маленьким.

Обсуждение

Обратите внимание на то, что в обработке maxBufferCount параметр, этот метод отличается от осуждаемого getCString:maxLength: метод, который это заменяет. (Буфер должен включать комнату для maxBufferCount байты; это число должно разместить ожидаемый размер возвращаемого значения плюс NULL байт завершения, который добавляет этот метод.)

Можно использовать canBeConvertedToEncoding: проверять, может ли строка быть без потерь преобразована в encoding. Если это не может, можно использовать dataUsingEncoding:allowLossyConversion: получить использование представления струны до encoding, разрешение некоторой потери информации (отмечают что данные, возвращенные dataUsingEncoding:allowLossyConversion: не строгая струна до, так как она не имеет a NULL разделитель).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– cStringUsingEncoding:
– canBeConvertedToEncoding:
– UTF8String

UTF8String Свойство

Завершенное нулем представление UTF8 строки. (только для чтения)

Объявление

Swift

var UTF8String: UnsafePointer<Int8> { get }

Objective C

@property(readonly) const char *UTF8String

Обсуждение

Эта струна до является указателем на структуру в строковом объекте, который может иметь время жизни короче, чем строковый объект и не будет, конечно, иметь более длинного времени жизни. Поэтому необходимо скопировать струну до, если она должна быть сохранена за пределами контекста памяти, в котором Вы используете это свойство.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
- cString (iOS 2.0)

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

Оператор осуждения

Использовать cStringUsingEncoding: или UTF8String вместо этого.

Объявление

Objective C

- (const char *)cString

Обсуждение

Возвращенная струна до будет автоматически освобождена так же, как был бы выпущен возвращенный объект; Ваш код должен скопировать струну до или использование getCString: если это должно сохранить струну до за пределами контекста автовыпуска, в котором создается струна до.

Повышения NSCharacterConversionException если получатель не может быть представлен в кодировании струны до по умолчанию без потери информации. Использовать canBeConvertedToEncoding: при необходимости для проверки, может ли строка быть без потерь преобразована в кодирование струны до по умолчанию. Если это не может, использовать lossyCString или dataUsingEncoding:allowLossyConversion: получить представление струны до с некоторой потерей информации.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– cStringUsingEncoding:
– getCString:maxLength:encoding:
– UTF8String
- lossyCString (iOS 2.0)

Возвращает представление получателя как струна до в кодировании струны до по умолчанию, возможно теряя информацию в преобразовании в то кодирование.

Оператор осуждения

Используйте cStringUsingEncoding: или dataUsingEncoding:allowLossyConversion: вместо этого.

Объявление

Objective C

- (const char *)lossyCString

Обсуждение

Если преобразование с потерями, этот метод не повышает исключение. Возвращенная струна до будет автоматически освобождена так же, как был бы выпущен возвращенный объект; Ваш код должен скопировать струну до или использование getCString: если это должно сохранить струну до за пределами контекста автовыпуска, в котором создается струна до.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– cStringUsingEncoding:
– dataUsingEncoding:allowLossyConversion:
- cStringLength (iOS 2.0)

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

Оператор осуждения

Используйте lengthOfBytesUsingEncoding: или maximumLengthOfBytesUsingEncoding: вместо этого.

Объявление

Objective C

- (NSUInteger)cStringLength

Обсуждение

Повышения, если получатель не может быть представлен в кодировании струны до по умолчанию без потери информации. Можно также использовать canBeConvertedToEncoding: проверять, может ли строка быть без потерь преобразована в кодирование струны до по умолчанию. Если это не может, использовать lossyCString для получения представления струны до с некоторой потерей информации затем проверьте ее длину явно с помощью функции ANSI strlen().

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– lengthOfBytesUsingEncoding:
– maximumLengthOfBytesUsingEncoding:
– UTF8String
- getCString: (iOS 2.0)

Вызывает getCString:maxLength:range:remainingRange: с NSMaximumStringLength как максимальная длина, вся степень получателя как диапазон, и NULL для остающегося диапазона.

Оператор осуждения

Используйте cStringUsingEncoding: или dataUsingEncoding:allowLossyConversion: вместо этого.

Объявление

Objective C

- (void)getCString:(char *)bytes

Обсуждение

buffer должно быть достаточно большим для содержания получающейся струны до плюс завершающийся Символ Нулевого (который этот метод добавляет —[string cStringLength]).

Повышения NSCharacterConversionException если получатель не может быть представлен в кодировании струны до по умолчанию без потери информации. Использовать canBeConvertedToEncoding: при необходимости для проверки, может ли строка быть без потерь преобразована в кодирование струны до по умолчанию. Если это не может, использовать lossyCString или dataUsingEncoding:allowLossyConversion: получить представление струны до с некоторой потерей информации.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– cStringUsingEncoding:
– getCString:maxLength:encoding:
– UTF8String
- getCString:maxLength: (iOS 2.0)

Вызывает getCString:maxLength:range:remainingRange: с maxLength как максимальная длина в модулях символьного размера, вся степень получателя как диапазон, и NULL для остающегося диапазона.

Оператор осуждения

Используйте getCString:maxLength:encoding: вместо этого.

Объявление

Objective C

- (void)getCString:(char *)bytes maxLength:(NSUInteger)maxLength

Обсуждение

buffer должно быть достаточно большим для содержания maxLength символы плюс завершающийся нулевой символ (который этот метод добавляет).

Повышения NSCharacterConversionException если получатель не может быть представлен в кодировании струны до по умолчанию без потери информации. Использовать canBeConvertedToEncoding: при необходимости для проверки, может ли строка быть без потерь преобразована в кодирование струны до по умолчанию. Если это не может, использовать lossyCString или dataUsingEncoding:allowLossyConversion: получить представление струны до с некоторой потерей информации.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– cStringUsingEncoding:
– getCString:maxLength:encoding:
– UTF8String
- getCString:maxLength:range:remainingRange: (iOS 2.0)

Преобразовывает содержание получателя в кодирование струны до по умолчанию и хранит их в данном буфере.

Оператор осуждения

Используйте getCString:maxLength:encoding: вместо этого.

Объявление

Objective C

- (void)getCString:(char *)bytes maxLength:(NSUInteger)maxLength range:(NSRange)aRange remainingRange:(NSRangePointer)leftoverRange

Обсуждение

buffer должно быть достаточно большим для содержания maxLength байты плюс завершающийся нулевой символ (который этот метод добавляет). Копии и преобразовывают как можно больше символов от aRange и хранит диапазон не преобразованных в диапазоне, данном leftoverRange (если это не -nil). Повышения NSRangeException если любая часть aRange лежит за пределами конца строки.

Повышения NSCharacterConversionException если получатель не может быть представлен в кодировании струны до по умолчанию без потери информации. Использовать canBeConvertedToEncoding: при необходимости для проверки, может ли строка быть без потерь преобразована в кодирование струны до по умолчанию. Если это не может, использовать lossyCString или dataUsingEncoding:allowLossyConversion: получить представление струны до с некоторой потерей информации.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– cStringUsingEncoding:
– getCString:maxLength:encoding:
– UTF8String

Объединение строк


    
    - stringByAppendingFormat:

Возвращает строку, сделанную путем добавления к получателю строки, созданной из данной строки формата и следующих параметров.

Объявление

Objective C

- (NSString *)stringByAppendingFormat:(NSString *)format, ...

Параметры

`format`	Строка формата. Посмотрите Строковые Объекты Форматирования для получения дополнительной информации. Это значение не должно быть `nil`. Важный Повышения `NSInvalidArgumentException` если `format` `nil`.
`...`	Список разделенных запятой значений параметров для замены в `format`.

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

Строка, сделанная путем добавления к получателю строки, созданной из format и следующие параметры, способом stringWithFormat:.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByAppendingString:


    
    stringByAppendingString (_:)
    - stringByAppendingString:

Возвращает новую строку, сделанную путем добавления данной строки к получателю.

Объявление

Swift

func stringByAppendingString(_ aString: String) -> String

Objective C

- (NSString *)stringByAppendingString:(NSString *)aString

Параметры


      aString

Строка для добавления к получателю. Это значение не должно быть nil.

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

Новая строка сделана путем добавления aString к получателю.

Обсуждение

Эта выборка кода, например:

      NSString *errorTag = @"Error: ";
NSString *errorString = @"premature end of file.";
NSString *errorMessage = [errorTag stringByAppendingString:errorString];

производит строку “Error: premature end of file.”.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByAppendingFormat:


    
    stringByPaddingToLength (_: withString:startingAtIndex:)
    - stringByPaddingToLength:withString:startingAtIndex:

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

Объявление

Swift

func stringByPaddingToLength(_ newLength: Int, withString padString: String, startingAtIndex padIndex: Int) -> String

Objective C

- (NSString *)stringByPaddingToLength:(NSUInteger)newLength withString:(NSString *)padString startingAtIndex:(NSUInteger)padIndex

Параметры

`newLength`	Новая длина для получателя.
`padString`	Строка, с помощью которой можно расширить получатель.
`padIndex`	Индекс в `padString` от которого можно начать дополнять.

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

Новая строка сформировалась из получателя или символами удаления от конца, или путем добавления как много случаев padString по мере необходимости.

Обсуждение

Вот некоторые примеры использования:

      [@"abc" stringByPaddingToLength: 9 withString: @"." startingAtIndex:0];
    // Results in "abc......"

      [@"abc" stringByPaddingToLength: 2 withString: @"." startingAtIndex:0];
    // Results in "ab"

      [@"abc" stringByPaddingToLength: 9 withString: @". " startingAtIndex:1];
    // Results in "abc . . ."
    // Notice that the first character in the padding is " "

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Деление строк

componentsSeparatedByString (_:) - componentsSeparatedByString:
Возвращает массив, содержащий подстроки от получателя, разделенные на данный разделитель.

Объявление

Swift

func componentsSeparatedByString(_ separator: String) -> [AnyObject]

Objective C

- (NSArray *)componentsSeparatedByString:(NSString *)separator

Параметры

separator

Строка разделителя.

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

NSArray объект, содержащий подстроки от получателя, разделенные на separator.
Обсуждение

Подстроки в массиве появляются в порядке, который они сделали в получателе. Смежные случаи строки разделителя производят пустые строки в результате. Точно так же, если строка начинается или заканчивается разделителем, первая или последняя подстрока, соответственно, пуста. Например, этот фрагмент кода:
NSString *list = @"Karin, Carrie, David";

NSArray *listItems = [list componentsSeparatedByString:@", "];
производит массив { @"Karin", @"Carrie", @"David"" }.

Если list начинается с запятой и пространства — например, @", Norman, Stanley, Fletcher"— массив имеет это содержание: { @"", @"Norman", @"Stanley", @"Fletcher" }

Если list не имеет никаких разделителей — например, "Karin"— массив содержит саму строку в этом случае { @"Karin" }.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

componentsJoinedByString: (NSArray)
– pathComponents


    
    componentsSeparatedByCharactersInSet (_:)
    - componentsSeparatedByCharactersInSet:

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

Объявление

Swift

func componentsSeparatedByCharactersInSet(_ separator: NSCharacterSet) -> [AnyObject]

Objective C

- (NSArray *)componentsSeparatedByCharactersInSet:(NSCharacterSet *)separator

Параметры


      separator

Набор символов, содержащий символы к использовать для разделения получателя. Не должен быть nil.

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

NSArray объект, содержащий подстроки от получателя, разделенные на символы в separator.

Обсуждение

Подстроки в массиве появляются в порядке, который они сделали в получателе. Смежные случаи символов разделителя производят пустые строки в результате. Точно так же, если строка начинается или заканчивается символами разделителя, первая или последняя подстрока, соответственно, пуста.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– componentsSeparatedByString:
– stringByTrimmingCharactersInSet:


    
    stringByTrimmingCharactersInSet (_:)
    - stringByTrimmingCharactersInSet:

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

Объявление

Swift

func stringByTrimmingCharactersInSet(_ set: NSCharacterSet) -> String

Objective C

- (NSString *)stringByTrimmingCharactersInSet:(NSCharacterSet *)set

Параметры

set

Набор символов, содержащий символы для удаления из получателя. set не должен быть nil.

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

Новая строка, сделанная путем удаления из обоих концов символов получателя, содержавшихся в set. Если получатель составлен полностью символов от set, пустая строка возвращается.

Обсуждение

Использовать whitespaceCharacterSet или whitespaceAndNewlineCharacterSet удалить пробел вокруг строк.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– componentsSeparatedByCharactersInSet:


    
    substringFromIndex (_:)
    - substringFromIndex:

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

Объявление

Swift

func substringFromIndex(_ anIndex: Int) -> String

Objective C

- (NSString *)substringFromIndex:(NSUInteger)anIndex

Параметры


      anIndex

Индекс. Значение должно лечь в границах получателя или быть равно длине получателя.

Повышения NSRangeException если (anIndex - 1) лежит за пределами конца получателя.

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

Новая строка, содержащая символы получателя от того в anIndex до конца. Если anIndex равно длине строки, возвращает пустую строку.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– substringWithRange:
– substringToIndex:


    
    substringWithRange (_:)
    - substringWithRange:

Возвращает строковый объект, содержащий символы получателя, лежащие в данном диапазоне.

Объявление

Swift

func substringWithRange(_ aRange: NSRange) -> String

Objective C

- (NSString *)substringWithRange:(NSRange)aRange

Параметры


      aRange

Диапазон. Диапазон не должен превышать границы получателя.

Повышения NSRangeException если (aRange.location - 1) или (aRange.location + aRange.length - 1) лежит за пределами конца получателя.

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

Строковый объект, содержащий символы получателя, лежащие в aRange.

Специальные замечания

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

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– substringFromIndex:
– substringToIndex:


    
    substringToIndex (_:)
    - substringToIndex:

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

Объявление

Swift

func substringToIndex(_ anIndex: Int) -> String

Objective C

- (NSString *)substringToIndex:(NSUInteger)anIndex

Параметры


      anIndex

Индекс. Значение должно лечь в границах получателя или быть равно длине получателя.

Повышения NSRangeException если (anIndex - 1) лежит за пределами конца получателя.

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

Новая строка, содержащая символы получателя до, но не включая, тот в anIndex. Если anIndex равно длине строки, возвращает копию получателя.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– substringFromIndex:
– substringWithRange:

Нахождение символов и подстрок


    
    rangeOfCharacterFromSet (_:)
    - rangeOfCharacterFromSet:

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

Объявление

Swift

func rangeOfCharacterFromSet(_ aSet: NSCharacterSet) -> NSRange

Objective C

- (NSRange)rangeOfCharacterFromSet:(NSCharacterSet *)aSet

Параметры


      aSet

Набор символов. Это значение не должно быть nil.

Повышения NSInvalidArgumentException если aSet nil.

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

Диапазон в получателе первого символа, найденного от aSet. Возвращает диапазон {NSNotFound, 0} если ни один из символов в aSet найдены.

Обсуждение

Вызывает rangeOfCharacterFromSet:options: без опций.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    rangeOfCharacterFromSet (_: опции:)
    - rangeOfCharacterFromSet:options:

Находит и возвращает диапазон в получателе первого символа, с помощью данный опции, от данного набора символов.

Объявление

Swift

func rangeOfCharacterFromSet(_ aSet: NSCharacterSet, options mask: NSStringCompareOptions) -> NSRange

Objective C

- (NSRange)rangeOfCharacterFromSet:(NSCharacterSet *)aSet options:(NSStringCompareOptions)mask

Параметры

`aSet`	Набор символов. Это значение не должно быть `nil`. Повышения `NSInvalidArgumentException` если `aSet` `nil`.
`mask`	Маска, указывающая параметры поиска. Следующие опции могут быть указаны путем объединения их с C поразрядно `OR` оператор: `NSAnchoredSearch`, `NSBackwardsSearch`.

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

Обсуждение

Вызывает rangeOfCharacterFromSet:options:range: с mask для опций и всей степени получателя для диапазона.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    rangeOfCharacterFromSet (_: options:range:)
    - rangeOfCharacterFromSet:options:range:

Находит и возвращает диапазон в получателе первого символа от данного набора символов, найденного в данном диапазоне с данными опциями.

Объявление

Swift

func rangeOfCharacterFromSet(_ aSet: NSCharacterSet, options mask: NSStringCompareOptions, range aRange: NSRange) -> NSRange

Objective C

- (NSRange)rangeOfCharacterFromSet:(NSCharacterSet *)aSet options:(NSStringCompareOptions)mask range:(NSRange)aRange

Параметры

`aSet`	Набор символов. Это значение не должно быть `nil`. Повышения `NSInvalidArgumentException` если `aSet` `nil`.
`mask`	Маска, указывающая параметры поиска. Следующие опции могут быть указаны путем объединения их с C поразрядно `OR` оператор: `NSAnchoredSearch`, `NSBackwardsSearch`.
`aRange`	Диапазон, в котором можно искать. `aRange` не должен превышать границы получателя. Повышения `NSRangeException` если `aRange` недопустимо.

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

Диапазон в получателе первого символа, найденного от aSet в aRange. Возвращает диапазон {NSNotFound, 0} если ни один из символов в aSet найдены.

Обсуждение

Поскольку предсоставленные символы в aSet может соответствовать составленные последовательности символов в получателе, длина возвращенного диапазона может быть больше, чем 1. Например, если Вы ищете “ü” в строке “stru¨del”, возвращенный диапазон {3,2}.

Специальные замечания

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    rangeOfString (_:)
    - rangeOfString:

Находит и возвращает диапазон первого возникновения данной строки в получателе.

Объявление

Swift

func rangeOfString(_ aString: String) -> NSRange

Objective C

- (NSRange)rangeOfString:(NSString *)aString

Параметры


      aString

Строка для поиска. Это значение не должно быть nil.

Повышения NSInvalidArgumentException если aString nil.

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

NSRange структура, дающая расположение и длину в получателе первого возникновения aString. Возвраты {NSNotFound, 0} если aString не найден или пуст (@"").

Обсуждение

Вызывает rangeOfString:options: без опций.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    rangeOfString (_: опции:)
    - rangeOfString:options:

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

Объявление

Swift

func rangeOfString(_ aString: String, options mask: NSStringCompareOptions) -> NSRange

Objective C

- (NSRange)rangeOfString:(NSString *)aString options:(NSStringCompareOptions)mask

Параметры


      aString

Строка для поиска. Это значение не должно быть nil.


      mask

Маска, указывающая параметры поиска. Следующие опции могут быть указаны путем объединения их с C поразрядно OR оператор: NSCaseInsensitiveSearch, NSLiteralSearch, NSBackwardsSearch, NSAnchoredSearch. См. Строковое Руководство по программированию для подробных данных об этих опциях.

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

NSRange структура, дающая расположение и длину в получателе первого возникновения aString, по модулю опции в mask. Возвраты {NSNotFound, 0} если aString не найден или пуст (@"").

Обсуждение

Вызывает rangeOfString:options:range: с опциями, указанными mask и вся степень получателя как диапазон.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    rangeOfString (_: options:range:)
    - rangeOfString:options:range:

Находит и возвращает диапазон первого возникновения данной строки, в данном диапазоне получателя согласно данным опциям.

Объявление

Swift

func rangeOfString(_ aString: String, options mask: NSStringCompareOptions, range aRange: NSRange) -> NSRange

Objective C

- (NSRange)rangeOfString:(NSString *)aString options:(NSStringCompareOptions)mask range:(NSRange)aRange

Параметры

`aString`	Строка, которую можно искать. Это значение не должно быть `nil`. Повышения `NSInvalidArgumentException` если `aString` `nil`.
`mask`	Маска, указывающая параметры поиска. Следующие опции могут быть указаны путем объединения их с C поразрядно `OR` оператор: `NSCaseInsensitiveSearch`, `NSLiteralSearch`, `NSBackwardsSearch`, и `NSAnchoredSearch`. См. Строковое Руководство по программированию для подробных данных об этих опциях.
`aRange`	Диапазон в получателе, для которого можно искать `aString`. Повышения `NSRangeException` если `aRange` недопустимо.

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

NSRange структура, дающая расположение и длину в получателе aString в aRange в получателе, по модулю опции в mask. Диапазон возвратился, относительно запуска строки, не к переданному - в диапазоне. Возвраты {NSNotFound, 0} если aString не найден или пуст (@"").

Обсуждение

Длина возвращенного диапазона и тот из aString если эквивалентные составленные последовательности символов являются соответствующими, может отличаться.

Специальные замечания

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    rangeOfString (_: options:range:locale:)
    - rangeOfString:options:range:locale:

Находит и возвращает диапазон первого возникновения данной строки в данном диапазоне получателя согласно данным опциям, с помощью указанной локали, если таковые имеются.

Объявление

Swift

func rangeOfString(_ aString: String, options mask: NSStringCompareOptions, range aRange: NSRange, locale locale: NSLocale?) -> NSRange

Objective C

- (NSRange)rangeOfString:(NSString *)aString options:(NSStringCompareOptions)mask range:(NSRange)aRange locale:(NSLocale *)locale

Параметры

`aString`	Строка, которую можно искать. Это значение не должно быть `nil`. Повышения `NSInvalidArgumentException` если `aString` `nil`.
`mask`	Маска, указывающая параметры поиска. Следующие опции могут быть указаны путем объединения их с C поразрядно `OR` оператор: `NSCaseInsensitiveSearch`, `NSLiteralSearch`, `NSBackwardsSearch`, и `NSAnchoredSearch`. См. Строковое Руководство по программированию для подробных данных об этих опциях.
`aRange`	Диапазон в получателе, для которого можно искать `aString`. Повышения `NSRangeException` если `aRange` недопустимо.
`locale`	Локаль для использования при сравнении получателя с `aString`. Использовать текущую локаль, передача [`NSLocalecurrentLocale`]. Использовать системную локаль, передачу `nil`. Параметр локали влияет на алгоритм проверки равенства. Например, для турецкой локали, нечувствительной к регистру, сравнивают соответствия «я» с «ı» (кодовая точка Unicode U+0131, латинский Маленький Dotless I), не нормальное, которое «я» изображаю.

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

Обсуждение

Специальные замечания

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    enumerateLinesUsingBlock (_:)
    - enumerateLinesUsingBlock:

Перечисляет все строки в строке.

Объявление

Swift

func enumerateLinesUsingBlock(_ block: (String!, UnsafeMutablePointer<ObjCBool>) -> Void)

Objective C

- (void)enumerateLinesUsingBlock:(void (^)(NSString *line, BOOL *stop))block

Параметры


      block

Блок выполнился для перечисления.

Блок берет два параметра:


      line

Текущая строка перечисляемой строки. Строка содержит просто содержание строки без разделителей строки. Посмотрите getLineStart:end:contentsEnd:forRange: для обсуждения разделителей строки.


      stop

Ссылка на булево значение, которое блок может использовать для остановки перечисления путем установки *stop = YES; это не должно затрагивать *stop иначе.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.


    
    enumerateSubstringsInRange (_: options:usingBlock:)
    - enumerateSubstringsInRange:options:usingBlock:

Перечисляет подстроки указанного типа в указанном диапазоне строки.

Объявление

Swift

func enumerateSubstringsInRange(_ range: NSRange, options opts: NSStringEnumerationOptions, usingBlock block: (String!, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

Objective C

- (void)enumerateSubstringsInRange:(NSRange)range options:(NSStringEnumerationOptions)opts usingBlock:(void (^)(NSString *substring, NSRange substringRange, NSRange enclosingRange, BOOL *stop))block

Параметры


      range

Диапазон в строке для перечисления подстрок.


      opts

Опции, указывающие типы подстрок и стилей перечисления.


      block

Блок выполнился для перечисления.

Блок берет четыре параметра:


      substring

Перечислимая строка.


      substringRange

Диапазон перечислимой строки в получателе.


      enclosingRange

Диапазон, включающий следующие подстроку, а также любой разделитель или символы заполнителя. Например, для строк, enclosingRange содержит разделители строки. enclosingRange для первой строки, перечисленной также, содержит любые символы, происходящие перед строкой. Последовательные диапазоны включения, как гарантируют, не наложатся, и каждый символ в перечислимом диапазоне включен в один и только один диапазон включения.


      stop

Обсуждение

Если этот метод отправляется в экземпляр NSMutableString, мутация (удаление, дополнение или изменение) позволяется, пока это в enclosingRange. После мутации перечисление сразу продолжает диапазон после обработанного диапазона, после того, как длина обработанного диапазона будет приведена в соответствие с мутацией. (Перечислитель предполагает, что любое изменение в длине происходит в указанном диапазоне.)

Например, если блок вызовут с диапазоном, запускающимся в расположении N, и блок удаляет все символы в предоставленном диапазоне, то следующий вызов также передаст N как индекс диапазона. Дело обстоит так, даже если бы мутация предыдущего диапазона изменяет строку таким способом, которым следующая подстрока расширилась бы для включения уже перечислимого диапазона. Например, если строка «Привет Мир» будет перечислен через слова и блочные изменения «Привет» в «Привет», таким образом формируя «HelloWorld», то следующее перечисление возвратит «Мир», а не «HelloWorld».

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.

Замена подстрок


    
    stringByReplacingOccurrencesOfString (_: withString:)
    - stringByReplacingOccurrencesOfString:withString:

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

Объявление

Swift

func stringByReplacingOccurrencesOfString(_ target: String, withString replacement: String) -> String

Objective C

- (NSString *)stringByReplacingOccurrencesOfString:(NSString *)target withString:(NSString *)replacement

Параметры

`target`	Строка для замены.
`replacement`	Строка, которой можно заменить `target`.

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

Новая строка та, в который все случаи target в получателе заменяются replacement.

Обсуждение

Вызывает stringByReplacingOccurrencesOfString:withString:options:range:с 0 опции и диапазон целой строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByReplacingOccurrencesOfString:withString:options:range:
– stringByReplacingCharactersInRange:withString:
– stringByReplacingPercentEscapesUsingEncoding:


    
    stringByReplacingOccurrencesOfString (_: withString:options:range:)
    - stringByReplacingOccurrencesOfString:withString:options:range:

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

Объявление

Swift

func stringByReplacingOccurrencesOfString(_ target: String, withString replacement: String, options options: NSStringCompareOptions, range searchRange: NSRange) -> String

Objective C

- (NSString *)stringByReplacingOccurrencesOfString:(NSString *)target withString:(NSString *)replacement options:(NSStringCompareOptions)options range:(NSRange)searchRange

Параметры

`target`	Строка для замены.
`replacement`	Строка, которой можно заменить `target`.
`options`	Маска опций использовать при сравнении `target` с получателем. Передача `0` не указать опции.
`searchRange`	Диапазон в получателе, в котором можно искать `target`.

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

Новая строка та, в который все случаи target, соответствующее использование options, в searchRange из получателя заменяются replacement.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByReplacingOccurrencesOfString:withString:
– stringByReplacingCharactersInRange:withString:
– stringByReplacingPercentEscapesUsingEncoding:


    
    stringByReplacingCharactersInRange (_: withString:)
    - stringByReplacingCharactersInRange:withString:

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

Объявление

Swift

func stringByReplacingCharactersInRange(_ range: NSRange, withString replacement: String) -> String

Objective C

- (NSString *)stringByReplacingCharactersInRange:(NSRange)range withString:(NSString *)replacement

Параметры

`range`	Диапазон символов в получателе.
`replacement`	Строка, которой можно заменить символы в `range`.

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

Новая строка та, в который символы в range из получателя заменяются replacement.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByReplacingOccurrencesOfString:withString:
– stringByReplacingOccurrencesOfString:withString:options:range:
– stringByReplacingPercentEscapesUsingEncoding:

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


    
    getLineStart (_: end:contentsEnd:forRange:)
    - getLineStart:end:contentsEnd:forRange:

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

Объявление

Swift

func getLineStart(_ startIndex: UnsafeMutablePointer<Int>, end lineEndIndex: UnsafeMutablePointer<Int>, contentsEnd contentsEndIndex: UnsafeMutablePointer<Int>, forRange aRange: NSRange)

Objective C

- (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 содержится с одной строкой, конечно, возвращенные индексы, все принадлежат той строке. Можно использовать результаты этого метода создать диапазоны для строк при помощи индекса запуска как расположение диапазона и различие между индексом конца и индексом запуска как длина диапазона.

Специальные замечания

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– lineRangeForRange:
– substringWithRange:


    
    lineRangeForRange (_:)
    - lineRangeForRange:

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

Объявление

Swift

func lineRangeForRange(_ aRange: NSRange) -> NSRange

Objective C

- (NSRange)lineRangeForRange:(NSRange)aRange

Параметры


      aRange

Диапазон в получателе. Значение не должно превышать границы получателя.

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

Диапазон символов, представляющих строку или строки, содержащие aRange, включая символы линейного окончания. Посмотрите getLineStart:end:contentsEnd:forRange: для обсуждения разделителей строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– paragraphRangeForRange:
– getLineStart:end:contentsEnd:forRange:
– substringWithRange:


    
    getParagraphStart (_: end:contentsEnd:forRange:)
    - getParagraphStart:end:contentsEnd:forRange:

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

Объявление

Swift

func getParagraphStart(_ startIndex: UnsafeMutablePointer<Int>, end endIndex: UnsafeMutablePointer<Int>, contentsEnd contentsEndIndex: UnsafeMutablePointer<Int>, forRange aRange: NSRange)

Objective C

- (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:, можно использовать результаты этого метода создать диапазоны для абзацев.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– paragraphRangeForRange:


    
    paragraphRangeForRange (_:)
    - paragraphRangeForRange:

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

Объявление

Swift

func paragraphRangeForRange(_ aRange: NSRange) -> NSRange

Objective C

- (NSRange)paragraphRangeForRange:(NSRange)aRange

Параметры


      aRange

Диапазон в получателе. Диапазон не должен превышать границы получателя.

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

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

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– getParagraphStart:end:contentsEnd:forRange:
– lineRangeForRange:

Определение составленных последовательностей символов


    
    rangeOfComposedCharacterSequenceAtIndex (_:)
    - rangeOfComposedCharacterSequenceAtIndex:

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

Объявление

Swift

func rangeOfComposedCharacterSequenceAtIndex(_ anIndex: Int) -> NSRange

Objective C

- (NSRange)rangeOfComposedCharacterSequenceAtIndex:(NSUInteger)anIndex

Параметры


      anIndex

Индекс символа в получателе. Значение не должно превышать границы получателя.

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

Диапазон в получателе составленной последовательности символов расположился в anIndex.

Обсуждение

Составленная последовательность символов включает символ первой базы, найденный в или прежде anIndex, и его длина включает основной символ и все неосновные символы после основного символа.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– rangeOfComposedCharacterSequencesForRange:


    
    rangeOfComposedCharacterSequencesForRange (_:)
    - rangeOfComposedCharacterSequencesForRange:

Возвращает диапазон в строке составленных последовательностей символов для данного диапазона.

Объявление

Swift

func rangeOfComposedCharacterSequencesForRange(_ range: NSRange) -> NSRange

Objective C

- (NSRange)rangeOfComposedCharacterSequencesForRange:(NSRange)range

Параметры


      range

Диапазон в получателе. Диапазон не должен превышать границы получателя.

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

Диапазон в получателе, включающем составленные последовательности символов в range.

Обсуждение

Этот метод обеспечивает удобный способ увеличить диапазон для включения всех составленных последовательностей символов, которые он перекрывает.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– rangeOfComposedCharacterSequenceAtIndex:

Преобразование строкового содержания в список свойств

propertyList () - propertyList

Анализирует получатель как текстовое представление списка свойств, возвращаясь NSString, NSData, NSArray, или NSDictionary объект, согласно самому верхнему элементу.

Объявление

Swift

func propertyList() -> AnyObject

Objective C

- (id)propertyList

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

Представление списка свойств возврата NSString, NSData, NSArray, или NSDictionary объект, согласно самому верхнему элементу.

Обсуждение

Получатель должен содержать строку в формате списка свойств. Для обсуждения форматов списка свойств см. Руководство по программированию Списка свойств.

Важный

Повышения NSParseErrorException если получатель не может быть проанализирован как список свойств.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– propertyListFromStringsFileFormat
+ stringWithContentsOfFile:
propertyListFromStringsFileFormat () - propertyListFromStringsFileFormat
Возвращает объект словаря, инициализированный с ключами, и оценивает найденный в получателе.

Объявление

Swift

func propertyListFromStringsFileFormat() -> [NSObject : AnyObject]?

Objective C

- (NSDictionary *)propertyListFromStringsFileFormat

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

Объект словаря, инициализированный с ключами и значениями, найден в получателе
Обсуждение

Получатель должен содержать текст в формате, используемом для .strings файлы. В этом формате ключи и значения разделяются знаком «равно», и каждая пара ключ/значение завершается с точкой с запятой. Если не существующий, знак «равно» также опущен, значение является дополнительным —. Ключи и сами значения всегда являются строками, включенными в прямые кавычки. Комментарии могут быть включены, разграничены /* и */ что касается ANSI C комментарии. Вот короткий пример строкового файла:
/* Question in confirmation panel for quitting. */

"Confirm Quit" = "Are you sure you want to quit?";

/* Message when user tries to close unsaved document */

"Close or Save" = "Save changes before closing?";

/* Word for Cancel */

"Cancel";
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– propertyList
+ stringWithContentsOfFile:

Идентификация и сравнение строк


    
    caseInsensitiveCompare (_:)
    - caseInsensitiveCompare:

Возвращает результат вызова compare:options: с NSCaseInsensitiveSearch как единственная опция.

Объявление

Swift

func caseInsensitiveCompare(_ aString: String) -> NSComparisonResult

Objective C

- (NSComparisonResult)caseInsensitiveCompare:(NSString *)aString

Параметры


      aString

Строка, с которой можно сравнить получатель.

Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

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

Результат вызова compare:options: с NSCaseInsensitiveSearch как единственная опция.

Обсуждение

При сравнении строк для представления конечному пользователю, необходимо обычно использовать localizedCaseInsensitiveCompare: вместо этого.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– localizedCaseInsensitiveCompare:
– compare:options:


    
    localizedCaseInsensitiveCompare (_:)
    - localizedCaseInsensitiveCompare:

Сравнивает строку с данной строкой с помощью нечувствительного к регистру, локализованного, сравнения.

Объявление

Swift

func localizedCaseInsensitiveCompare(_ aString: String) -> NSComparisonResult

Objective C

- (NSComparisonResult)localizedCaseInsensitiveCompare:(NSString *)aString

Параметры


      aString

Строка, с которой можно сравнить получатель.

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

Возвраты NSComparisonResult значение, указывающее лексическое упорядочивание. NSOrderedAscending получатель предшествует aString в лексическом упорядочивании, NSOrderedSame получатель и aString эквивалентны в лексическом значении, и NSOrderedDescending если следует получатель aString.

Обсуждение

Этот метод использует текущую локаль.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– compare:options:range:locale:


    
    выдержите сравнение (_:)
    - выдержите сравнение:

Возвращает результат вызова compare:options:range: без опций и полного объема получателя как диапазон.

Объявление

Swift

func compare(_ aString: String) -> NSComparisonResult

Objective C

- (NSComparisonResult)compare:(NSString *)aString

Параметры


      aString

Строка, с которой можно сравнить получатель.

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

Результат вызова compare:options:range: без опций и полного объема получателя как диапазон.

Обсуждение

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– localizedCompare:
– localizedCaseInsensitiveCompare:
– compare:options:
– caseInsensitiveCompare:
– isEqualToString:


    
    localizedCompare (_:)
    - localizedCompare:

Сравнивает строку и данную строку с помощью локализованного сравнения.

Объявление

Swift

func localizedCompare(_ aString: String) -> NSComparisonResult

Objective C

- (NSComparisonResult)localizedCompare:(NSString *)aString

Параметры


      aString

`aString`	Строка, с которой можно сравнить диапазон получателя, указанного `range`. Это значение не должно быть `nil`. Если это значение `nil`, поведение не определено и может измениться в будущих версиях OS X.
`mask`	Опции для поиска — можно объединить любое следующее использование оператора битового «ИЛИ» C: `NSCaseInsensitiveSearch`, `NSLiteralSearch`, `NSNumericSearch`. См. Строковое Руководство по программированию для подробных данных об этих опциях.
`range`	Диапазон получателя, по которому можно выполнить сравнение. Диапазон не должен превышать границы получателя. Важный Повышения `NSRangeException` если `range` превышает границы получателя.
`locale`	Экземпляр `NSLocale`. Использовать текущую локаль, передача [`NSLocale` `currentLocale`]. Например, при сравнении строк для представления конечному пользователю, используйте текущую локаль. Использовать системную локаль, передачу `nil`.

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

Возвраты NSComparisonResult значение, указывающее лексическое упорядочивание указанного диапазона в получателе и данной строке. NSOrderedAscending если подстрока получателя, данного range предшествует aString в лексическом упорядочивании для поданной локали dict, NSOrderedSame если подстрока получателя и aString эквивалентны в лексическом значении, и NSOrderedDescending если следует подстрока получателя aString.

Обсуждение

locale параметр влияет и на алгоритмы равенства и упорядочивания. Например, в некоторых локалях, символы с диакритикой сразу упорядочиваются после основы; другие локали упорядочивают их после «z».

Специальные замечания

До OS X v10.5, locale параметром был экземпляр NSDictionary. На OS X v10.5 и позже, если Вы передаете экземпляр NSDictionary текущая локаль используется вместо этого.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– localizedCompare:
– localizedCaseInsensitiveCompare:
– caseInsensitiveCompare:
– выдержите сравнение:
– compare:options:
– compare:options:range:
– isEqualToString:

localizedStandardCompare (_:) - localizedStandardCompare:

Сравнивает строки, как сортировано Средством поиска.

Объявление

Swift

func localizedStandardCompare(_ string: String) -> NSComparisonResult

Objective C

- (NSComparisonResult)localizedStandardCompare:(NSString *)string

Параметры

string

Строка для сравнения получателю.

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

Результат сравнения.

Обсуждение

Этот метод должен использоваться каждый раз, когда имена файлов или другие строки представлены в списках и таблицах, где подобная Средству поиска сортировка является надлежащей. Точное поведение сортировки этого метода отличается под различными локалями и может быть изменено в будущих выпусках. Этот метод использует текущую локаль.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.
hasPrefix (_:) - hasPrefix:

Возвращает булево значение, указывающее, соответствует ли данная строка начальные символы получателя.

Объявление

Swift

func hasPrefix(_ aString: String) -> Bool

Objective C

- (BOOL)hasPrefix:(NSString *)aString

Параметры

aString

Строка.

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

YEStrue если aString соответствует начальные символы получателя, иначе NOfalse. Возвраты NOfalse если aString пусто.

Обсуждение

Этот метод является удобством для сравнения строк с помощью NSAnchoredSearch опция. См. Строковое Руководство по программированию для получения дополнительной информации.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– hasSuffix:
– compare:options:range:
hasSuffix (_:) - hasSuffix:

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

Объявление

Swift

func hasSuffix(_ aString: String) -> Bool

Objective C

- (BOOL)hasSuffix:(NSString *)aString

Параметры

aString

Строка.

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

YEStrue если aString соответствует конечные символы получателя, иначе NOfalse. Возвраты NOfalse если aString пусто.

Обсуждение

Этот метод является удобством для сравнения строк с помощью NSAnchoredSearch и NSBackwardsSearch опции. См. Строковое Руководство по программированию для получения дополнительной информации.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– hasPrefix:
– compare:options:range:
isEqualToString (_:) - isEqualToString:

Возвращает булево значение, указывающее, равна ли данная строка получателю с помощью литерального основанного на Unicode сравнения.

Объявление

Swift

func isEqualToString(_ aString: String) -> Bool

Objective C

- (BOOL)isEqualToString:(NSString *)aString

Параметры

aString

Строка, с которой можно сравнить получатель.

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

YEStrue если aString эквивалентно получателю (если у них есть тот же ID или если они NSOrderedSame в литеральном сравнении), иначе NOfalse.

Обсуждение

Сравнение использует каноническое представление строк, которое для определенной строки является длиной строки плюс символы Unicode, составляющие строку. Когда этот метод сравнивает две строки, если частное лицо Уникоудс является тем же, то строки равны, независимо от запоминающего устройства. «Литерал», когда применился к сравнению строк, означает, что различные правила разложения Unicode не применяются, и символы Unicode индивидуально сравнены. Так, например, «Щ» представленный как составленная последовательность символов «O» и умляут не выдержал бы сравнение равный «Щ», представленному как один символ Unicode.

Специальные замечания

Когда Вы знаете, что оба объекта являются строками, этот метод является более быстрым способом проверить равенство, чем isEqual:.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– compare:options:range:
hash Свойство

Целое без знака, которое может использоваться в качестве адреса хэш-таблицы. (только для чтения)

Объявление

Swift

var hash: Int { get }

Objective C

@property(readonly) NSUInteger hash

Обсуждение

Если два строковых объекта равны (как определено isEqualToString: метод), у них должно быть то же значение хэш-функции. Это свойство выполняет это требование.

Вы не должны полагаться на это свойство, имеющее то же значение хэш-функции через выпуски OS X.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Сворачивание строк


    
    stringByFoldingWithOptions (_: локаль:)
    - stringByFoldingWithOptions:locale:

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

Объявление

Swift

func stringByFoldingWithOptions(_ options: NSStringCompareOptions, locale locale: NSLocale?) -> String

Objective C

- (NSString *)stringByFoldingWithOptions:(NSStringCompareOptions)options locale:(NSLocale *)locale

Параметры

`options`	Маска сравнивает флаги с суффиксом `InsensitiveSearch`.
`locale`	Локаль для использования для сворачивания. Использовать текущую локаль, передача [`NSLocalecurrentLocale`]. Использовать системную локаль, передачу `nil`.

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

Строка с опциями сворачивания символа применялась.

Обсуждение

Операции сворачивания символа удаляют различия между символами. Например, сворачивание случая может заменить прописные буквы их строчными эквивалентами.

Локаль влияет на складную логику. Например, для турецкой локали, нечувствительной к регистру, сравнивают соответствия «я» с «ı» (кодовая точка Unicode U+0131, латинский Маленький Dotless I), не нормальное, которое «я» изображаю.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Получение совместно используемого префикса


    
    commonPrefixWithString (_: опции:)
    - commonPrefixWithString:options:

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

Объявление

Swift

func commonPrefixWithString(_ aString: String, options mask: NSStringCompareOptions) -> String

Objective C

- (NSString *)commonPrefixWithString:(NSString *)aString options:(NSStringCompareOptions)mask

Параметры


      aString

Строка, с которой можно сравнить получатель.


      mask

Опции для сравнения. Следующие параметры поиска могут быть указаны путем объединения их с C поразрядно OR оператор: NSCaseInsensitiveSearch, NSLiteralSearch. См. Строковое Руководство по программированию для подробных данных об этих опциях.

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

Строка, содержащая, изображает получатель и aString имейте вместе, запускающийся с начала каждого до первых символов, которые не эквивалентны.

Обсуждение

Возвращаемая строка основывается на символах получателя. Например, если получатель является «Ma¨dchen» и aString «Mädchenschule», строка возвратилась, «Ma¨dchen», не «Mädchen».

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– hasPrefix:

Изменение случая

capitalizedString Свойство

Капитализированное представление получателя. (только для чтения)

Объявление

Swift

var capitalizedString: String { get }

Objective C

@property(readonly, copy) NSString *capitalizedString

Обсуждение

Строка с первым символом в каждом слове изменилась на его соответствующее прописное значение и весь набор оставшихся символов к их соответствующим строчным значениям.

«Слово» является любой последовательностью символов, разграниченных пробелами, вкладками или разделителями строки (перечисленный под getLineStart:end:contentsEnd:forRange:). Некоторую пунктуацию разграничивания общего слова не рассматривают, таким образом, это свойство может не обычно приводить к желаемым результатам для строк многословных.

Трансформации случая, как гарантируют, не будут симметричны или произведут строки тех же длин как оригиналы. Посмотрите lowercaseString для примера.

Примечание:

Это свойство выполняет каноническое (нелокализованное) отображение. Это подходит для операций программирования, требующих стабильных результатов не в зависимости от текущей локали. Для локализованного случая, отображающегося для строк, представленных пользователям, используйте capitalizedStringWithLocale: метод.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– capitalizedStringWithLocale:


    
    capitalizedStringWithLocale (_:)
    - capitalizedStringWithLocale:

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

Объявление

Swift

func capitalizedStringWithLocale(_ locale: NSLocale?) -> String

Objective C

- (NSString *)capitalizedStringWithLocale:(NSLocale *)locale

Параметры


      locale

Локаль. Для строк, представленных пользователям, передайте текущую локаль ([NSLocalecurrentLocale]). Использовать системную локаль, передачу nil.

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

Строка с первым символом от каждого слова в получателе изменилась на его соответствующее прописное значение и весь набор оставшихся символов к их соответствующим строчным значениям.

Обсуждение

«Слово» является любой последовательностью символов, разграниченных пробелами, вкладками или разделителями строки (перечисленный под getLineStart:end:contentsEnd:forRange:). Некоторую пунктуацию разграничивания общего слова не рассматривают, таким образом, этот метод может не обычно приводить к желаемым результатам для строк многословных.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 6.0 и позже.

См. также

– capitalizedString

lowercaseString Свойство
Строчное представление строки.

Объявление

Swift

var lowercaseString: String { get }

Objective C

@property(readonly, copy) NSString *lowercaseString
Обсуждение

Трансформации случая, как гарантируют, не будут симметричны или произведут строки тех же длин как оригиналы. Результат этого оператора:
lcString = [myString lowercaseString];
не могло бы быть равно этому оператору:
lcString = [[myString uppercaseString] lowercaseString];
Например, прописная форма «с» на немецком языке является «SS», таким образом преобразовывая «Straße» в верхний регистр, затем нижний регистр, производит эту последовательность строк:
- «Straße»
- «STRASSE»
- «strasse»
Примечание:

Это свойство выполняет каноническое (нелокализованное) отображение. Это подходит для операций программирования, требующих стабильных результатов не в зависимости от текущей локали. Для локализованного случая, отображающегося для строк, представленных пользователям, использовать lowercaseStringWithLocale:.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– lowercaseStringWithLocale:
uppercaseString
– uppercaseStringWithLocale:


    
    lowercaseStringWithLocale (_:)
    - lowercaseStringWithLocale:

Возвращает версию строки со всеми буквами, преобразованными в нижний регистр, принимая во внимание указанную локаль.

Объявление

Swift

func lowercaseStringWithLocale(_ locale: NSLocale?) -> String

Objective C

- (NSString *)lowercaseStringWithLocale:(NSLocale *)locale

Параметры


      locale

Локаль. Для строк, представленных пользователям, передайте текущую локаль ([NSLocalecurrentLocale]). Использовать локальную систему, передача nil.

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

Строчная строка с помощью locale. Ввод @"ABcde" привел бы к возврату @"abcde".

Обсуждение

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 6.0 и позже.

См. также

– lowercaseString
– uppercaseString
– uppercaseStringWithLocale:

uppercaseString Свойство

Прописное представление строки. (только для чтения)

Объявление

Swift

var uppercaseString: String { get }

Objective C

@property(readonly, copy) NSString *uppercaseString

Обсуждение

Трансформации случая, как гарантируют, не будут симметричны или произведут строки тех же длин как оригиналы. Посмотрите lowercaseString для примера.

Примечание:

Это свойство выполняет каноническое (нелокализованное) отображение. Это подходит для операций программирования, требующих стабильных результатов не в зависимости от текущей локали. Для локализованного случая, отображающегося для строк, представленных пользователям, используйте uppercaseStringWithLocale: метод.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

lowercaseString
– lowercaseStringWithLocale:
– uppercaseStringWithLocale:


    
    uppercaseStringWithLocale (_:)
    - uppercaseStringWithLocale:

Возвращает версию строки со всеми буквами, преобразованными в верхний регистр, принимая во внимание указанную локаль.

Объявление

Swift

func uppercaseStringWithLocale(_ locale: NSLocale?) -> String

Objective C

- (NSString *)uppercaseStringWithLocale:(NSLocale *)locale

Параметры


      locale

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

Прописная строка с помощью locale. Ввод @"ABcde" привел бы к возврату @"ABCDE".

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 6.0 и позже.

См. также

– uppercaseString
– lowercaseString
– lowercaseStringWithLocale:

Получение строк с отображением

decomposedStringWithCanonicalMapping Свойство

Строка, сделанная путем нормализации содержания строки с помощью Формы нормализации Unicode D. (только для чтения)

Объявление

Swift

var decomposedStringWithCanonicalMapping: String { get }

Objective C

@property(readonly, copy) NSString *decomposedStringWithCanonicalMapping

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

precomposedStringWithCanonicalMapping
decomposedStringWithCompatibilityMapping
decomposedStringWithCompatibilityMapping Свойство

Строка, сделанная путем нормализации содержания получателя с помощью Формы нормализации Unicode KD. (только для чтения)

Объявление

Swift

var decomposedStringWithCompatibilityMapping: String { get }

Objective C

@property(readonly, copy) NSString *decomposedStringWithCompatibilityMapping

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

precomposedStringWithCompatibilityMapping
decomposedStringWithCanonicalMapping
precomposedStringWithCanonicalMapping Свойство

Строка, сделанная путем нормализации содержания строки с помощью Формы нормализации Unicode C. (только для чтения)

Объявление

Swift

var precomposedStringWithCanonicalMapping: String { get }

Objective C

@property(readonly, copy) NSString *precomposedStringWithCanonicalMapping

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

precomposedStringWithCompatibilityMapping
decomposedStringWithCanonicalMapping
precomposedStringWithCompatibilityMapping Свойство

Строка, сделанная путем нормализации содержания получателя с помощью Формы нормализации Unicode KC. (только для чтения)

Объявление

Swift

var precomposedStringWithCompatibilityMapping: String { get }

Objective C

@property(readonly, copy) NSString *precomposedStringWithCompatibilityMapping

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

precomposedStringWithCanonicalMapping
decomposedStringWithCompatibilityMapping

Получение числовых значений

doubleValue Свойство

Значение с плавающей точкой строки как a double. (только для чтения)

Объявление

Swift

var doubleValue: Double { get }

Objective C

@property(readonly) double doubleValue

Обсуждение

Это свойство не включает пробела в начале строки. Это свойство HUGE_VAL или –HUGE_VAL на переполнении, 0.0 на потере значимости. Это свойство 0.0 если строка не начинается с допустимого текстового представления числа с плавающей точкой.

Это свойство использует информацию о форматировании, сохраненную в нелокализованном значении; используйте NSScanner объект для локализованного сканирования числовых значений от строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

floatValue
longLongValue
integerValue
scanDouble: (NSScanner)
floatValue Свойство

Значение с плавающей точкой строки как a float. (только для чтения)

Объявление

Swift

var floatValue: Float { get }

Objective C

@property(readonly) float floatValue

Обсуждение

Это свойство не включает пробел в начале строки. Это свойство HUGE_VAL или –HUGE_VAL на переполнении, 0.0 на потере значимости. Это свойство 0.0 если строка не начинается с допустимого текстового представления числа с плавающей точкой.

Этот метод использует информацию о форматировании, сохраненную в нелокализованном значении; используйте NSScanner объект для локализованного сканирования числовых значений от строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

doubleValue
longLongValue
integerValue
scanFloat: (NSScanner)
intValue Свойство

Целочисленное значение строки. (только для чтения)

Объявление

Swift

var intValue: Int32 { get }

Objective C

@property(readonly) int intValue

Обсуждение

Целочисленное значение строки, принимая десятичное представление и пропуская пробел в начале строки. Это свойство INT_MAX или INT_MIN на переполнении. Это свойство 0 если строка не начинается с допустимого десятичного текстового представления числа.

Это свойство использует информацию о форматировании, сохраненную в нелокализованном значении; используйте NSScanner объект для локализованного сканирования числовых значений от строки.

Специальные замечания

На OS X v10.5 и позже, использовать integerValue вместо этого.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

integerValue
doubleValue
floatValue
scanInt: (NSScanner)
integerValue Свойство

NSInteger значение строки. (только для чтения)

Объявление

Swift

var integerValue: Int { get }

Objective C

@property(readonly) NSInteger integerValue

Обсуждение

NSInteger значение строки, принимая десятичное представление и пропуская пробел в начале строки. Это свойство 0 если строка не начинается с допустимого десятичного текстового представления числа.

Это свойство использует информацию о форматировании, сохраненную в нелокализованном значении; используйте NSScanner объект для локализованного сканирования числовых значений от строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

doubleValue
floatValue
scanInt: (NSScanner)
longLongValue Свойство

long long значение строки. (только для чтения)

Объявление

Swift

var longLongValue: Int64 { get }

Objective C

@property(readonly) long long longLongValue

Обсуждение

long long значение строки, принимая десятичное представление и пропуская пробел в начале строки. Это свойство LLONG_MAX или LLONG_MIN на переполнении. Это свойство 0 если получатель не начинается с допустимого десятичного текстового представления числа.

Это свойство использует информацию о форматировании, сохраненную в нелокализованном значении; используйте NSScanner объект для локализованного сканирования числовых значений от строки.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

doubleValue
floatValue
scanInt: (NSScanner)
boolValue Свойство

Булево значение строки. (только для чтения)

Объявление

Swift

var boolValue: Bool { get }

Objective C

@property(readonly) BOOL boolValue

Обсуждение

Это свойство YEStrue при обнаружении с одним из «Y», «y», «T», «t», или цифра 1-9 — метод игнорирует любые конечные символы. Это свойство NOfalse если получатель не начинается с допустимого десятичного текстового представления числа.

Свойство принимает десятичное представление и пропускает пробел в начале строки. Это также пропускает начальные пробельные символы, или дополнительный - / +, знак, сопровождаемый, обнуляет.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

integerValue
scanInt: (NSScanner)

Работа с кодировками

availableStringEncodings () + availableStringEncodings
Возвращает завершенный нулем список строковой поддержки объектов кодировок в среде приложения.

Объявление

Swift

class func availableStringEncodings() -> UnsafePointer<UInt>

Objective C

+ (const NSStringEncoding *)availableStringEncodings

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

Завершенный нулем список кодировок представляет поддержку объектов в виде строки в среде приложения.
Обсуждение

Среди более обычно используемых кодировок:
- NSASCIIStringEncoding
- NSUnicodeStringEncoding
- NSISOLatin1StringEncoding
- NSISOLatin2StringEncoding
- NSSymbolStringEncoding
Посмотрите раздел Constants для большего списка и описаний многих поддерживаемых кодировок. В дополнение к тем кодировкам, перечисленным здесь, можно также использовать кодировки, определенные для CFString в Базовой Основе; просто необходимо вызвать CFStringConvertEncodingToNSStringEncoding функция для преобразования их в применимый формат.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ localizedNameOfStringEncoding:
defaultCStringEncoding () + defaultCStringEncoding

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

Объявление

Swift

class func defaultCStringEncoding() -> UInt

Objective C

+ (NSStringEncoding)defaultCStringEncoding

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

Кодирование струны до, принятое для любого метода, принимающего струну до как параметр.

Обсуждение

Этот метод возвращает кодирование пользовательского зависимого, кто оценивает, получен из языка пользователя по умолчанию и потенциально других факторов. Вы, возможно, иногда должны были бы использовать это кодирование при толковании пользовательских документов с неизвестными кодировками, в отсутствие других подсказок, но в целом это кодирование должно редко использоваться, если вообще. Обратите внимание на то, что некоторые потенциальные ценности могли бы привести к неожиданным преобразованиям кодирования даже довольно прямого NSString содержание — например, знаки препинания с двунаправленным кодированием.

Методы, принимающие струну до как использование параметра ...CString... в ключевых словах для таких параметров: например, stringWithCString:— отметьте, тем не менее, что они осуждаются. Кодирование струны до по умолчанию определяется от информации о системе и не может быть изменено программно для отдельного процесса. Посмотрите Строковые Кодировки для полного списка поддерживаемых кодировок.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
localizedNameOfStringEncoding (_:) + localizedNameOfStringEncoding:

Возвращает человекочитаемую строку, дающую имя данного кодирования.

Объявление

Swift

class func localizedNameOfStringEncoding(_ encoding: UInt) -> String

Objective C

+ (NSString *)localizedNameOfStringEncoding:(NSStringEncoding)encoding

Параметры

encoding

Строковое кодирование.

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

Человекочитаемая строка, дающая имя encoding в текущей локали.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
canBeConvertedToEncoding (_:) - canBeConvertedToEncoding:

Возвращает булево значение, указывающее, может ли получатель быть преобразован в данное кодирование без потери информации.

Объявление

Swift

func canBeConvertedToEncoding(_ encoding: UInt) -> Bool

Objective C

- (BOOL)canBeConvertedToEncoding:(NSStringEncoding)encoding

Параметры

encoding

Строковое кодирование.

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

YEStrue если получатель может быть преобразован в encoding без потери информации. Возвраты NOfalse если символы должны были бы быть изменены или удалены в процессе изменяющихся кодировок.

Обсуждение

Если Вы планируете фактически преобразовать строку, dataUsingEncoding:... возврат методов nil при отказе, таким образом, можно избежать издержек вызова этого метода сами путем простой попытки преобразовать строку.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– dataUsingEncoding:allowLossyConversion:
dataUsingEncoding (_:) - dataUsingEncoding:

Возвраты NSData объект, содержащий представление получателя, закодировал использование данного кодирования.

Объявление

Swift

func dataUsingEncoding(_ encoding: UInt) -> NSData?

Objective C

- (NSData *)dataUsingEncoding:(NSStringEncoding)encoding

Параметры

encoding

Строковое кодирование.

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

Результат вызова dataUsingEncoding:allowLossyConversion: с NOfalse как второй параметр (т.е. требуя преобразования без потерь).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    dataUsingEncoding (_: allowLossyConversion:)
    - dataUsingEncoding:allowLossyConversion:

Возвраты NSData объект, содержащий представление получателя, закодировал использование данного кодирования.

Объявление

Swift

func dataUsingEncoding(_ encoding: UInt, allowLossyConversion flag: Bool) -> NSData?

Objective C

- (NSData *)dataUsingEncoding:(NSStringEncoding)encoding allowLossyConversion:(BOOL)flag

Параметры

`encoding`	Строковое кодирование.
`flag`	Если `YEStrue`, тогда позволяет символам быть удаленными или измененными в преобразовании.

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

NSData объект, содержащий представление получателя, закодировал использование encoding. Возвраты nil если flag NOfalse и получатель не может быть преобразован, не теряя некоторую информацию (такую как диакритические знаки или случай).

Обсуждение

Если flag YEStrue и получатель не может быть преобразован, не теряя некоторую информацию, некоторые символы могут быть удалены или изменены в преобразовании. Например, в преобразовании символа от NSUnicodeStringEncoding к NSASCIIStringEncoding, символ '¦' становится, теряя диакритический знак.

Этот метод создает внешнее представление (с маркером порядка байтов, при необходимости, для указания порядка байтов), чтобы гарантировать что получающееся NSData объект может быть выписан к файлу безопасно. Результат этого метода, когда преобразование без потерь сделано, является форматом «простого текста» по умолчанию для кодирования и является рекомендуемым способом сохранить или передать строковый объект.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ availableStringEncodings
– canBeConvertedToEncoding:

description Свойство

Это NSString объект. (только для чтения)

Объявление

Swift

var description: String { get }

Objective C

@property(readonly, copy) NSString *description

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
fastestEncoding Свойство

Самое быстрое кодирование, в которое получатель может быть преобразован без потери информации. (только для чтения)

Объявление

Swift

var fastestEncoding: UInt { get }

Objective C

@property(readonly) NSStringEncoding fastestEncoding

Обсуждение

«Самый быстрый» применяется к извлечению символов от строки. Это кодирование может не быть эффективным пространством.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

smallestEncoding
– getCharacters:range:
smallestEncoding Свойство

Самое маленькое кодирование, в которое получатель может быть преобразован без потери информации. (только для чтения)

Объявление

Swift

var smallestEncoding: UInt { get }

Objective C

@property(readonly) NSStringEncoding smallestEncoding

Обсуждение

Это кодирование может не быть самым быстрым для доступа к символам, но является эффективным пространством. Это свойство может занять время к доступу.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– fastestEncoding
– getCharacters:range:

Работа с путями


    
    pathWithComponents (_:)
    + pathWithComponents:

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

Объявление

Swift

class func pathWithComponents(_ components: [AnyObject]) -> String

Objective C

+ (NSString *)pathWithComponents:(NSArray *)components

Параметры


      components

Массив NSString объекты, представляющие путь к файлу. Для создания абсолютного пути используйте метку наклонной черты (“/”) как первый компонент. Для включения запаздывающего делителя пути используйте пустую строку в качестве последнего компонента.

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

Строка, созданная из строк в components путем конкатенации их (в порядке они появляются в массиве) с разделителем пути между каждой парой.

Обсуждение

Этот метод не очищает создаваемый путь; использовать stringByStandardizingPath разрешить пустые компоненты, ссылки на родительский каталог, и т.д.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– pathComponents


    
    pathComponents

Свойство

Компоненты контура файловой системы получателя. (только для чтения)

Объявление

Swift

var pathComponents: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *pathComponents

Обсуждение

Строки в массиве появляются в порядке, который они сделали в получателе. Если строка начнется или закончится разделителем пути, то первый или последний компонент, соответственно, будет содержать разделитель. Удалены пустые компоненты (вызванный последовательными разделителями пути). Например, эта выборка кода:

      NSString *path = @"tmp/scratch";
NSArray *pathComponents = [path pathComponents];

производит массив с этим содержанием:


Индекс	Компонент контура
0	“`tmp`”
1	“`scratch`”

Если получатель начинается с наклонной черты — например, “/tmp/scratch” — массив имеет это содержание:


Индекс	Компонент контура
0	“`/`”
1	“`tmp`”
2	“`scratch`”

Если получатель не имеет никаких разделителей — например, “scratch” — массив содержит саму строку в этом случае “scratch”.

Обратите внимание на то, что этот метод только работает с путями к файлам — не, например, строковые представления URLs.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

+ pathWithComponents:
– stringByStandardizingPath
– componentsSeparatedByString:


    
    completePathIntoString (_: caseSensitive:matchesIntoArray:filterTypes:)
    - completePathIntoString:caseSensitive:matchesIntoArray:filterTypes:

Интерпретирует получатель как путь в файловой системе и пытается выполнить завершение имени файла, возвращая числовое значение, указывающее, было ли соответствие возможно, и ссылкой самый длинный путь, соответствующий получатель.

Объявление

Swift

func completePathIntoString(_ outputName: AutoreleasingUnsafeMutablePointer<NSString?>, caseSensitive flag: Bool, matchesIntoArray outputArray: AutoreleasingUnsafeMutablePointer<NSArray?>, filterTypes filterTypes: [AnyObject]?) -> Int

Objective C

- (NSUInteger)completePathIntoString:(NSString **)outputName caseSensitive:(BOOL)flag matchesIntoArray:(NSArray **)outputArray filterTypes:(NSArray *)filterTypes

Параметры

`outputName`	По возврату, содержит самый длинный путь, соответствующий получатель.
`flag`	Если `YEStrue`, метод рассматривает случай для возможных завершений.
`outputArray`	По возврату, содержит все имена файлов соответствия.
`filterTypes`	Массив `NSString` объекты, указывающие расширения пути для рассмотрения для завершения. Только пути, расширения которых (не включая дополнительный разделитель) соответствуют одну из этих строк, включены в `outputArray`. Передача `nil` если Вы не хотите фильтровать вывод.

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

0 если никакие соответствия не найдены и 1 если точно найдено одно соответствие. В случае многократных соответствий, возвращает фактическое число соответствия путей если outputArray предоставлен, или просто положительное значение если outputArray NULL.

Обсуждение

Можно проверить на существование соответствий, не получая путем передачи NULL как outputArray.

Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

fileSystemRepresentation Свойство

Специфичное для файловой системы представление получателя. (только для чтения)

Объявление

Swift

var fileSystemRepresentation: UnsafePointer<Int8> { get }

Objective C

@property(readonly) const char *fileSystemRepresentation

Обсуждение

Возвращенная струна до будет автоматически освобождена так же, как был бы выпущен возвращенный объект; Ваш код должен скопировать представление или использование getFileSystemRepresentation:maxLength: если это должно сохранить представление за пределами контекста памяти, в котором создавалось представление.

Повышения NSCharacterConversionException если получатель не может быть представлен в кодировании файловой системы. Если получатель не содержит символов, это также повышает исключение.

Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

Преобразовать a char * путь (такой как Вы могли бы добраться от библиотечной подпрограммы C) к NSString объект, используйте stringWithFileSystemRepresentation:length: метод на NSFileManager.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    getFileSystemRepresentation (_: maxLength:)
    - getFileSystemRepresentation:maxLength:

Интерпретирует получатель как системно-независимый путь и заполняет буфер струной до в формате и кодировании подходящего для использования с вызовами файловой системы.

Объявление

Swift

func getFileSystemRepresentation(_ buffer: UnsafeMutablePointer<Int8>, maxLength maxLength: Int) -> Bool

Objective C

- (BOOL)getFileSystemRepresentation:(char *)buffer maxLength:(NSUInteger)maxLength

Параметры

`buffer`	По возврату, содержит струну до, которые представляют получатель как как системно-независимый путь, плюс `NULL` байт завершения. Размер `buffer` должно быть достаточно большим для содержания `maxLength` байты.
`maxLength`	Максимальное количество байтов в строке для возврата в `buffer` (включая завершение `NULL` символ, который этот метод добавляет).

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

YEStrue если buffer успешно заполнено представлением файловой системы, иначе NOfalse (например, если maxLength был бы превышен или если получатель не может быть представлен в кодировании файловой системы).

Обсуждение

Этот метод работает путем замены абстрактного пути и дополнительных символов разделителя (‘/'и'.’соответственно) с их эквивалентами для операционной системы. Если специфичный для системы путь или дополнительный разделитель появляются в абстрактном представлении, символы, это преобразовывается для зависимости от системы (если они не идентичны абстрактным разделителям).

Следующий пример иллюстрирует использование maxLength параметр. Первый вызов метода возвращает отказ как представление файла строки (@"/mach_kernel") 12 байтов длиной, и значение передало как maxLength параметр (12) не допускает добавление a NULL байт завершения.

      char filenameBuffer[13];
BOOL success;
success = [@"/mach_kernel" getFileSystemRepresentation:filenameBuffer maxLength:12];
// success == NO
// Changing the length to include the NULL character does work
success = [@"/mach_kernel" getFileSystemRepresentation:filenameBuffer maxLength:13];
// success == YES


  

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– fileSystemRepresentation

absolutePath Свойство

Булево значение, указывающее, представляет ли получатель абсолютный путь. (только для чтения)

Объявление

Swift

var absolutePath: Bool { get }

Objective C

@property(getter=isAbsolutePath, readonly) BOOL absolutePath

Обсуждение

YEStrue если получатель (если интерпретируется как путь) представляет абсолютный путь, иначе NOfalse.

См. Строковое Руководство по программированию для получения дополнительной информации о путях.

Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs). Метод не проверяет файловую систему на существование пути (использование fileExistsAtPath: или похожие методы в NSFileManager для той задачи).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.0 и позже.


    
    lastPathComponent

Свойство

Последний компонент контура получателя. (только для чтения)

Объявление

Swift

var lastPathComponent: String { get }

Objective C

@property(readonly, copy) NSString *lastPathComponent

Обсуждение

Компоненты контура являются алфавитно-цифровыми строками, очерченными разделителем пути (наклонная черта «/») или начало или конец строки пути. Разделители разнообразного пути в конце строки разделяются.

Следующая таблица иллюстрирует эффект lastPathComponent на множестве различных путей:


Строковое значение получателя	Строка возвратилась
“`/tmp/scratch.tiff`”	“`scratch.tiff`”
“`/tmp/scratch`”	“`scratch`”
“`/tmp/`”	“`tmp`”
“`scratch///`”	“`scratch`”
“`/`”	“/”

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

pathComponents


    
    pathExtension

Свойство

Расширение пути, если таковые имеются, строки, столь же интерпретируемой как путь. (только для чтения)

Объявление

Swift

var pathExtension: String { get }

Objective C

@property(readonly, copy) NSString *pathExtension

Обсуждение

Расширение пути является частью последнего компонента контура, следующего за заключительным периодом, если существует тот. Дополнительный делитель не включен. Следующая таблица иллюстрирует эффект pathExtension на множестве различных путей:


Строковое значение получателя	Строка возвратилась
“`/tmp/scratch.tiff`”	“`tiff`”
“`.scratch.tiff`”	“`tiff`”
“`/tmp/scratch`”	“” (пустая строка)
“`/tmp/`”	“” (пустая строка)
“`/tmp/scratch..tiff`”	“`tiff`”

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

pathComponents
lastPathComponent

stringByAbbreviatingWithTildeInPath Свойство

Новая строка, заменяющая текущую часть корневого каталога текущего пути с тильдой (~) символ.

Объявление

Swift

var stringByAbbreviatingWithTildeInPath: String { get }

Objective C

@property(readonly, copy) NSString *stringByAbbreviatingWithTildeInPath

Обсуждение

Новая строка на основе текущего строкового объекта. Если новая строка указывает файл в текущем корневом каталоге, часть корневого каталога пути заменяется тильдой (~) символ. Если строка не указывает файл в текущем корневом каталоге, этот метод возвращает новый строковый объект, путь которого неизменен от пути в текущей строке.

Обратите внимание на то, что этот метод только работает с путями к файлам. Это не работает на строковые представления URLs.

Для поигравших в песочнице приложений в OS X текущий корневой каталог не является тем же как корневым каталогом пользователя. Для поигравшего в песочнице приложения корневой каталог является корневым каталогом приложения. Таким образом, если Вы указали путь /Users/<current_user>/file.txt для поигравшего в песочнице приложения возвращенный путь был бы неизменен из оригинала. Однако при указании того же пути для приложения не в песочнице этот метод заменил бы /Users/<current_user> часть пути с тильдой.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByExpandingTildeInPath


    
    stringByAppendingPathComponent (_:)
    - stringByAppendingPathComponent:

Возвращает новую строку, сделанную путем добавления к получателю данной строки.

Объявление

Swift

func stringByAppendingPathComponent(_ aString: String) -> String

Objective C

- (NSString *)stringByAppendingPathComponent:(NSString *)aString

Параметры


      aString

Компонент контура для добавления к получателю.

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

Новая строка сделана путем добавления aString к получателю, которому предшествуют при необходимости разделителем пути.

Обсуждение

Следующая таблица иллюстрирует эффект этого метода на множестве различных путей, предполагая это aString предоставляется как “scratch.tiff”:


Строковое значение получателя	Получившая строка
“`/tmp`”	“`/tmp/scratch.tiff`”
“`/tmp/`”	“`/tmp/scratch.tiff`”
“`/`”	“`/scratch.tiff`”
“” (пустая строка)	“`scratch.tiff`”

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringsByAppendingPaths:
– stringByAppendingPathExtension:
– stringByDeletingLastPathComponent


    
    stringByAppendingPathExtension (_:)
    - stringByAppendingPathExtension:

Возвращает новую строку, сделанную путем добавления к получателю дополнительного разделителя, сопровождаемого данным расширением.

Объявление

Swift

func stringByAppendingPathExtension(_ ext: String) -> String?

Objective C

- (NSString *)stringByAppendingPathExtension:(NSString *)ext

Параметры

ext

Расширение для добавления к получателю.

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

Новая строка, сделанная путем добавления к получателю дополнительного разделителя, сопровождаемого ext. Если бы получатель пуст, или получающийся путь был бы слишком длинным, возвраты nil.

Обсуждение

Следующая таблица иллюстрирует эффект этого метода на множестве различных путей, предполагая это ext предоставляется как @"tiff":


Строковое значение получателя	Получившая строка
“`/tmp/scratch.old`”	“`/tmp/scratch.old.tiff`”
“`/tmp/scratch.`”	“`/tmp/scratch..tiff`”
“`/tmp/`”	“`/tmp.tiff`”
“`scratch`”	“`scratch.tiff`”

Обратите внимание на то, что добавляя расширение @"/tmp/" вызывает результат быть @"/tmp.tiff" вместо @"/tmp/.tiff". Это различие - то, потому что файл назвал @".tiff" как полагают, не имеет расширение, таким образом, строка добавляется к последнему непустому компоненту контура.

Специальные замечания

До OS X v10.9 этот метод не позволял Вам добавлять расширения файла к именам файлов начиная с символа тильды (~).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByAppendingPathComponent:
– stringByDeletingPathExtension


    
    stringByDeletingLastPathComponent

Свойство

Новая строка, сделанная путем удаления последнего компонента контура из получателя, вместе с любым заключительным разделителем пути. (только для чтения)

Объявление

Swift

var stringByDeletingLastPathComponent: String { get }

Objective C

@property(readonly, copy) NSString *stringByDeletingLastPathComponent

Обсуждение

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

Следующая таблица иллюстрирует эффект этого метода на множестве различных путей:


Строковое значение получателя	Получившая строка
“`/tmp/scratch.tiff`”	“`/tmp`”
“`/tmp/lock/`”	“`/tmp`”
“`/tmp/`”	“`/`”
“`/tmp`”	“`/`”
“`/`”	“`/`”
“`scratch.tiff`”	“” (пустая строка)

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByDeletingPathExtension
– stringByAppendingPathComponent:


    
    stringByDeletingPathExtension

Свойство

Новая строка, сделанная путем удаления расширения (если таковые имеются, и только последнее) от получателя. (только для чтения)

Объявление

Swift

var stringByDeletingPathExtension: String { get }

Objective C

@property(readonly, copy) NSString *stringByDeletingPathExtension

Обсуждение

Новая строка, сделанная путем удаления расширения (если таковые имеются, и только последнее) от получателя. Полосы любой запаздывающий разделитель пути прежде, чем проверить на расширение. Если получатель представляет корневой путь, он возвращается неизменный.

Следующая таблица иллюстрирует эффект этого метода на множестве различных путей:


Строковое значение получателя	Получившая строка
“`/tmp/scratch.tiff`”	“`/tmp/scratch`”
“`/tmp/`”	“`/tmp`”
“`scratch.bundle/`”	“`scratch`”
“`scratch..tiff`”	“`scratch.`”
“`.tiff`”	“`.tiff`”
“`/`”	“`/`”

Обратите внимание на то, что пытаясь удалить расширение из @".tiff" вызывает результат быть @".tiff" вместо пустой строки. Это различие - то, потому что файл назвал @".tiff" как полагают, не имеет расширение, таким образом, ничто не удалено. Отметьте также, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– pathExtension
– stringByDeletingLastPathComponent

stringByExpandingTildeInPath Свойство

Новая строка, сделанная путем расширения начального компонента получателя к его значению полного пути. (только для чтения)

Объявление

Swift

var stringByExpandingTildeInPath: String { get }

Objective C

@property(readonly, copy) NSString *stringByExpandingTildeInPath

Обсуждение

Новая строка сделала путем расширения начального компонента получателя, если это начинается “~” или “~user”, к его значению полного пути. Если начальный компонент получателя не может быть расширен, возвращает новое сопоставление строк получатель.

Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByAbbreviatingWithTildeInPath
stringByResolvingSymlinksInPath Свойство

Новая строка, сделанная из получателя путем разрешения всех символьных ссылок и стандартизации пути. (только для чтения)

Объявление

Swift

var stringByResolvingSymlinksInPath: String { get }

Objective C

@property(readonly, copy) NSString *stringByResolvingSymlinksInPath

Обсуждение

Новая строка, сделанная путем расширения начального выражения тильды в получателе, затем разрешения всех символьных ссылок и ссылок на текущие или родительские каталоги, если это возможно, для генерации стандартизированного пути. Если первоначальный тракт будет абсолютным, то все символьные ссылки, как гарантируют, будут удалены; если это - относительный путь, символьные ссылки, которые не могут быть разрешены, оставляют неразрешенными в возвращаемой строке. Возвраты self если происходит ошибка.

Если имя пути получения начинается /private, stringByResolvingSymlinksInPath метод снимает изоляцию /private указатель, если результатом является имя существующего файла.

Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByStandardizingPath
– stringByExpandingTildeInPath
stringByStandardizingPath Свойство
Новая строка сделана путем удаления посторонних компонентов контура из получателя. (только для чтения)

Объявление

Swift

var stringByStandardizingPath: String { get }

Objective C

@property(readonly, copy) NSString *stringByStandardizingPath
Обсуждение

Если недопустимый путь предоставлен, stringByStandardizingPath может попытаться разрешить его путем вызова stringByResolvingSymlinksInPath, и результаты не определены. Если с каким-либо другим видом ошибки встречаются (такие как компонент контура, не существующий), self возвращается.

Этот метод может внести следующие изменения в предоставленной строке:
- Разверните начальное использование выражения тильды stringByExpandingTildeInPath.
- Сократите пустые компоненты и ссылки на текущий каталог (т.е. последовательности «//» и “/. /”) к единственным разделителям пути.
- В абсолютных путях только, разрешите ссылки на родительский каталог (т.е. компонент «..») к реальному родительскому каталогу, если возможное использование stringByResolvingSymlinksInPath, который консультируется с файловой системой для разрешения каждой потенциальной символьной ссылки.
  
  В относительных путях, потому что символьные ссылки не могут быть разрешены, ссылки на родительский каталог оставляют на месте.
- Удалите начальный компонент “/private” от пути, если результат все еще указывает существующий файл или каталог (проверенный консалтинг файловая система).
Обратите внимание на то, что путь, возвращенный этим методом, может все еще иметь компоненты символьной ссылки в нем. Отметьте также, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByExpandingTildeInPath
– stringByResolvingSymlinksInPath
stringsByAppendingPaths (_:) - stringsByAppendingPaths:

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

Объявление

Swift

func stringsByAppendingPaths(_ paths: [AnyObject]) -> [AnyObject]

Objective C

- (NSArray *)stringsByAppendingPaths:(NSArray *)paths

Параметры

paths

Массив NSString объекты, указывающие пути для добавления к получателю.

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

Массив NSString объекты, сделанные путем отдельного добавления каждой строки в paths к получателю, которому предшествуют при необходимости разделителем пути.

Обсуждение

Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs). Посмотрите stringByAppendingPathComponent: для отдельного примера.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Работа с URLs


    
    stringByAddingPercentEscapesUsingEncoding (_:)
    - stringByAddingPercentEscapesUsingEncoding:

Возвращает представление получателя с помощью данного кодирования, чтобы решить, что процент выходит необходимый для преобразования получателя в юридическую строку URL.

Объявление

Swift

func stringByAddingPercentEscapesUsingEncoding(_ encoding: UInt) -> String?

Objective C

- (NSString *)stringByAddingPercentEscapesUsingEncoding:(NSStringEncoding)encoding

Параметры


      encoding

Кодирование для использования для возвращаемой строки. Если Вы не уверены из корректного кодирования, необходимо использовать NSUTF8StringEncoding.

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

Представление использования получателя encoding определить процент выходит необходимый для преобразования получателя в юридическую строку URL. Возвраты nil если encoding не может закодировать определенный символ.

Обсуждение

Может быть трудно использовать эту функцию для «очищения» незавершенных или частично завершенных строк URL, где последовательности непредсказуемы. Посмотрите CFURLCreateStringByAddingPercentEscapes для получения дополнительной информации.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByAddingPercentEncodingWithAllowedCharacters:
– stringByReplacingPercentEscapesUsingEncoding:
– stringByRemovingPercentEncoding

stringByReplacingPercentEscapesUsingEncoding (_:) - stringByReplacingPercentEscapesUsingEncoding:

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

Объявление

Swift

func stringByReplacingPercentEscapesUsingEncoding(_ encoding: UInt) -> String?

Objective C

- (NSString *)stringByReplacingPercentEscapesUsingEncoding:(NSStringEncoding)encoding

Параметры

encoding

Кодирование для использования для возвращаемой строки.

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

Новая строка, сделанная путем замены в получателе всего процента, выходит с соответствующими символами, как определено данным кодированием encoding. Возвраты nil если трансформация не возможна, например, Escape процента дают последовательность байта, не законную в encoding.

Обсуждение

Посмотрите CFURLCreateStringByReplacingPercentEscapes для более сложных трансформаций.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– stringByAddingPercentEncodingWithAllowedCharacters:
– stringByAddingPercentEscapesUsingEncoding:
– stringByRemovingPercentEncoding
stringByAddingPercentEncodingWithAllowedCharacters (_:) - stringByAddingPercentEncodingWithAllowedCharacters:

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

Объявление

Swift

func stringByAddingPercentEncodingWithAllowedCharacters(_ allowedCharacters: NSCharacterSet) -> String?

Objective C

- (NSString *)stringByAddingPercentEncodingWithAllowedCharacters:(NSCharacterSet *)allowedCharacters

Параметры

allowedCharacters

Символы, не замененные в строке.

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

Если трансформация не возможна, возвращает закодированную строку или ноль.

Обсуждение

Кодирование UTF-8 используется, чтобы решить, что корректный процент закодировал символы. Все строки URL не могут быть закодированы процентом.

Этот метод предназначается к проценту - кодируют компонент URL или строку субкомпонента, НЕ всю строку URL. Любые символы в allowedCharacters за пределами 7-разрядного ASCII диапазон проигнорированы.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 7.0 и позже.

См. также

– stringByAddingPercentEscapesUsingEncoding:
– stringByReplacingPercentEscapesUsingEncoding:
– stringByRemovingPercentEncoding
- stringByRemovingPercentEncoding

Возвращается новая строка, сделанная из получателя путем замены всего процента, закодировала последовательности с соответствующими символами UTF-8.

Объявление

Swift

var stringByRemovingPercentEncoding: String? { get }

Objective C

@property(readonly, copy) NSString *stringByRemovingPercentEncoding

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

Новая строка с процентом закодировала удаленные последовательности.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 7.0 и позже.

См. также

– stringByAddingPercentEncodingWithAllowedCharacters:
– stringByAddingPercentEscapesUsingEncoding:
– stringByReplacingPercentEscapesUsingEncoding:

Лингвистическое тегирование и анализ


    
    enumerateLinguisticTagsInRange (_: scheme:options:orthography:usingBlock:)
    - enumerateLinguisticTagsInRange:scheme:options:orthography:usingBlock:

Выполняет лингвистический анализ на указанной строке путем перечисления определенного диапазона строки, обеспечения Блока расположенными тегами.

Объявление

Swift

func enumerateLinguisticTagsInRange(_ range: NSRange, scheme tagScheme: String, options opts: NSLinguisticTaggerOptions, orthography orthography: NSOrthography?, usingBlock block: (String!, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

Objective C

- (void)enumerateLinguisticTagsInRange:(NSRange)range scheme:(NSString *)tagScheme options:(NSLinguisticTaggerOptions)opts orthography:(NSOrthography *)orthography usingBlock:(void (^)(NSString *tag, NSRange tokenRange, NSRange sentenceRange, BOOL *stop))block

Параметры


      range

Диапазон строки для анализа.


      tagScheme

Схема тега использовать. Посмотрите Linguistic Tag Schemes для поддерживаемых значений.


      opts

Лингвистические опции теггера использовать. Посмотрите NSLinguisticTaggerOptionsдля констант. Эти константы могут быть объединены с помощью оператора C-битового-«ИЛИ».


      orthography

Орфография строки. Если ноль, лингвистический теггер попытается определить орфографию от строкового содержания.


      block

Блок для применения к строке.

Блок берет четыре параметра:

`tag`	Схема тега маркера. Выбирает, параметр указывает типы расположенных опций теггера.
`tokenRange`	Диапазон сопоставления строк схема тега.
`sentenceRange`	Диапазон предложения, в котором найден маркер.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. `stop` параметром является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Обсуждение

Это - удобный метод. Это - эквивалент создания экземпляра NSLinguisticTagger, указание получателя как строка, которая будет проанализирована, и орфография (или ноль) и затем вызов NSLinguisticTagger метод или enumerateTagsInRange:scheme:options:usingBlock:.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 5.0 и позже.


    
    linguisticTagsInRange (_: scheme:options:orthography:tokenRanges:)
    - linguisticTagsInRange:scheme:options:orthography:tokenRanges:

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

Объявление

Swift

func linguisticTagsInRange(_ range: NSRange, scheme tagScheme: String, options opts: NSLinguisticTaggerOptions, orthography orthography: NSOrthography?, tokenRanges tokenRanges: AutoreleasingUnsafeMutablePointer<NSArray?>) -> [AnyObject]

Objective C

- (NSArray *)linguisticTagsInRange:(NSRange)range scheme:(NSString *)tagScheme options:(NSLinguisticTaggerOptions)opts orthography:(NSOrthography *)orthography tokenRanges:(NSArray **)tokenRanges

Параметры

`range`	Диапазон строки для анализа.
`tagScheme`	Схема тега использовать. Посмотрите `Linguistic Tag Schemes` для поддерживаемых значений.
`opts`	Лингвистические опции теггера использовать. Посмотрите `NSLinguisticTaggerOptions` для констант. Эти константы могут быть объединены с помощью оператора C-битового-«ИЛИ».
`orthography`	Орфография строки. Если `nil`, лингвистический теггер попытается определить орфографию от строкового содержания.
`tokenRanges`	Массив возвратился ссылкой содержащий маркерные диапазоны лингвистических тегов, обернутых в `NSValue` объекты.

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

Возвращает массив, содержащий лингвистические теги для tokenRanges в строке получения.

Обсуждение

Это - удобный метод. Это - эквивалент создания экземпляра NSLinguisticTagger, указание получателя как строка, которая будет проанализирована, и орфография (или nil) и затем вызов NSLinguisticTagger метод или linguisticTagsInRange:scheme:options:orthography:tokenRanges:.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 5.0 и позже.

Типы данных

unichar

Введите для символов Unicode.

Объявление

Swift

typealias unichar = UInt16

Objective C

typedef unsigned short unichar;

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
NSStringCompareOptions

Введите для опций сравнения строк.

Объявление

Swift

struct NSStringCompareOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var CaseInsensitiveSearch: NSStringCompareOptions { get } static var LiteralSearch: NSStringCompareOptions { get } static var BackwardsSearch: NSStringCompareOptions { get } static var AnchoredSearch: NSStringCompareOptions { get } static var NumericSearch: NSStringCompareOptions { get } static var DiacriticInsensitiveSearch: NSStringCompareOptions { get } static var WidthInsensitiveSearch: NSStringCompareOptions { get } static var ForcedOrderingSearch: NSStringCompareOptions { get } static var RegularExpressionSearch: NSStringCompareOptions { get } }

Objective C

typedef NSUInteger NSStringCompareOptions;

Обсуждение

Посмотрите Опции Поиска и Сравнения для возможных значений.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
NSStringEncodingConversionOptions

Введите для кодирования опций преобразования.

Объявление

Swift

struct NSStringEncodingConversionOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var AllowLossy: NSStringEncodingConversionOptions { get } static var ExternalRepresentation: NSStringEncodingConversionOptions { get } }

Objective C

typedef NSUInteger NSStringEncodingConversionOptions;

Обсуждение

Посмотрите “Encoding Conversion Options” для возможных значений.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.
NSStringEncoding

Введите для строкового кодирования.

Объявление

Objective C

typedef NSUInteger NSStringEncoding;

Обсуждение

Посмотрите Строковые Кодировки для возможных значений.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

Константы

NSMaximumStringLength
Константа для определения максимального количества символов в NSString объект.

Эта константа не доступна в OS X v10.5 и позже.

Объявление

Objective C

#define NSMaximumStringLength (INT_MAX-1)

Константы
- NSMaximumStringLength
  
  Максимальное количество символов в NSString объект.
  
  Доступный в iOS 5.0 и позже.
Поиск и опции сравнения
Эти значения представляют опции, доступные многим методам поиска строковых классов и методам сравнения.

Объявление

Swift

struct NSStringCompareOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var CaseInsensitiveSearch: NSStringCompareOptions { get } static var LiteralSearch: NSStringCompareOptions { get } static var BackwardsSearch: NSStringCompareOptions { get } static var AnchoredSearch: NSStringCompareOptions { get } static var NumericSearch: NSStringCompareOptions { get } static var DiacriticInsensitiveSearch: NSStringCompareOptions { get } static var WidthInsensitiveSearch: NSStringCompareOptions { get } static var ForcedOrderingSearch: NSStringCompareOptions { get } static var RegularExpressionSearch: NSStringCompareOptions { get } }

Objective C

enum { NSCaseInsensitiveSearch = 1, NSLiteralSearch = 2, NSBackwardsSearch = 4, NSAnchoredSearch = 8, NSNumericSearch = 64, NSDiacriticInsensitiveSearch = 128, NSWidthInsensitiveSearch = 256, NSForcedOrderingSearch = 512, NSRegularExpressionSearch = 1024 };

Константы
- CaseInsensitiveSearch
  
  NSCaseInsensitiveSearch
  
  Поиск без учета регистра.
  
  Доступный в iOS 2.0 и позже.
- LiteralSearch
  
  NSLiteralSearch
  
  Точная познаковая эквивалентность.
  
  Доступный в iOS 2.0 и позже.
- BackwardsSearch
  
  NSBackwardsSearch
  
  Поиск от конца исходной строки.
  
  Доступный в iOS 2.0 и позже.
- AnchoredSearch
  
  NSAnchoredSearch
  
  Поиск ограничивается для запуска (или конец, если NSBackwardsSearch) из исходной строки.
  
  Доступный в iOS 2.0 и позже.
- NumericSearch
  
  NSNumericSearch
  
  Числа в строках сравнены с помощью числового значения, т.е. Name2.txt < Name7.txt < Name25.txt.
  
  Числовое сравнение только применяется к цифрам в строке, не другим символам, которые имели бы значение в истинном числе, таком как знак минус или десятичная точка.
  
  Эта опция только применяется для сравнения методов, не находят.
  
  Доступный в iOS 2.0 и позже.
- DiacriticInsensitiveSearch
  
  NSDiacriticInsensitiveSearch
  
  Поиск игнорирует диакритические знаки.
  
  Например, ‘ö’ равен ‘o’.
  
  Доступный в iOS 2.0 и позже.
- WidthInsensitiveSearch
  
  NSWidthInsensitiveSearch
  
  Поиск игнорирует различия в ширине в символах, имеющих полноширинный и формы полуширины, как это происходит в восточноазиатских наборах символов.
  
  Например, с этой опцией, полноширинная латинская строчная буква (кодовая точка Unicode U+FF41) равна основной латинской строчной букве (кодовая точка Unicode U+0061).
  
  Доступный в iOS 2.0 и позже.
- ForcedOrderingSearch
  
  NSForcedOrderingSearch
  
  Сравнения вынуждены возвратиться также NSOrderedAscending или NSOrderedDescending если строки эквивалентны, но не строго равны.
  
  Эта опция гарантирует надежные, восстанавливаемые результаты при сортировке. Например, «aaa» больше, чем "AAA” если NSCaseInsensitiveSearch указан.
  
  Доступный в iOS 2.0 и позже.
- RegularExpressionSearch
  
  NSRegularExpressionSearch
  
  Строка поиска обрабатывается как совместимое с ICU регулярное выражение. Если установлено, никакие другие опции не могут применяться кроме NSCaseInsensitiveSearch и NSAnchoredSearch. Можно использовать эту опцию только с rangeOfString:... методы и stringByReplacingOccurrencesOfString:withString:options:range:.
  
  Доступный в iOS 3.2 и позже.
Обсуждение

Посмотрите Поиск, Сравнение и Сортировку Строк для подробных данных об эффектах этих опций.
Кодирование опций преобразования
Опции для преобразования строковых кодировок.

Объявление

Swift

struct NSStringEncodingConversionOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var AllowLossy: NSStringEncodingConversionOptions { get } static var ExternalRepresentation: NSStringEncodingConversionOptions { get } }

Objective C

enum { NSStringEncodingConversionAllowLossy = 1, NSStringEncodingConversionExternalRepresentation = 2 };

Константы
- AllowLossy
  
  NSStringEncodingConversionAllowLossy
  
  Позволяет преобразование с потерями.
  
  Доступный в iOS 2.0 и позже.
- ExternalRepresentation
  
  NSStringEncodingConversionExternalRepresentation
  
  Указывает внешнее представление (с меткой порядка байтов, при необходимости, для указания порядка байтов).
  
  Доступный в iOS 2.0 и позже.
NSString обработка имен исключения
Эти константы определяют имена исключений, повышенных если NSString не может представлять строку в данном кодировании или проанализировать строку как список свойств.

Объявление

Swift

let NSCharacterConversionException: String let NSParseErrorException: String

Objective C

extern NSString *NSParseErrorException; extern NSString *NSCharacterConversionException;

Константы
- NSCharacterConversionException
  
  NSString повышения NSCharacterConversionException если строка не может быть представлена в строковом кодировании или файловой системе.
  
  Доступный в iOS 2.0 и позже.
- NSParseErrorException
  
  NSString повышения NSParseErrorException если строка не может быть проанализирована как список свойств.
  
  Доступный в iOS 2.0 и позже.
Строковые кодировки
Следующими константами предоставлены NSString как возможные строковые кодировки.

Объявление

Swift

var NSProprietaryStringEncoding: Int { get }

Objective C

enum { NSASCIIStringEncoding = 1, NSNEXTSTEPStringEncoding = 2, NSJapaneseEUCStringEncoding = 3, NSUTF8StringEncoding = 4, NSISOLatin1StringEncoding = 5, NSSymbolStringEncoding = 6, NSNonLossyASCIIStringEncoding = 7, NSShiftJISStringEncoding = 8, NSISOLatin2StringEncoding = 9, NSUnicodeStringEncoding = 10, NSWindowsCP1251StringEncoding = 11, NSWindowsCP1252StringEncoding = 12, NSWindowsCP1253StringEncoding = 13, NSWindowsCP1254StringEncoding = 14, NSWindowsCP1250StringEncoding = 15, NSISO2022JPStringEncoding = 21, NSMacOSRomanStringEncoding = 30, NSUTF16StringEncoding = NSUnicodeStringEncoding, NSUTF16BigEndianStringEncoding = 0x90000100, NSUTF16LittleEndianStringEncoding = 0x94000100, NSUTF32StringEncoding = 0x8c000100, NSUTF32BigEndianStringEncoding = 0x98000100, NSUTF32LittleEndianStringEncoding = 0x9c000100, NSProprietaryStringEncoding = 65536 };

Константы
- NSASCIIStringEncoding
  
  Строгое 7-разрядное кодирование ASCII в 8-разрядных символах; ASCII оценивает 0 … 127 только.
  
  Доступный в iOS 2.0 и позже.
- NSNEXTSTEPStringEncoding
  
  8-разрядное кодирование ASCII с расширениями NEXTSTEP.
  
  Доступный в iOS 2.0 и позже.
- NSJapaneseEUCStringEncoding
  
  8-разрядный EUC, кодирующий для японского текста.
  
  Доступный в iOS 2.0 и позже.
- NSUTF8StringEncoding
  
  8-разрядное представление символов Unicode, подходящих для передачи или хранения основанными на ASCII системами.
  
  Доступный в iOS 2.0 и позже.
- NSISOLatin1StringEncoding
  
  8-разрядная латынь ISO 1 кодирование.
  
  Доступный в iOS 2.0 и позже.
- NSSymbolStringEncoding
  
  8-разрядный Adobe Symbol, кодирующий вектор.
  
  Доступный в iOS 2.0 и позже.
- NSNonLossyASCIIStringEncoding
  
  7-разрядный многословный ASCII для представления всех символов Unicode.
  
  Доступный в iOS 2.0 и позже.
- NSShiftJISStringEncoding
  
  8-разрядное кодирование Shift-JIS для японского текста.
  
  Доступный в iOS 2.0 и позже.
- NSISOLatin2StringEncoding
  
  8-разрядная латынь ISO 2 кодирования.
  
  Доступный в iOS 2.0 и позже.
- NSUnicodeStringEncoding
  
  Каноническое кодирование Unicode для строковых объектов.
  
  Доступный в iOS 2.0 и позже.
- NSWindowsCP1251StringEncoding
  
  Кодовая страница Microsoft Windows 1251, кодируя символы кириллицы; эквивалентный кодированию шрифта AdobeStandardCyrillic.
  
  Доступный в iOS 2.0 и позже.
- NSWindowsCP1252StringEncoding
  
  Кодовая страница Microsoft Windows 1252; эквивалентный WinLatin1.
  
  Доступный в iOS 2.0 и позже.
- NSWindowsCP1253StringEncoding
  
  Кодовая страница Microsoft Windows 1253, кодируя греческие символы.
  
  Доступный в iOS 2.0 и позже.
- NSWindowsCP1254StringEncoding
  
  Кодовая страница Microsoft Windows 1254, кодируя турецкие символы.
  
  Доступный в iOS 2.0 и позже.
- NSWindowsCP1250StringEncoding
  
  Кодовая страница Microsoft Windows 1250; эквивалентный WinLatin2.
  
  Доступный в iOS 2.0 и позже.
- NSISO2022JPStringEncoding
  
  Японец ISO 2022, кодирующий для электронной почты.
  
  Доступный в iOS 2.0 и позже.
- NSMacOSRomanStringEncoding
  
  Классика Макинтош Роман, кодирующий.
  
  Доступный в iOS 2.0 и позже.
- NSUTF16StringEncoding
  
  Псевдоним для NSUnicodeStringEncoding.
  
  Доступный в iOS 2.0 и позже.
- NSUTF16BigEndianStringEncoding
  
  NSUTF16StringEncoding кодирование с явным указанным порядком байтов.
  
  Доступный в iOS 2.0 и позже.
- NSUTF16LittleEndianStringEncoding
  
  NSUTF16StringEncoding кодирование с явным указанным порядком байтов.
  
  Доступный в iOS 2.0 и позже.
- NSUTF32StringEncoding
  
  32-разрядное кодирование UTF.
  
  Доступный в iOS 2.0 и позже.
- NSUTF32BigEndianStringEncoding
  
  NSUTF32StringEncoding кодирование с явным указанным порядком байтов.
  
  Доступный в iOS 2.0 и позже.
- NSUTF32LittleEndianStringEncoding
  
  NSUTF32StringEncoding кодирование с явным указанным порядком байтов.
  
  Доступный в iOS 2.0 и позже.
- NSProprietaryStringEncoding
  
  Специфичное для установки кодирование.
  Это кодирование было осуждено — нет никакой замены.
  
  Собственные кодировки не использовались начиная с OS X v10.0. Необходимо указать стандарт, кодирующий вместо этого.
  
  Доступный в iOS 5.0 и позже.
Обсуждение

Эти значения представляют различные кодировки символов, поддерживаемые NSString классы. Это - неполный список. Дополнительные кодировки определяются в Строковом Руководстве по программированию для Базовой Основы (см. CFStringEncodingExt.h); эти кодировки могут использоваться с NSString первой передачей Базового кодирования Основы к CFStringConvertEncodingToNSStringEncoding функция.
Строковые опции перечисления
Константы для указания видов подстрок и стилей перечисления.

Объявление

Swift

struct NSStringEnumerationOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var ByLines: NSStringEnumerationOptions { get } static var ByParagraphs: NSStringEnumerationOptions { get } static var ByComposedCharacterSequences: NSStringEnumerationOptions { get } static var ByWords: NSStringEnumerationOptions { get } static var BySentences: NSStringEnumerationOptions { get } static var Reverse: NSStringEnumerationOptions { get } static var SubstringNotRequired: NSStringEnumerationOptions { get } static var Localized: NSStringEnumerationOptions { get } }

Objective C

typedef NSUInteger NSStringEnumerationOptions; enum { NSStringEnumerationByLines = 0, NSStringEnumerationByParagraphs = 1, NSStringEnumerationByComposedCharacterSequences = 2, NSStringEnumerationByWords = 3, NSStringEnumerationBySentences = 4, NSStringEnumerationReverse = 1UL << 8, NSStringEnumerationSubstringNotRequired = 1UL << 9, NSStringEnumerationLocalized = 1UL << 10 };

Константы
- ByLines
  
  NSStringEnumerationByLines
  
  Перечисляет строками. Эквивалентный lineRangeForRange:.
  
  Доступный в iOS 4.0 и позже.
- ByParagraphs
  
  NSStringEnumerationByParagraphs
  
  Перечисляет абзацами. Эквивалентный paragraphRangeForRange:.
  
  Доступный в iOS 4.0 и позже.
- ByComposedCharacterSequences
  
  NSStringEnumerationByComposedCharacterSequences
  
  Перечисляет составленными последовательностями символов. Эквивалентный rangeOfComposedCharacterSequencesForRange:.
  
  Доступный в iOS 4.0 и позже.
- ByWords
  
  NSStringEnumerationByWords
  
  Перечисляет словами.
  
  Доступный в iOS 4.0 и позже.
- BySentences
  
  NSStringEnumerationBySentences
  
  Перечисляет предложениями.
  
  Доступный в iOS 4.0 и позже.
- Reverse
  
  NSStringEnumerationReverse
  
  Перечисление причин для появления от конца указанного диапазона к запуску.
  
  Доступный в iOS 4.0 и позже.
- SubstringNotRequired
  
  NSStringEnumerationSubstringNotRequired
  
  Способ указать, что блоку не нужна подстрока, когда будет передан ноль. Это - просто ярлык производительности.
  
  Доступный в iOS 4.0 и позже.
- Localized
  
  NSStringEnumerationLocalized
  
  Заставляет перечисление происходить с помощью текущей локали. Это не имеет значения в строке, абзаце, или составленном перечислении последовательности символов, но этом май для слов или предложений.
  
  Доступный в iOS 4.0 и позже.
Обсуждение

Эти опции используются с enumerateSubstringsInRange:options:usingBlock: метод. Передача в одной NSStringEnumerationBy... опция и объединение с любым остающимся перечислением разрабатывают константы с помощью C поразрядно OR оператор.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.