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
.
Наследование
-
NSObject
-
NSCharacterSet
-
NSMutableCharacterSet
-
NSObject
-
NSCharacterSet
-
NSMutableCharacterSet
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSMutableCopying
-
NSObjectProtocol
-
Печатаемый
-
NSCoding
-
NSCopying
-
NSMutableCopying
-
NSObject
Оператор импорта
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 и позже.
См. также
-
Возвращает набор символов, содержащий символы в категории Десятичных чисел.
Объявление
Swift
class func decimalDigitCharacterSet() -> NSCharacterSet
Objective C
+ (NSCharacterSet *)decimalDigitCharacterSet
Возвращаемое значение
Набор символов, содержащий символы в категории Десятичных чисел.
Обсуждение
Неофициально, этот набор является набором всех символов, используемых для представления десятичных значений
0
через9
. Эти символы включают, например, десятичные цифры Относящихся к Индии сценариев и арабского языка.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает набор символов, содержащий все отдельные символы 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 и позже.
См. также
-
Возвращает набор символов, содержащий значения в категории Несимволов или которые еще не были определены в версии 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 и позже.
См. также
-
Возвращает набор символов, содержащий символы в Буквах категорий и Знаках.
Объявление
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+000A
–U+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 и позже.
См. также
-
Возвращает набор символов, содержащий символы в категории Пунктуации.
Объявление
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
#
символ. Например, в URLhttp://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 содержит имя пользователя и пароль, компонент узла является компонентом после
@
знак. Например, в URLhttp://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 и заканчивается в
@
знак. Например, в URLhttp://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 сразу является компонентом после вопросительного знака (
?
). Например, в URLhttp://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 является дополнительным компонентом, предшествующим компоненту узла и заканчивающим в любом двоеточие (если пароль указан), или
@
знак (если никакой пароль не указан). Например, в URLhttp://username:password@www.example.com/index.html
, пользовательский компонентusername
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает набор символов, содержащий символы в данной строке.
Объявление
Swift
init(charactersInString
aString
: String) -> NSCharacterSetObjective 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) -> NSCharacterSetObjective 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) -> NSCharacterSetObjective 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) -> NSCharacterSetObjective 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 и позже.
-
bitmapRepresentation bitmapRepresentation
Свойство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) -> BoolObjective C
- (BOOL)characterIsMember:(unichar)
aCharacter
Параметры
aCharacter
Символ для тестирования на членство получателя.
Возвращаемое значение
YES
true
еслиaCharacter
находится в наборе символов получения, иначеNO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, имеет ли получатель по крайней мере один элемент в данной символьной плоскости.
Объявление
Swift
func hasMemberInPlane(_
thePlane
: UInt8) -> BoolObjective C
- (BOOL)hasMemberInPlane:(uint8_t)
thePlane
Параметры
thePlane
Символьная плоскость.
Возвращаемое значение
YES
true
если получатель имеет по крайней мере один элемент вthePlane
, иначеNO
false
.Обсуждение
Этот метод упрощает находить плоскость, содержащую элементы набора текущего символа. Основная Многоязычная Плоскость является плоскостью
0
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает булево значение, указывающее, является ли получатель надмножеством другого данного набора символов.
Объявление
Swift
func isSupersetOfSet(_
theOtherSet
: NSCharacterSet) -> BoolObjective C
- (BOOL)isSupersetOfSet:(NSCharacterSet *)
theOtherSet
Параметры
theOtherSet
Набор символов.
Возвращаемое значение
YES
true
если получатель является надмножествомtheOtherSet
, иначеNO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает булево значение, указывающее, является ли даваемый длинный символ элементом получателя.
Объявление
Swift
func longCharacterIsMember(_
theLongChar
: UTF32Char) -> BoolObjective C
- (BOOL)longCharacterIsMember:(UTF32Char)
theLongChar
Параметры
theLongChar
Символ UTF32.
Возвращаемое значение
YES
true
еслиtheLongChar
находится в получателе, иначеNO
false
.Обсуждение
Этот метод поддерживает спецификацию 32-разрядных символов.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Указывает нижнюю границу для диапазона символов Unicode, зарезервированного для корпоративного использования Apple.
Объявление
Swift
var NSOpenStepUnicodeReservedBase: Int { get }
Objective C
enum { NSOpenStepUnicodeReservedBase = 0xF400 };
Константы