Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы основы ссылка класса NSString

Опции
Развертывание Target:

На этой странице
Язык:

NSString

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 в собственном порядке байтов.

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

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

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

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

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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


Доступный в OS X v10.0 и позже.
  • Возвращает пустую строку.

    Объявление

    Objective C

    + (instancetype)string

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – init

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

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

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + строка

  • Возвращает инициализированный 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

    Доступность

    Доступный в OS X v10.3 и позже.

  • Возвращает инициализированный 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 это не будет.

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

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

  • Возвращает инициализированный 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.

    length

    Число символов для использования от characters.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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. Возвращенный объект может отличаться от исходного получателя.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    convenience init(string aString: String)

    Objective C

    - (instancetype)initWithString:(NSString *)aString

    Параметры

    aString

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + stringWithString:

  • Возвраты 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

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + stringWithUTF8String:

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

    Объявление

    Objective C

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

    Параметры

    format

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

    ...

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    format

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

    argList

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    + stringWithFormat:

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

    Объявление

    Objective C

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

    Параметры

    format

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

    locale

    NSLocale объект, указывающий локаль для использования. Использовать текущую локаль, передача [NSLocalecurrentLocale]. Использовать системную локаль, передачу nil.

    Для устаревшей поддержки это может быть экземпляром NSDictionary содержа информацию о локали.

    ...

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвраты 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.

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Objective C

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

    Параметры

    format

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

    ...

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Objective C

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

    Параметры

    format

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

    Повышения 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;

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Objective C

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

    Параметры

    chars

    Массив C символов Unicode; значение не должно быть NULL.

    length

    Число символов для использования от chars.

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Objective C

    + (instancetype)stringWithString:(NSString *)aString

    Параметры

    aString

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

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – initWithString:

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

    Объявление

    Objective C

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

    Параметры

    cString

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

    enc

    Кодирование cString.

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.4 и позже.

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

    Объявление

    Objective C

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

    Параметры

    bytes

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

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – initWithString:

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

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

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

    Объявление

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

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

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

    Объявление

    Objective C

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

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

    Использовать 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Инициализирует получатель, недавно выделенный 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Инициализирует получатель, недавно выделенный 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

    Объявление

    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;

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.4 и позже.

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

    Объявление

    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;

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.4 и позже.

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

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

    Использовать 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Инициализирует получатель, недавно выделенный 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Возвращает строку, создаваемую путем чтения данных из данного 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;

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвращает строку, создаваемую путем чтения данных из данного 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;

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвращает строку, создаваемую путем чтения данных из файла, названного данным 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Инициализирует получатель, недавно выделенный 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.4 и позже.

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

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

    Использовать 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Пишет содержание получателя к 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 или с кодированием).

    Обсуждение

    Этот метод хранит указанное кодирование файлом в расширенном атрибуте под именем 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

    Доступность

    Доступный в OS X v10.4 и позже.

  • Пишет содержание получателя к расположению, указанному данным 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • длина длина Свойство

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

    Объявление

    Swift

    var length: Int { get }

    Objective C

    @property(readonly) NSUInteger length

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

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

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.4 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.4 и позже.

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

    Объявление

    Swift

    func characterAtIndex(_ index: Int) -> unichar

    Objective C

    - (unichar)characterAtIndex:(NSUInteger)index

    Параметры

    index

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – getCharacters:range:

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

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

    Этот метод небезопасен, потому что он мог потенциально вызвать переполнение буфера. Использовать 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

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

    См. также

    – длина

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

    Объявление

    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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.5 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.4 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.4 и позже.

  • UTF8String UTF8String Свойство

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

    Объявление

    Swift

    var UTF8String: UnsafePointer<Int8> { get }

    Objective C

    @property(readonly) const char *UTF8String

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • cString - cString (OS X v10.4)

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

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

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

    Объявление

    Objective C

    - (const char *)cString

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

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

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

    Объявление

    Objective C

    - (const char *)lossyCString

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

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

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

    Объявление

    Objective C

    - (NSUInteger)cStringLength

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • getCString: - getCString: (OS X v10.4)

    Вызывает 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

  • Вызывает 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

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

    Используйте 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;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.4.

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

    Объявление

    Objective C

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

    Параметры

    format

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

    ...

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

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.2 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    separator

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.2 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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.

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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}.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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 если эквивалентные составленные последовательности символов являются соответствующими, может отличаться.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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), не нормальное, которое «я» изображаю.

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.6 и позже.

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

    Объявление

    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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

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

    Объявление

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    – paragraphRangeForRange:

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

    Объявление

    Swift

    func paragraphRangeForRange(_ aRange: NSRange) -> NSRange

    Objective C

    - (NSRange)paragraphRangeForRange:(NSRange)aRange

    Параметры

    aRange

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.3 и позже.

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

    Объявление

    Swift

    func rangeOfComposedCharacterSequenceAtIndex(_ anIndex: Int) -> NSRange

    Objective C

    - (NSRange)rangeOfComposedCharacterSequenceAtIndex:(NSUInteger)anIndex

    Параметры

    anIndex

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func rangeOfComposedCharacterSequencesForRange(_ range: NSRange) -> NSRange

    Objective C

    - (NSRange)rangeOfComposedCharacterSequencesForRange:(NSRange)range

    Параметры

    range

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

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

    Объявление

    Swift

    func propertyList() -> AnyObject

    Objective C

    - (id)propertyList

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает результат вызова 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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func localizedCaseInsensitiveCompare(_ aString: String) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)localizedCaseInsensitiveCompare:(NSString *)aString

    Параметры

    aString

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

    Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

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

    Возвраты NSComparisonResult значение, указывающее лексическое упорядочивание. NSOrderedAscending получатель предшествует aString в лексическом упорядочивании, NSOrderedSame получатель и aString эквивалентны в лексическом значении, и NSOrderedDescending если следует получатель aString.

    Обсуждение

    Этот метод использует текущую локаль.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает результат вызова compare:options:range: без опций и полного объема получателя как диапазон.

    Объявление

    Swift

    func compare(_ aString: String) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)compare:(NSString *)aString

    Параметры

    aString

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

    Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

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

    Результат вызова compare:options:range: без опций и полного объема получателя как диапазон.

    Обсуждение

    При сравнении строк для представления конечному пользователю, необходимо обычно использовать localizedCompare: или localizedCaseInsensitiveCompare: вместо этого.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func localizedCompare(_ aString: String) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)localizedCompare:(NSString *)aString

    Параметры

    aString

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

    Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

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

    Возвраты NSComparisonResult. NSOrderedAscending получатель предшествует string в лексическом упорядочивании, NSOrderedSame получатель и string эквивалентны в лексическом значении, и NSOrderedDescending если следует получатель string.

    Обсуждение

    Этот метод использует текущую локаль.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func compare(_ aString: String, options mask: NSStringCompareOptions) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)compare:(NSString *)aString options:(NSStringCompareOptions)mask

    Параметры

    aString

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

    Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

    mask

    Опции для поиска — можно объединить любое следующее использование оператора битового «ИЛИ» C: NSCaseInsensitiveSearch, NSLiteralSearch, NSNumericSearch. См. Строковое Руководство по программированию для подробных данных об этих опциях.

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

    Результат вызова compare:options:range: с данной маской как опции и полный объем получателя как диапазон.

    Обсуждение

    При сравнении строк для представления конечному пользователю, необходимо обычно использовать localizedCompare: или localizedCaseInsensitiveCompare: вместо этого, или использование compare:options:range:locale: и передайте локаль пользователя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает результат вызова compare:options:range:locale: с a nil локаль.

    Объявление

    Swift

    func compare(_ aString: String, options mask: NSStringCompareOptions, range range: NSRange) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)compare:(NSString *)aString options:(NSStringCompareOptions)mask range:(NSRange)range

    Параметры

    aString

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

    Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

    mask

    Опции для поиска — можно объединить любое следующее использование оператора битового «ИЛИ» C: NSCaseInsensitiveSearch, NSLiteralSearch, NSNumericSearch.

    См. Строковое Руководство по программированию для подробных данных об этих опциях.

    range

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

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

    Результат вызова compare:options:range:locale: с a nil локаль.

    Обсуждение

    При сравнении строк для представления конечному пользователю, использовать compare:options:range:locale: вместо этого и передача текущая локаль.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func compare(_ aString: String, options mask: NSStringCompareOptions, range range: NSRange, locale locale: AnyObject?) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)compare:(NSString *)aString options:(NSStringCompareOptions)mask range:(NSRange)range locale:(id)locale

    Параметры

    aString

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

    Это значение не должно быть nil. Если это значение nil, поведение не определено и может измениться в будущих версиях OS X.

    mask

    Опции для поиска — можно объединить любое следующее использование оператора битового «ИЛИ» C: NSCaseInsensitiveSearch, NSLiteralSearch, NSNumericSearch.

    См. Строковое Руководство по программированию для подробных данных об этих опциях.

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Сравнивает строки, как сортировано Средством поиска.

    Объявление

    Swift

    func localizedStandardCompare(_ string: String) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)localizedStandardCompare:(NSString *)string

    Параметры

    string

    Строка для сравнения получателю.

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

    Результат сравнения.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает булево значение, указывающее, равна ли данная строка получателю с помощью литерального основанного на 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

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – compare:options:range:

  • хеш хеш Свойство

    Целое без знака, которое может использоваться в качестве адреса хэш-таблицы. (только для чтения)

    Объявление

    Swift

    var hash: Int { get }

    Objective C

    @property(readonly) NSUInteger hash

    Обсуждение

    Если два строковых объекта равны (как определено isEqualToString: метод), у них должно быть то же значение хэш-функции. Это свойство выполняет это требование.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.5 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – hasPrefix:

  • Капитализированное представление получателя. (только для чтения)

    Объявление

    Swift

    var capitalizedString: String { get }

    Objective C

    @property(readonly, copy) NSString *capitalizedString

    Обсуждение

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

    «Слово» является любой последовательностью символов, разграниченных пробелами, вкладками или разделителями строки (перечисленный под getLineStart:end:contentsEnd:forRange:). Некоторую пунктуацию разграничивания общего слова не рассматривают, таким образом, это свойство может не обычно приводить к желаемым результатам для строк многословных.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.8 и позже.

    См. также

    – capitalizedString

  • lowercaseString 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»

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.8 и позже.

  • uppercaseString uppercaseString Свойство

    Прописное представление строки. (только для чтения)

    Объявление

    Swift

    var uppercaseString: String { get }

    Objective C

    @property(readonly, copy) NSString *uppercaseString

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func uppercaseStringWithLocale(_ locale: NSLocale?) -> String

    Objective C

    - (NSString *)uppercaseStringWithLocale:(NSLocale *)locale

    Параметры

    locale

    Локаль. Для строк, представленных пользователям, передайте текущую локаль ([NSLocalecurrentLocale]). Использовать системную локаль, передачу nil.

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

    Прописная строка с помощью locale. Ввод @"ABcde" привел бы к возврату @"ABCDE".

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.8 и позже.

  • doubleValue 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

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    floatValue
    longLongValue
    integerValue
    scanDouble: (NSScanner)

  • floatValue 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

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    doubleValue
    longLongValue
    integerValue
    scanFloat: (NSScanner)

  • intValue 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

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    integerValue
    doubleValue
    floatValue
    scanInt: (NSScanner)

  • integerValue integerValue Свойство

    NSInteger значение строки. (только для чтения)

    Объявление

    Swift

    var integerValue: Int { get }

    Objective C

    @property(readonly) NSInteger integerValue

    Обсуждение

    NSInteger значение строки, принимая десятичное представление и пропуская пробел в начале строки. Это свойство 0 если строка не начинается с допустимого десятичного текстового представления числа.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    doubleValue
    floatValue
    scanInt: (NSScanner)

  • longLongValue 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

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    doubleValue
    floatValue
    scanInt: (NSScanner)

  • boolValue 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

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    integerValue
    scanInt: (NSScanner)

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    class func defaultCStringEncoding() -> UInt

    Objective C

    + (NSStringEncoding)defaultCStringEncoding

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

    Кодирование струны до, принятое для любого метода, принимающего струну до как параметр.

    Обсуждение

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

    Методы, принимающие струну до как использование параметра ...CString... в ключевых словах для таких параметров: например, stringWithCString:— отметьте, тем не менее, что они осуждаются. Кодирование струны до по умолчанию определяется от информации о системе и не может быть изменено программно для отдельного процесса. Посмотрите Строковые Кодировки для полного списка поддерживаемых кодировок.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    class func localizedNameOfStringEncoding(_ encoding: UInt) -> String

    Objective C

    + (NSString *)localizedNameOfStringEncoding:(NSStringEncoding)encoding

    Параметры

    encoding

    Строковое кодирование.

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

    Человекочитаемая строка, дающая имя encoding в текущей локали.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    func dataUsingEncoding(_ encoding: UInt) -> NSData?

    Objective C

    - (NSData *)dataUsingEncoding:(NSStringEncoding)encoding

    Параметры

    encoding

    Строковое кодирование.

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

    Результат вызова dataUsingEncoding:allowLossyConversion: с NOfalse как второй параметр (т.е. требуя преобразования без потерь).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвраты 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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Это NSString объект. (только для чтения)

    Объявление

    Swift

    var description: String { get }

    Objective C

    @property(readonly, copy) NSString *description

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • fastestEncoding fastestEncoding Свойство

    Самое быстрое кодирование, в которое получатель может быть преобразован без потери информации. (только для чтения)

    Объявление

    Swift

    var fastestEncoding: UInt { get }

    Objective C

    @property(readonly) NSStringEncoding fastestEncoding

    Обсуждение

    «Самый быстрый» применяется к извлечению символов от строки. Это кодирование может не быть эффективным пространством.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Самое маленькое кодирование, в которое получатель может быть преобразован без потери информации. (только для чтения)

    Объявление

    Swift

    var smallestEncoding: UInt { get }

    Objective C

    @property(readonly) NSStringEncoding smallestEncoding

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    Swift

    class func pathWithComponents(_ components: [AnyObject]) -> String

    Objective C

    + (NSString *)pathWithComponents:(NSArray *)components

    Параметры

    components

    Массив NSString объекты, представляющие путь к файлу. Для создания абсолютного пути используйте метку наклонной черты (“/”) как первый компонент. Для включения запаздывающего делителя пути используйте пустую строку в качестве последнего компонента.

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

    Строка, созданная из строк в components путем конкатенации их (в порядке они появляются в массиве) с разделителем пути между каждой парой.

    Обсуждение

    Этот метод не очищает создаваемый путь; использовать stringByStandardizingPath разрешить пустые компоненты, ссылки на родительский каталог, и т.д.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – pathComponents

  • 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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Специфичное для файловой системы представление получателя. (только для чтения)

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Интерпретирует получатель как системно-независимый путь и заполняет буфер струной до в формате и кодировании подходящего для использования с вызовами файловой системы.

    Объявление

    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 был бы превышен или если получатель не может быть представлен в кодировании файловой системы).

    Обсуждение

    Этот метод работает путем замены абстрактного пути и дополнительных символов разделителя (‘/'и'.’соответственно) с их эквивалентами для операционной системы. Если специфичный для системы путь или дополнительный разделитель появляются в абстрактном представлении, символы, это преобразовывается для зависимости от системы (если они не идентичны абстрактным разделителям).

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

    Следующий пример иллюстрирует использование 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

    Доступность

    Доступный в OS X v10.0 и позже.

  • absolutePath 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

    Доступность

    Доступный в OS X v10.10 и позже.

  • Последний компонент контура получателя. (только для чтения)

    Объявление

    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

    /

    “/”

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    pathComponents

  • pathExtension 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

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Новая строка, заменяющая текущую часть корневого каталога текущего пути с тильдой (~) символ.

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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" как полагают, не имеет расширение, таким образом, строка добавляется к последнему непустому компоненту контура.

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    До OS X v10.9 этот метод не позволял Вам добавлять расширения файла к именам файлов начиная с символа тильды (~).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Новая строка, сделанная путем удаления последнего компонента контура из получателя, вместе с любым заключительным разделителем пути. (только для чтения)

    Объявление

    Swift

    var stringByDeletingLastPathComponent: String { get }

    Objective C

    @property(readonly, copy) NSString *stringByDeletingLastPathComponent

    Обсуждение

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

    Следующая таблица иллюстрирует эффект этого метода на множестве различных путей:

    Строковое значение получателя

    Получившая строка

    /tmp/scratch.tiff

    /tmp

    /tmp/lock/

    /tmp

    /tmp/

    /

    /tmp

    /

    /

    /

    scratch.tiff

    “” (пустая строка)

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Новая строка, сделанная путем удаления расширения (если таковые имеются, и только последнее) от получателя. (только для чтения)

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Новая строка, сделанная путем расширения начального компонента получателя к его значению полного пути. (только для чтения)

    Объявление

    Swift

    var stringByExpandingTildeInPath: String { get }

    Objective C

    @property(readonly, copy) NSString *stringByExpandingTildeInPath

    Обсуждение

    Новая строка сделала путем расширения начального компонента получателя, если это начинается “~” или “~user”, к его значению полного пути. Если начальный компонент получателя не может быть расширен, возвращает новое сопоставление строк получатель.

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Новая строка, сделанная из получателя путем разрешения всех символьных ссылок и стандартизации пути. (только для чтения)

    Объявление

    Swift

    var stringByResolvingSymlinksInPath: String { get }

    Objective C

    @property(readonly, copy) NSString *stringByResolvingSymlinksInPath

    Обсуждение

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

    Если имя пути получения начинается /private, stringByResolvingSymlinksInPath метод снимает изоляцию /private указатель, если результатом является имя существующего файла.

    Обратите внимание на то, что этот метод только работает с путями к файлам (не, например, строковые представления URLs).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • Новая строка сделана путем удаления посторонних компонентов контура из получателя. (только для чтения)

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.0 и позже.

  • Возвращает представление получателя с помощью данного кодирования, чтобы решить, что процент выходит необходимый для преобразования получателя в юридическую строку 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

    Доступность

    Доступный в OS X v10.3 и позже.

  • Возвращает новую строку, сделанную путем замены в получателе всех 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

    Доступность

    Доступный в OS X v10.3 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.9 и позже.

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

    Объявление

    Swift

    var stringByRemovingPercentEncoding: String? { get }

    Objective C

    @property(readonly, copy) NSString *stringByRemovingPercentEncoding

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

    Новая строка с процентом закодировала удаленные последовательности.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    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

    Доступность

    Доступный в OS X v10.7 и позже.

Типы данных

  • Введите для символов Unicode.

    Объявление

    Swift

    typealias unichar = UInt16

    Objective C

    typedef unsigned short unichar;

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.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

    typedef NSUInteger NSStringCompareOptions;

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

  • Введите для кодирования опций преобразования.

    Объявление

    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

    Доступность

    Доступный в OS X v10.5 и позже.

  • Введите для строкового кодирования.

    Объявление

    Objective C

    typedef NSUInteger NSStringEncoding;

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

  • Константа для определения максимального количества символов в NSString объект.

    Эта константа не доступна в OS X v10.5 и позже.

    Объявление

    Objective C

    #define NSMaximumStringLength (INT_MAX-1)

    Константы

    • NSMaximumStringLength

      NSMaximumStringLength

      Максимальное количество символов в NSString объект.

      Доступный в OS X v10.0 и позже.

    Доступность

    Доступный в OS X v10.0.

    Удаленный в OS X v10.5.

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

    Объявление

    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

      Поиск без учета регистра.

      Доступный в OS X v10.0 и позже.

    • LiteralSearch

      NSLiteralSearch

      Точная познаковая эквивалентность.

      Доступный в OS X v10.0 и позже.

    • BackwardsSearch

      NSBackwardsSearch

      Поиск от конца исходной строки.

      Доступный в OS X v10.0 и позже.

    • AnchoredSearch

      NSAnchoredSearch

      Поиск ограничивается для запуска (или конец, если NSBackwardsSearch) из исходной строки.

      Доступный в OS X v10.0 и позже.

    • NumericSearch

      NSNumericSearch

      Числа в строках сравнены с помощью числового значения, т.е. Name2.txt < Name7.txt < Name25.txt.

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

      Эта опция только применяется для сравнения методов, не находят.

      Доступный в OS X v10.3 и позже.

    • DiacriticInsensitiveSearch

      NSDiacriticInsensitiveSearch

      Поиск игнорирует диакритические знаки.

      Например, ‘ö’ равен ‘o’.

      Доступный в OS X v10.5 и позже.

    • WidthInsensitiveSearch

      NSWidthInsensitiveSearch

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

      Например, с этой опцией, полноширинная латинская строчная буква (кодовая точка Unicode U+FF41) равна основной латинской строчной букве (кодовая точка Unicode U+0061).

      Доступный в OS X v10.5 и позже.

    • ForcedOrderingSearch

      NSForcedOrderingSearch

      Сравнения вынуждены возвратиться также NSOrderedAscending или NSOrderedDescending если строки эквивалентны, но не строго равны.

      Эта опция гарантирует надежные, восстанавливаемые результаты при сортировке. Например, «aaa» больше, чем "AAA” если NSCaseInsensitiveSearch указан.

      Доступный в OS X v10.5 и позже.

    • RegularExpressionSearch

      NSRegularExpressionSearch

      Строка поиска обрабатывается как совместимое с ICU регулярное выражение. Если установлено, никакие другие опции не могут применяться кроме NSCaseInsensitiveSearch и NSAnchoredSearch. Можно использовать эту опцию только с rangeOfString:... методы и stringByReplacingOccurrencesOfString:withString:options:range:.

      Доступный в OS X v10.7 и позже.

    Обсуждение

    Посмотрите Поиск, Сравнение и Сортировку Строк для подробных данных об эффектах этих опций.

  • Опции для преобразования строковых кодировок.

    Объявление

    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

      Позволяет преобразование с потерями.

      Доступный в OS X v10.5 и позже.

    • ExternalRepresentation

      NSStringEncodingConversionExternalRepresentation

      Указывает внешнее представление (с меткой порядка байтов, при необходимости, для указания порядка байтов).

      Доступный в OS X v10.5 и позже.

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

    Объявление

    Swift

    let NSCharacterConversionException: NSString! let NSParseErrorException: NSString!

    Objective C

    extern NSString *NSParseErrorException; extern NSString *NSCharacterConversionException;

    Константы

    • NSCharacterConversionException

      NSCharacterConversionException

      NSString повышения NSCharacterConversionException если строка не может быть представлена в строковом кодировании или файловой системе.

      Доступный в OS X v10.0 и позже.

    • NSParseErrorException

      NSParseErrorException

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

      Доступный в OS X v10.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

      NSASCIIStringEncoding

      Строгое 7-разрядное кодирование ASCII в 8-разрядных символах; ASCII оценивает 0 … 127 только.

      Доступный в OS X v10.0 и позже.

    • NSNEXTSTEPStringEncoding

      NSNEXTSTEPStringEncoding

      8-разрядное кодирование ASCII с расширениями NEXTSTEP.

      Доступный в OS X v10.0 и позже.

    • NSJapaneseEUCStringEncoding

      NSJapaneseEUCStringEncoding

      8-разрядный EUC, кодирующий для японского текста.

      Доступный в OS X v10.0 и позже.

    • NSUTF8StringEncoding

      NSUTF8StringEncoding

      8-разрядное представление символов Unicode, подходящих для передачи или хранения основанными на ASCII системами.

      Доступный в OS X v10.0 и позже.

    • NSISOLatin1StringEncoding

      NSISOLatin1StringEncoding

      8-разрядная латынь ISO 1 кодирование.

      Доступный в OS X v10.0 и позже.

    • NSSymbolStringEncoding

      NSSymbolStringEncoding

      8-разрядный Adobe Symbol, кодирующий вектор.

      Доступный в OS X v10.0 и позже.

    • NSNonLossyASCIIStringEncoding