Ссылка CFCharacterSet

Объект CFCharacterSet представляет ряд Unicode совместимые символы. CFString использует объекты CFCharacterSet собрать в группу символы для поиска операций, так, чтобы они могли найти любой определенный набор символов во время поиска. Два непрозрачных типа, CFCharacterSet и Ссылка CFMutableCharacterSet, определяют интерфейс для статических и динамических наборов символов, соответственно. Объекты Вы создаете использование этих непрозрачных типов, упоминаются, поскольку набор символов возражает (и когда никакой беспорядок не закончится, просто как наборы символов).

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

CFCharacterSet “бесплатный соединенный мостом” с его дубликатом Основы Какао, NSCharacterSet. Это означает, что Базовый тип Основы является взаимозаменяемым в вызовах функции или вызовах метода с соединенным мостом объектом Основы. Поэтому в методе, где Вы видите NSCharacterSet * параметр, можно передать в a CFCharacterSetRef, и в функции, где Вы видите a CFCharacterSetRef параметр, можно передать в экземпляре NSCharacterSet. Эта возможность также применяется к конкретным подклассам NSCharacterSet. Посмотрите Бесплатные Соединенные мостом Типы для получения дополнительной информации о бесплатном образовании моста.

Функции

Создание наборов символов


    
    CFCharacterSetCreateCopy (_: _:)
    CFCharacterSetCreateCopy

Создает новый набор символов со значениями от данного набора символов.

Объявление

Swift

func CFCharacterSetCreateCopy(_ alloc: CFAllocator!, _ theSet: CFCharacterSet!) -> CFCharacterSet!

Objective C

CFCharacterSetRef CFCharacterSetCreateCopy ( CFAllocatorRef alloc, CFCharacterSetRef theSet );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theSet`	Набор символов для копирования.

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

Новый набор символов, который является копией theSet. Владение соблюдает Создать Правило.

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetCreateInvertedSet (_: _:)
    CFCharacterSetCreateInvertedSet

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

Объявление

Swift

func CFCharacterSetCreateInvertedSet(_ alloc: CFAllocator!, _ theSet: CFCharacterSet!) -> CFCharacterSet!

Objective C

CFCharacterSetRef CFCharacterSetCreateInvertedSet ( CFAllocatorRef alloc, CFCharacterSetRef theSet );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theSet`	Набор символов, из которого можно создать инвертированный набор.

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

Новый набор символов, который является инвертированием theSet. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetCreateWithCharactersInRange (_: _:)
    CFCharacterSetCreateWithCharactersInRange

Создает новый набор символов со значениями от данного диапазона символов Unicode.

Объявление

Swift

func CFCharacterSetCreateWithCharactersInRange(_ alloc: CFAllocator!, _ theRange: CFRange) -> CFCharacterSet!

Objective C

CFCharacterSetRef CFCharacterSetCreateWithCharactersInRange ( CFAllocatorRef alloc, CFRange theRange );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theRange`	Диапазон Unicode символов нового набора символов. Функция принимает диапазон в 32-разрядном в формате UTF-32. Диапазон точки допустимого символа от 0x00000 до 0x10FFFF.

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

Новый набор символов, содержащий непрерывный диапазон символов Unicode. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetCreateWithCharactersInString (_: _:)
    CFCharacterSetCreateWithCharactersInString

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

Объявление

Swift

func CFCharacterSetCreateWithCharactersInString(_ alloc: CFAllocator!, _ theString: CFString!) -> CFCharacterSet!

Objective C

CFCharacterSetRef CFCharacterSetCreateWithCharactersInString ( CFAllocatorRef alloc, CFStringRef theString );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theString`	Строка, содержащая символы для нового набора.

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

Новый набор символов, содержащий символы от theString. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetCreateWithBitmapRepresentation (_: _:)
    CFCharacterSetCreateWithBitmapRepresentation

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

Объявление

Swift

func CFCharacterSetCreateWithBitmapRepresentation(_ alloc: CFAllocator!, _ theData: CFData!) -> CFCharacterSet!

Objective C

CFCharacterSetRef CFCharacterSetCreateWithBitmapRepresentation ( CFAllocatorRef alloc, CFDataRef theData );

Параметры


      alloc

Средство выделения для использования для выделения памяти для нового объекта. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.


      theData

Объект CFData, указывающий растровое представление символа Unicode, указывает для нового набора символов. Растровое представление могло содержать весь диапазон символов Unicode, запускающийся от BMP до Плоскости 16. Первые 8 кибибитов (8 192 байта) данных представляют диапазон BMP. Диапазон BMP 8 кибибитов может сопровождаться нулем к шестнадцати битовым массивам на 8 кибибитов, каждый предварительно ожидаемый с плоским индексным байтом. Например, битовый массив, представляющий BMP и Плоскость 2, имеет размер 16 385 байтов (8 кибибитов для BMP, 1-байтового индекса и битового массива на 8 кибибитов для Плоскости 2). Плоский индексный байт, в этом случае, содержит целочисленное значение два.

Если данные содержат Плоский индексный байт за пределами допустимого Плоского диапазона (1 - 16), поведение не определено.

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

Новый набор символов, содержащий обозначенные символы от theData. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Получение предопределенных наборов символов


    
    CFCharacterSetGetPredefined (_:)
    CFCharacterSetGetPredefined

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

Объявление

Swift

func CFCharacterSetGetPredefined(_ theSetIdentifier: CFCharacterSetPredefinedSet) -> CFCharacterSet!

Objective C

CFCharacterSetRef CFCharacterSetGetPredefined ( CFCharacterSetPredefinedSet theSetIdentifier );

Параметры


      theSetIdentifier

Предопределенный набор символов. Посмотрите Предопределенные Значения Селектора CFCharacterSet для списка доступных наборов символов.

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

Предопределенный набор символов. Этот экземпляр принадлежит Базовой Основе.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Запросы наборов символов


    
    CFCharacterSetCreateBitmapRepresentation (_: _:)
    CFCharacterSetCreateBitmapRepresentation

Создает новые неизменные данные с растровым представлением от данного набора символов.

Объявление

Swift

func CFCharacterSetCreateBitmapRepresentation(_ alloc: CFAllocator!, _ theSet: CFCharacterSet!) -> CFData!

Objective C

CFDataRef CFCharacterSetCreateBitmapRepresentation ( CFAllocatorRef alloc, CFCharacterSetRef theSet );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theSet`	Набор, из которого можно создать растровое представление. Обратитесь к комментариям для `CFCharacterSetCreateWithBitmapRepresentation` для детального обсуждения растрового формата представления.

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

Новый объект CFData, содержащий растровое представление theSet. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetHasMemberInPlane (_: _:)
    CFCharacterSetHasMemberInPlane

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

Объявление

Swift

func CFCharacterSetHasMemberInPlane(_ theSet: CFCharacterSet!, _ thePlane: CFIndex) -> Boolean

Objective C

Boolean CFCharacterSetHasMemberInPlane ( CFCharacterSetRef theSet, CFIndex thePlane );

Параметры

`theSet`	Набор символов для исследования.
`thePlane`	Плоское число, которое будет проверено на членство. Допустимый диапазон значений от 0 до 16. Если значение за пределами допустимого плоского диапазона числа, поведение не определено.

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

true если по крайней мере один задействованный символ находится в указанной плоскости, иначе false.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetIsCharacterMember (_: _:)
    CFCharacterSetIsCharacterMember

Отчеты, является ли данный символ Unicode в наборе символов.

Объявление

Swift

func CFCharacterSetIsCharacterMember(_ theSet: CFCharacterSet!, _ theChar: UniChar) -> Boolean

Objective C

Boolean CFCharacterSetIsCharacterMember ( CFCharacterSetRef theSet, UniChar theChar );

Параметры


      theSet

Набор символов для исследования.


      theChar

Символ Unicode, на который можно протестировать против набора символов. Обратите внимание на то, что эта функция принимает 16-разрядное значение символа Unicode; следовательно, это не делает доступа к поддержке к non-BMP плоскостям.

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

true если theSet содержит theChar, иначе false.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetIsLongCharacterMember (_: _:)
    CFCharacterSetIsLongCharacterMember

Отчеты, является ли данный символ UTF-32 в наборе символов.

Объявление

Swift

func CFCharacterSetIsLongCharacterMember(_ theSet: CFCharacterSet!, _ theChar: UTF32Char) -> Boolean

Objective C

Boolean CFCharacterSetIsLongCharacterMember ( CFCharacterSetRef theSet, UTF32Char theChar );

Параметры

`theSet`	Набор символов для исследования.
`theChar`	Символ UTF-32, на который можно протестировать против набора символов.

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

true если theSet содержит theChar, иначе false.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFCharacterSetIsSupersetOfSet (_: _:)
    CFCharacterSetIsSupersetOfSet

Отчеты, является ли набор символов надмножеством другого набора.

Объявление

Swift

func CFCharacterSetIsSupersetOfSet(_ theSet: CFCharacterSet!, _ theOtherSet: CFCharacterSet!) -> Boolean

Objective C

Boolean CFCharacterSetIsSupersetOfSet ( CFCharacterSetRef theSet, CFCharacterSetRef theOtherset );

Параметры

`theSet`	Набор символов, который будет проверен на членство `theOtherSet`.
`theOtherSet`	Набор символов, который будет проверен, является ли это подмножеством `theSet`.

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

true если theSet надмножество theOtherSet, иначе false.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Получение идентификатора типа набора символов

CFCharacterSetGetTypeID () CFCharacterSetGetTypeID

Возвращает идентификатор типа CFCharacterSet непрозрачный тип.

Объявление

Swift

func CFCharacterSetGetTypeID() -> CFTypeID

Objective C

CFTypeID CFCharacterSetGetTypeID ( void );

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

Идентификатор типа CFCharacterSet непрозрачный тип.

Обсуждение

Объекты CFMutableCharacterSet имеют тот же идентификатор типа как объекты CFCharacterSet.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Типы данных

Прочие условия

CFCharacterSetPredefinedSet CFCharacterSetPredefinedSet

Определяет предопределенный набор символов.

Объявление

Swift

enum CFCharacterSetPredefinedSet : CFIndex { case Control case Whitespace case WhitespaceAndNewline case DecimalDigit case Letter case LowercaseLetter case UppercaseLetter case NonBase case Decomposable case AlphaNumeric case Punctuation case CapitalizedLetter case Symbol case Newline case Illegal }

Objective C

typedef CFIndex CFCharacterSetPredefinedSet;

Обсуждение

Посмотрите Предопределенные Значения Селектора CFCharacterSet для значений.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Ссылка на неизменный объект набора символов.

Объявление

Swift

typealias CFCharacterSetRef = CFCharacterSet

Objective C

typedef const struct __CFCharacterSet *CFCharacterSetRef;

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Константы

Прочие условия

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

Объявление

Swift

enum CFCharacterSetPredefinedSet : CFIndex { case Control case Whitespace case WhitespaceAndNewline case DecimalDigit case Letter case LowercaseLetter case UppercaseLetter case NonBase case Decomposable case AlphaNumeric case Punctuation case CapitalizedLetter case Symbol case Newline case Illegal }

Objective C

enum { kCFCharacterSetControl = 1, kCFCharacterSetWhitespace, kCFCharacterSetWhitespaceAndNewline, kCFCharacterSetDecimalDigit, kCFCharacterSetLetter, kCFCharacterSetLowercaseLetter, kCFCharacterSetUppercaseLetter, kCFCharacterSetNonBase, kCFCharacterSetDecomposable, kCFCharacterSetAlphaNumeric, kCFCharacterSetPunctuation, kCFCharacterSetCapitalizedLetter = 13, kCFCharacterSetSymbol = 14, kCFCharacterSetNewline = 15, kCFCharacterSetIllegal = 12 };

Константы
- Control
  
  kCFCharacterSetControl
  
  Набор управляющего символа (Unicode General Category Cc и Cf).
  
  Доступный в OS X v10.0 и позже.
- Whitespace
  
  kCFCharacterSetWhitespace
  
  Набор пробельного символа (Unicode Общая Категория Zs и U0009 CHARACTER TABULATION).
  
  Доступный в OS X v10.0 и позже.
- WhitespaceAndNewline
  
  kCFCharacterSetWhitespaceAndNewline
  
  Пробельный символ и набор Символа новой строки (Unicode Общая Категория Z*, U000A ~ U000D, и U0085).
  
  Доступный в OS X v10.0 и позже.
- DecimalDigit
  
  kCFCharacterSetDecimalDigit
  
  Набор символов десятичной цифры.
  
  Доступный в OS X v10.0 и позже.
- Letter
  
  kCFCharacterSetLetter
  
  Обозначьте буквами набор символов (Unicode Общая Категория L* и M*).
  
  Доступный в OS X v10.0 и позже.
- LowercaseLetter
  
  kCFCharacterSetLowercaseLetter
  
  Набор символа нижнего регистра (Unicode Общая Категория Ll).
  
  Доступный в OS X v10.0 и позже.
- UppercaseLetter
  
  kCFCharacterSetUppercaseLetter
  
  Набор символа верхнего регистра (Unicode Общий Лютеций Категории и Лейтенант).
  
  Доступный в OS X v10.0 и позже.
- NonBase
  
  kCFCharacterSetNonBase
  
  Набор неосновного символа (Unicode Общая Категория M*).
  
  Доступный в OS X v10.0 и позже.
- Decomposable
  
  kCFCharacterSetDecomposable
  
  Канонически разложимый набор символов.
  
  Доступный в OS X v10.0 и позже.
- AlphaNumeric
  
  kCFCharacterSetAlphaNumeric
  
  Набор Алфавитно-цифрового символа (Unicode Общая Категория L*, M*, и N*).
  
  Доступный в OS X v10.0 и позже.
- Punctuation
  
  kCFCharacterSetPunctuation
  
  Набор знака препинания (Unicode Общая Категория P*).
  
  Доступный в OS X v10.0 и позже.
- CapitalizedLetter
  
  kCFCharacterSetCapitalizedLetter
  
  Набор символов Titlecase (Unicode Общая Категория Лейтенант).
  
  Доступный в OS X v10.2 и позже.
- Symbol
  
  kCFCharacterSetSymbol
  
  Набор символов символа (Unicode Общая Категория S*).
  
  Доступный в OS X v10.3 и позже.
- Newline
  
  kCFCharacterSetNewline
  
  Набор символа новой строки (U000A ~ U000D, U0085, U2028, и U2029).
  
  Доступный в OS X v10.5 и позже.
- Illegal
  
  kCFCharacterSetIllegal
  
  Запрещенный символ установлен.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

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