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

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

Разработчик

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

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

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

NSCharacterSet

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

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

NSCharacterSet класс объявляет программируемый интерфейс для объекта, управляющего рядом символов Unicode (см. NSString спецификация кластера класса для получения информации о Unicode). NSCharacterSetосновной примитивный метод, characterIsMember:, обеспечивает основание для всех других методов экземпляра в его интерфейсе. Подкласс NSCharacterSet потребности только для реализации этого метода, плюс mutableCopyWithZone:, для правильного поведения. Для оптимальной производительности подкласс должен также переопределить bitmapRepresentation, который иначе работает путем вызова characterIsMember: для каждого возможного значения Unicode.

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

Непостоянный подкласс NSCharacterSet NSMutableCharacterSet.

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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


Доступный в OS X v10.0 и позже.
  • Возвращает набор символов, содержащий символы в Буквах категорий, Знаках и Числах.

    Объявление

    Swift

    class func alphanumericCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)alphanumericCharacterSet

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

    Набор символов, содержащий символы в Буквах категорий, Знаках и Числах.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func capitalizedLetterCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)capitalizedLetterCharacterSet

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

    Набор символов, содержащий символы в категории Букв Titlecase.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает набор символов, содержащий символы в категориях Символов Управления или Формата.

    Объявление

    Swift

    class func controlCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)controlCharacterSet

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

    Набор символов, содержащий символы в категориях Символов Управления или Формата.

    Обсуждение

    Эти символы являются в частности значениями Unicode U+0000 к U+001F и U+007F к U+009F.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + illegalCharacterSet

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

    Объявление

    Swift

    class func decimalDigitCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)decimalDigitCharacterSet

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

    Набор символов, содержащий символы в категории Десятичных чисел.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + alphanumericCharacterSet

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

    Объявление

    Swift

    class func decomposableCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)decomposableCharacterSet

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

    Набор символов, содержащий все отдельные символы Unicode, которые могут также быть представлены как составленные последовательности символов (такой что касается букв с диакритическими знаками) по определению “стандартного разложения” в версии 3.2 стандарта кодировки символов Unicode.

    Обсуждение

    Эти символы включают символы совместимости, а также предварительно составленные символы.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + nonBaseCharacterSet

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

    Объявление

    Swift

    class func illegalCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)illegalCharacterSet

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + controlCharacterSet

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

    Объявление

    Swift

    class func letterCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)letterCharacterSet

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

    Набор символов, содержащий символы в Буквах категорий и Знаках.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func lowercaseLetterCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)lowercaseLetterCharacterSet

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

    Набор символов, содержащий символы в категории Строчных букв.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func newlineCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)newlineCharacterSet

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

    Набор символов, содержащий символы новой строки (U+000AU+000D, U+0085).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func nonBaseCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)nonBaseCharacterSet

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

    Набор символов, содержащий символы в категории Знаков.

    Обсуждение

    Этот набор также определяется как все юридические символы Unicode с приоритетом без интервалов, больше, чем 0. Неофициально, этот набор является набором всех символов, используемых в качестве модификаторов основных символов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + decomposableCharacterSet

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

    Объявление

    Swift

    class func punctuationCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)punctuationCharacterSet

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

    Набор символов, содержащий символы в категории Пунктуации.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func symbolCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)symbolCharacterSet

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

    Набор символов, содержащий символы в категории Символов.

    Обсуждение

    Эти символы включают, например, знак доллара ($) и плюс (+) знак.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func uppercaseLetterCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)uppercaseLetterCharacterSet

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

    Набор символов, содержащий символы в категориях Прописных букв и Букв Titlecase.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает набор символов, содержащий Unicode Общая Категория Z*, U000A ~ U000D и U0085.

    Объявление

    Swift

    class func whitespaceAndNewlineCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)whitespaceAndNewlineCharacterSet

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

    Набор символов, содержащий Unicode Общая Категория Z*, U000A ~ U000D и U0085.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает набор символов, содержащий только встроенное пространство пробельных символов (U+0020) и вкладка (U+0009).

    Объявление

    Swift

    class func whitespaceCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)whitespaceCharacterSet

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

    Набор символов, содержащий только встроенное пространство пробельных символов (U+0020) и вкладка (U+0009).

    Обсуждение

    Этот набор не содержит символы новой строки или символы возврата каретки.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func URLFragmentAllowedCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)URLFragmentAllowedCharacterSet

    Обсуждение

    Компонент фрагмента URL является компонентом после a # символ. Например, в URL http://www.example.com/index.html#jumpLocation, фрагмент jumpLocation.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func URLHostAllowedCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)URLHostAllowedCharacterSet

    Обсуждение

    Компонент узла URL обычно сразу является компонентом после первых двух ведущих наклонных черт. Если URL содержит имя пользователя и пароль, компонент узла является компонентом после @ знак. Например, в URL http://username:password@www.example.com/index.html, компонент узла www.example.com.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func URLPasswordAllowedCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)URLPasswordAllowedCharacterSet

    Обсуждение

    Компонент пароля URL сразу является компонентом после двоеточия после компонента имени пользователя URL и заканчивается в @ знак. Например, в URL http://username:password@www.example.com/index.html, компонент передачи password.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func URLPathAllowedCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)URLPathAllowedCharacterSet

    Обсуждение

    Компонент контура URL сразу является компонентом после компонента узла (если есть). Это заканчивается везде, где начинается компонент запроса или фрагмента. Например, в URL http://www.example.com/index.php?key1=value1, компонент контура /index.php.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func URLQueryAllowedCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)URLQueryAllowedCharacterSet

    Обсуждение

    Компонент запроса URL сразу является компонентом после вопросительного знака (?). Например, в URL http://www.example.com/index.php?key1=value1#jumpLink, компонент запроса key1=value1.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    class func URLUserAllowedCharacterSet() -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)URLUserAllowedCharacterSet

    Обсуждение

    Пользовательский компонент URL является дополнительным компонентом, предшествующим компоненту узла и заканчивающим в любом двоеточие (если пароль указан), или @ знак (если никакой пароль не указан). Например, в URL http://username:password@www.example.com/index.html, пользовательский компонент username.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    init(charactersInString aString: String) -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)characterSetWithCharactersInString:(NSString *)aString

    Параметры

    aString

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    init(range aRange: NSRange) -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)characterSetWithRange:(NSRange)aRange

    Параметры

    aRange

    Диапазон значений Unicode.

    aRange.location значение первого символа, который возвратится; aRange.location + aRange.length– 1 значение последнего.

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

    Набор символов, содержащий символы, значениями Unicode которых дают aRange. Если aRange.length 0, возвращает пустой набор символов.

    Обсуждение

    Эта выборка кода создает объект набора символов, содержащий строчные английские буквенные символы:

    • NSRange lcEnglishRange;
    • NSCharacterSet *lcEnglishLetters;
    • lcEnglishRange.location = (unsigned int)'a';
    • lcEnglishRange.length = 26;
    • lcEnglishLetters = [NSCharacterSet characterSetWithRange:lcEnglishRange];

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • invertedSet invertedSet Свойство

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

    Объявление

    Swift

    @NSCopying var invertedSet: NSCharacterSet { get }

    Objective C

    @property(readonly, copy) NSCharacterSet *invertedSet

    Обсуждение

    Используя инверсию неизменного набора символов намного более эффективно, чем инвертирование непостоянного набора символов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    invert (NSMutableCharacterSet)

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

    Объявление

    Swift

    init(bitmapRepresentation data: NSData) -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)characterSetWithBitmapRepresentation:(NSData *)data

    Параметры

    data

    Растровое представление набора символов.

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

    Набор символов, содержащий символы, определенные data.

    Обсуждение

    Этот метод полезен для создания объекта набора символов с данными от файла или другого внешнего источника данных.

    Необработанное растровое представление набора символов является массивом байтов 2^16 биты (т.е. 8 192 байта). Значение бита в позиции n представляет присутствие в наборе символов символа с десятичным n значения Unicode. Для добавления символа с десятичным Unicode оценивают n необработанному растровому представлению, используют оператор, такой как следующее:

    • unsigned char bitmapRep[8192];
    • bitmapRep[n >> 3] |= (((unsigned int)1) << (n & 7));

    Удалить тот символ:

    • bitmapRep[n >> 3] &= ~(((unsigned int)1) << (n & 7));

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    init?(contentsOfFile path: String) -> NSCharacterSet

    Objective C

    + (NSCharacterSet *)characterSetWithContentsOfFile:(NSString *)path

    Параметры

    path

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

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

    Набор символов читал из растрового представления, сохраненного в файле в path.

    Обсуждение

    Для чтения растрового представления от любого файла используйте NSData методdataWithContentsOfFile:options:error: и передайте результат characterSetWithBitmapRepresentation:.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • NSData объект, кодирующий получатель в двоичном формате. (только для чтения)

    Объявление

    Swift

    @NSCopying var bitmapRepresentation: NSData { get }

    Objective C

    @property(readonly, copy) NSData *bitmapRepresentation

    Обсуждение

    Этот формат подходит для сохранения для файла или иначе передачи или архивации.

    Необработанное растровое представление набора символов является массивом байтов 2^16 биты (т.е. 8 192 байта). Значение бита в позиции n представляет присутствие в наборе символов символа с десятичным n значения Unicode. Для тестирования на присутствие символа с десятичным Unicode оценивают n в необработанном растровом представлении, используют выражение, такое как следующее:

    • unsigned char bitmapRep[8192];
    • if (bitmapRep[n >> 3] & (((unsigned int)1) << (n & 7))) {
    • /* Character is present. */
    • }

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func characterIsMember(_ aCharacter: unichar) -> Bool

    Objective C

    - (BOOL)characterIsMember:(unichar)aCharacter

    Параметры

    aCharacter

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

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

    YEStrue если aCharacter находится в наборе символов получения, иначе NOfalse.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – longCharacterIsMember:

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

    Объявление

    Swift

    func hasMemberInPlane(_ thePlane: UInt8) -> Bool

    Objective C

    - (BOOL)hasMemberInPlane:(uint8_t)thePlane

    Параметры

    thePlane

    Символьная плоскость.

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

    YEStrue если получатель имеет по крайней мере один элемент в thePlane, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func isSupersetOfSet(_ theOtherSet: NSCharacterSet) -> Bool

    Objective C

    - (BOOL)isSupersetOfSet:(NSCharacterSet *)theOtherSet

    Параметры

    theOtherSet

    Набор символов.

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

    YEStrue если получатель является надмножеством theOtherSet, иначе NOfalse.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func longCharacterIsMember(_ theLongChar: UTF32Char) -> Bool

    Objective C

    - (BOOL)longCharacterIsMember:(UTF32Char)theLongChar

    Параметры

    theLongChar

    Символ UTF32.

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

    YEStrue если theLongChar находится в получателе, иначе NOfalse.

    Обсуждение

    Этот метод поддерживает спецификацию 32-разрядных символов.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – characterIsMember:

  • Указывает нижнюю границу для диапазона символов Unicode, зарезервированного для корпоративного использования Apple.

    Объявление

    Swift

    var NSOpenStepUnicodeReservedBase: Int { get }

    Objective C

    enum { NSOpenStepUnicodeReservedBase = 0xF400 };

    Константы

    • NSOpenStepUnicodeReservedBase

      NSOpenStepUnicodeReservedBase

      Указывает нижнюю границу для диапазона символов Unicode, зарезервированного для корпоративного использования Apple (диапазон 0xF400–0xF8FF).

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