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

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

Разработчик

Ссылка платформы CoreFoundation ссылка CFString

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

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

Ссылка CFString

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


Не применимый

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


Не применимый

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


Swift

import CoreFoundation

Objective C

@import CoreFoundation;

CFString обеспечивает комплект эффективной обработки строк и функций преобразования строк. Это предлагает бесшовную поддержку Unicode и упрощает совместное использование данных между Какао и программами на базе С. Объекты CFString являются неизменными — использование CFMutableStringRef создать и управлять строкой, которая может быть изменена после того, как она была создана.

CFString имеет две примитивных функции, CFStringGetLength и CFStringGetCharacterAtIndex, это обеспечивает основание для всех других функций в его интерфейсе. CFStringGetLength функционируйте возвращает общее количество (с точки зрения пар кода UTF-16) символов в строке. CFStringGetCharacterAtIndex функция предоставляет доступ к каждому символу в строке индексом с индексными значениями, запускающимися в 0.

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

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

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

Функции

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

    Объявление

    Objective C

    CFStringRef CFSTR ( const char *cStr );

    Параметры

    cStr

    Постоянная струна до (т.е. текст включил в двойные кавычки), из которого должна быть создана строка.

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

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

    Обсуждение

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

    Значение, возвращенное CFSTR имеет следующую семантику:

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

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

    Обратите внимание на то, что при использовании этого макроса как инициализатор, необходимо скомпилировать использование флага -fconstant-cfstrings (см. опции управлять диалектом C).

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

    Objective C

    @import CoreFoundation;

    Доступность

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

  • Создает массив объектов CFString от единственного объекта CFString.

    Объявление

    Swift

    func CFStringCreateArrayBySeparatingStrings(_ alloc: CFAllocator!, _ theString: CFString!, _ separatorString: CFString!) -> CFArray!

    Objective C

    CFArrayRef CFStringCreateArrayBySeparatingStrings ( CFAllocatorRef alloc, CFStringRef theString, CFStringRef separatorString );

    Параметры

    alloc

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

    theString

    Строка, которая будет разделена на подстроки. Подстроки должны быть разделены separatorString.

    separatorString

    Строка раньше разделяла подстроки в theString.

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

    Новый массив, содержащий объекты CFString, представляющие подстроки theString, или NULL если была проблема, создающая объект. Порядок элементов в массиве идентичен порядку подстрок в theString. Если separatorString не происходит в theString, результатом является массив, содержащий theString. Если separatorString равно theString, тогда результатом является массив, содержащий две пустых строки. Владение соблюдает Создать Правило.

    Обсуждение

    Эта функция обеспечивает удобный способ преобразовать единицы информации, полученные в единственной строке к форме (массив) подходящий для итеративной обработки. Один или более символов-разделителей (или «строка разделителя») разделяют подстроки в исходной строке — эти символы являются часто пробельными символами, такими как вкладки и новые строки (возвраты каретки). Например, у Вас мог бы быть файл, содержащий локализованный список названий места с каждым именем, разделенным символом табуляции. Вы могли создать объект CFString из этого файла и вызвать эту функцию на строке для получения объекта CFArray, элементы которого являются этими названиями места.

    separatorString обрабатывается как полный модуль. Если Вы указываете XYZ как строка разделителя, тогда если theString aXbYZcXYZe, тогда возвращенный массив содержит aXbYZc и e.

    См. также CFStringCreateByCombiningStrings.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает единственную строку из отдельных объектов CFString, включающих элементы массива.

    Объявление

    Swift

    func CFStringCreateByCombiningStrings(_ alloc: CFAllocator!, _ theArray: CFArray!, _ separatorString: CFString!) -> CFString!

    Objective C

    CFStringRef CFStringCreateByCombiningStrings ( CFAllocatorRef alloc, CFArrayRef theArray, CFStringRef separatorString );

    Параметры

    alloc

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

    theArray

    Массив CFString возражает для конкатенации. Это значение не должно быть NULL.

    separatorString

    Строка для вставки между подстроками в возвращаемую строку. Это значение обычно является пробельным символом, таким как вкладка или новая строка (возврат каретки). Если это значение не является допустимым объектом CFString, утверждение повышено.

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

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

    Если theArray пусто, возвращает пустой объект CFString; если theArray содержит один объект CFString, тот объект возвращается (без строки разделителя). Возвраты NULL если была проблема в создании строки. Владение соблюдает Создать Правило.

    Обсуждение

    См. также CFStringCreateArrayBySeparatingStrings.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает неизменную копию строки.

    Объявление

    Swift

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

    Objective C

    CFStringRef CFStringCreateCopy ( CFAllocatorRef alloc, CFStringRef theString );

    Параметры

    alloc

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

    theString

    Строка для копирования.

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

    Неизменная строка, содержание которой идентично theString. Возвраты NULL если была проблема, копируя объект. Владение соблюдает Создать Правило.

    Обсуждение

    Полученный объект имеет то же содержание Unicode как исходный объект, но это является всегда неизменным. Это могло бы также иметь различные характеристики хранения, и следовательно могло бы ответить по-другому на функции такому как CFStringGetCStringPtr. Кроме того, если указанное средство выделения и средство выделения исходного объекта являются тем же, и строка является уже неизменной, эта функция может просто постепенно увеличить количество отставания, не делая заверенную копию. Однако полученный объект является истинной неизменной копией, кроме работы было намного более эффективным.

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает строку из ее “внешнего представления”.

    Объявление

    Swift

    func CFStringCreateFromExternalRepresentation(_ alloc: CFAllocator!, _ data: CFData!, _ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFStringCreateFromExternalRepresentation ( CFAllocatorRef alloc, CFDataRef data, CFStringEncoding encoding );

    Параметры

    alloc

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

    data

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

    encoding

    Кодирование для использования при интерпретации байтов в параметре данных.

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

    Неизменная строка, содержащая символы от data, или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

    В форме объекта CFData строка может быть записана в диск как файл или отослана по сети. Если кодирование символов в объекте данных является Unicode, функция читает любой BOM (маркер порядка байтов) и должным образом разрешает порядок байтов.

    CFStringCreateExternalRepresentation функциональные дополнения эта функция путем создания “внешнего представления” CFData возражают от строки.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCreateWithBytes(_ alloc: CFAllocator!, _ bytes: UnsafePointer<UInt8>, _ numBytes: CFIndex, _ encoding: CFStringEncoding, _ isExternalRepresentation: Boolean) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithBytes ( CFAllocatorRef alloc, const UInt8 *bytes, CFIndex numBytes, CFStringEncoding encoding, Boolean isExternalRepresentation );

    Параметры

    alloc

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

    bytes

    Буферное, содержащее символы в кодировании, указанном encoding. Буфер не должен содержать байт длины (как в буферах Паскаля) или никакое завершение NULL символ (как в буферах C).

    numBytes

    Число байтов в bytes.

    encoding

    Строковое кодирование символов в буфере.

    isExternalRepresentation

    true если символы в буфере байта находятся во “внешнем представлении” формат — т.е. содержит ли буфер BOM (маркер порядка байтов). Это обычно имеет место для байтов, считанных в из текстового файла или полученных по сети. Иначе, передача false.

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

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

    Обсуждение

    Эта функция обрабатывает символьные данные во “внешнем представлении” формат путем интерпретации любого BOM (маркер порядка байтов) символ и выполнения любого необходимого свопинга байта.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCreateWithBytesNoCopy(_ alloc: CFAllocator!, _ bytes: UnsafePointer<UInt8>, _ numBytes: CFIndex, _ encoding: CFStringEncoding, _ isExternalRepresentation: Boolean, _ contentsDeallocator: CFAllocator!) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithBytesNoCopy ( CFAllocatorRef alloc, const UInt8 *bytes, CFIndex numBytes, CFStringEncoding encoding, Boolean isExternalRepresentation, CFAllocatorRef contentsDeallocator );

    Параметры

    alloc

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

    bytes

    Буферное, содержащее символы в кодировании, указанном encoding. Буфер не должен содержать байт длины (как в буферах Паскаля) или никакое завершение NULL символ (как в буферах C).

    numBytes

    Число байтов в bytes.

    encoding

    Кодировка символов bytes.

    isExternalRepresentation

    true если символы в буфере байта находятся во “внешнем представлении” формат — т.е. содержит ли буфер BOM (маркер порядка байтов). Это обычно имеет место для байтов, считанных в из текстового файла или полученных по сети. Иначе, передача false.

    contentsDeallocator

    Средство выделения для использования для освобождения bytes когда это больше не необходимо. Можно передать NULL или kCFAllocatorDefault запрашивать средство выделения по умолчанию с этой целью. Если буфер не должен быть освобожден, или если Вы хотите принять на себя ответственность за освобождение буфера (и не иметь строку, освобождают его), передача kCFAllocatorNull.

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

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

    Обсуждение

    Эта функция берет явную длину и позволяет Вам указывать, являются ли данные внешним форматом — т.е. обратить ли внимание на символ BOM (если таковые имеются) и сделать свопинг байта при необходимости

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает строку из буфера символов Unicode.

    Объявление

    Swift

    func CFStringCreateWithCharacters(_ alloc: CFAllocator!, _ chars: UnsafePointer<UniChar>, _ numChars: CFIndex) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithCharacters ( CFAllocatorRef alloc, const UniChar *chars, CFIndex numChars );

    Параметры

    alloc

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

    chars

    Буфер символов Unicode для копирования в новую строку.

    numChars

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

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

    Неизменная строка, содержащая chars, или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

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

    Для сохранения памяти эта функция могла бы принять решение сохранить символы внутренне в 8-разрядном запоминающем устройстве. Т.е. просто потому что буфер UniChar символы использовались для инициализации объекта, не означает, что Вы возвратитесь не -NULL результат CFStringGetCharactersPtr.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCreateWithCharactersNoCopy(_ alloc: CFAllocator!, _ chars: UnsafePointer<UniChar>, _ numChars: CFIndex, _ contentsDeallocator: CFAllocator!) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithCharactersNoCopy ( CFAllocatorRef alloc, const UniChar *chars, CFIndex numChars, CFAllocatorRef contentsDeallocator );

    Параметры

    alloc

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

    chars

    Буфер Unicode, выделенный и инициализированный с символами Unicode.

    numChars

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

    contentsDeallocator

    Средство выделения для использования для освобождения внешнего буфера, когда это больше не необходимо. Можно передать NULL или kCFAllocatorDefault запрашивать средство выделения по умолчанию с этой целью. Если буфер не должен быть освобожден, или если Вы хотите принять на себя ответственность за освобождение буфера (и не иметь строку, освобождают его), передача kCFAllocatorNull.

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

    Неизменная строка, содержащая chars, или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

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

    Функция включает a contentsDeallocator параметр, с которым можно указать средство выделения для использования для освобождения внешнего буфера, когда освобождена строка. Если Вы хотите принять на себя ответственность за освобождение этой памяти, указать kCFAllocatorNull для этого параметра.

    Если во время создания CFString решает, что это не может использовать буфер, и существует a contentsDeallocator, это будет использовать это средство выделения для освобождения буфера в то время.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает неизменную строку из струны до.

    Объявление

    Swift

    func CFStringCreateWithCString(_ alloc: CFAllocator!, _ cStr: UnsafePointer<Int8>, _ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithCString ( CFAllocatorRef alloc, const char *cStr, CFStringEncoding encoding );

    Параметры

    alloc

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

    cStr

    NULL- завершенная струна до, которая будет использоваться для создания объекта CFString. Строка должна использовать 8-разрядное кодирование.

    encoding

    Кодирование символов в струне до. Кодирование должно указать 8-разрядное кодирование.

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

    Неизменная строка, содержащая cStr (после того, как снятие изоляции NULL оконечный знак), или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

    Струна до является строкой 8-разрядных символов, завершенных с 8-разрядным NULL. Unichar и Unichar32 не считают струнами до.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCreateWithCStringNoCopy(_ alloc: CFAllocator!, _ cStr: UnsafePointer<Int8>, _ encoding: CFStringEncoding, _ contentsDeallocator: CFAllocator!) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithCStringNoCopy ( CFAllocatorRef alloc, const char *cStr, CFStringEncoding encoding, CFAllocatorRef contentsDeallocator );

    Параметры

    alloc

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

    cStr

    NULL- завершенная струна до, которая будет использоваться для создания объекта CFString. Строка должна использовать 8-разрядное кодирование.

    encoding

    Кодирование символов в струне до. Кодирование должно указать 8-разрядное кодирование.

    contentsDeallocator

    CFAllocator возражают для использования для освобождения внешнего строкового буфера, когда он больше не необходим. Можно передать NULL или kCFAllocatorDefault запрашивать средство выделения по умолчанию с этой целью. Если буфер не должен быть освобожден, или если Вы хотите принять на себя ответственность за освобождение буфера (и не иметь объект CFString, освобождают его), передача kCFAllocatorNull.

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

    Неизменная строка, содержащая cStr (после того, как снятие изоляции NULL оконечный знак), или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

    Струна до является строкой 8-разрядных символов, завершенных с 8-разрядным NULL. Unichar и Unichar32 не считают струнами до.

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

    Функция включает a contentsDeallocator параметр, с которым можно указать средство выделения для использования для освобождения внешнего буфера, когда освобожден объект CFString. Если Вы хотите принять на себя ответственность за освобождение этой памяти, указать kCFAllocatorNull для этого параметра.

    Если во время создания объект CFString решает, что это не может использовать буфер, и функция указывает a contentsDeallocator средство выделения, это будет использовать это средство выделения для освобождения буфера в то время.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Objective C

    CFStringRef CFStringCreateWithFormat ( CFAllocatorRef alloc, CFDictionaryRef formatOptions, CFStringRef format, ... );

    Параметры

    alloc

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

    formatOptions

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

    format

    Отформатированная строка с printf- спецификаторы стиля. Для получения информации о поддерживаемых спецификаторах посмотрите Спецификаторы Формата строки.

    ...

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

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

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

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

    Objective C

    @import CoreFoundation;

    Доступность

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

  • Создает неизменную строку из отформатированной строки и переменного числа параметров (указанный в параметре типа va_list).

    Объявление

    Swift

    func CFStringCreateWithFormatAndArguments(_ alloc: CFAllocator!, _ formatOptions: CFDictionary!, _ format: CFString!, _ arguments: CVaListPointer) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithFormatAndArguments ( CFAllocatorRef alloc, CFDictionaryRef formatOptions, CFStringRef format, va_list arguments );

    Параметры

    alloc

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

    formatOptions

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

    format

    Отформатированная строка с printf- спецификаторы стиля. Для получения информации о поддерживаемых спецификаторах посмотрите Спецификаторы Формата строки.

    arguments

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

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

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

    Обсуждение

    Интерфейс программирования для списков аргумента переменной (va_list, va_start, va_end, и т.д), объявляется в стандарте C заголовочным файлом stdarg.h.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает неизменный объект CFString из строки Паскаля.

    Объявление

    Swift

    func CFStringCreateWithPascalString(_ alloc: CFAllocator!, _ pStr: ConstStr255Param, _ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithPascalString ( CFAllocatorRef alloc, ConstStr255Param pStr, CFStringEncoding encoding );

    Параметры

    alloc

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

    pStr

    Строка Паскаля, которая будет использоваться для создания строки.

    encoding

    Кодирование символов в строке Паскаля.

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

    Неизменная строка, содержащая pStr, или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

    Эта функция создает неизменный CFString объекты из символьного содержания строки Паскаля (после снятия изоляции с начального байта длины).

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCreateWithPascalStringNoCopy(_ alloc: CFAllocator!, _ pStr: ConstStr255Param, _ encoding: CFStringEncoding, _ contentsDeallocator: CFAllocator!) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithPascalStringNoCopy ( CFAllocatorRef alloc, ConstStr255Param pStr, CFStringEncoding encoding, CFAllocatorRef contentsDeallocator );

    Параметры

    alloc

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

    pStr

    Строка Паскаля, которая будет использоваться для создания строки.

    encoding

    Кодирование символов в строке Паскаля.

    contentsDeallocator

    CFAllocator возражают для использования для освобождения внешнего строкового буфера, когда он больше не необходим. Передача NULL или kCFAllocatorDefault запрашивать средство выделения по умолчанию с этой целью. Если буфер не должен быть освобожден, или если Вы хотите принять на себя ответственность за освобождение буфера (и не иметь строку, освобождают его), передача kCFAllocatorNull.

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

    Неизменная строка, содержащая pStr, или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

    Эта функция создает неизменный CFString объекты из символьного содержания строки Паскаля (после снятия изоляции с начального байта длины).

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

    Функция включает a contentsDeallocator параметр, с которым можно указать средство выделения для использования для освобождения внешнего буфера, когда освобождена строка. Если Вы хотите принять на себя ответственность за освобождение этой памяти, указать kCFAllocatorNull для этого параметра.

    Если во время создания строка решает, что это не может использовать буфер, и существует средство выделения, указанное в contentsDeallocator параметр, это будет использовать это средство выделения для освобождения буфера в то время.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает неизменную строку из сегмента (подстрока) существующей строки.

    Объявление

    Swift

    func CFStringCreateWithSubstring(_ alloc: CFAllocator!, _ str: CFString!, _ range: CFRange) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithSubstring ( CFAllocatorRef alloc, CFStringRef str, CFRange range );

    Параметры

    alloc

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

    str

    Строка, из которой можно создать новую строку.

    range

    Диапазон символов в str скопировать. Указанный диапазон не должен превышать длину строки.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCreateArrayWithFindResults(_ alloc: CFAllocator!, _ theString: CFString!, _ stringToFind: CFString!, _ rangeToSearch: CFRange, _ compareOptions: CFStringCompareFlags) -> CFArray!

    Objective C

    CFArrayRef CFStringCreateArrayWithFindResults ( CFAllocatorRef alloc, CFStringRef theString, CFStringRef stringToFind, CFRange rangeToSearch, CFStringCompareFlags compareOptions );

    Параметры

    alloc

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

    theString

    Строка, в которой можно искать stringToFind.

    stringToFind

    Строка для поиска в theString.

    rangeToSearch

    Диапазон символов в theString искаться. Указанный диапазон не должен превышать длину строки.

    compareOptions

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

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

    Массив, содержащий указатели на CFRange структуры, идентифицирующие символьные расположения stringToFind в theString. Возвраты NULL, если была проблема, создающая массив, если никакая подстрока соответствия не найдена в исходном объекте, или. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Поиски подстроки в строке и, если это найдено, приводят к диапазону подстроки в символах объекта.

    Объявление

    Swift

    func CFStringFind(_ theString: CFString!, _ stringToFind: CFString!, _ compareOptions: CFStringCompareFlags) -> CFRange

    Objective C

    CFRange CFStringFind ( CFStringRef theString, CFStringRef stringToFind, CFStringCompareFlags compareOptions );

    Параметры

    theString

    Строка, в которой можно искать stringToFind.

    stringToFind

    Строка для поиска в theString.

    compareOptions

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

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

    Диапазон расположенной подстроки в theString. Если соответствие не расположено, возвращенный CFRange структура будет иметь расположение kCFNotFound и длина 0 (любого из которых достаточно для указания отказа).

    Обсуждение

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Запросите диапазон первого символа, содержавшегося в указанном наборе символов.

    Объявление

    Swift

    func CFStringFindCharacterFromSet(_ theString: CFString!, _ theSet: CFCharacterSet!, _ rangeToSearch: CFRange, _ searchOptions: CFStringCompareFlags, _ result: UnsafeMutablePointer<CFRange>) -> Boolean

    Objective C

    Boolean CFStringFindCharacterFromSet ( CFStringRef theString, CFCharacterSetRef theSet, CFRange rangeToSearch, CFStringCompareFlags searchOptions, CFRange *result );

    Параметры

    theString

    Строка для поиска.

    theSet

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

    rangeToSearch

    Диапазон символов в theString искать. Если расположение диапазона или конечная точка (определенный расположением плюс длина минус 1) вне индексного пространства строки (0 к N-1 включительно, где N длина строки), поведение не определено. Указанный диапазон не должен превышать длину строки. Если длина диапазона отрицательна, поведение не определено. Диапазон может быть пустым (длина 0), когда не выполняется никакой поиск.

    searchOptions

    Опция отмечает для управления поисковым поведением. Поддерживаемые опции kCFCompareBackwards и kCFCompareAnchored. Если другие флаги опции указаны, поведение не определено.

    result

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

    Можно передать NULL если Вам не нужен этот результат.

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

    true если символ в наборе символов найден и result заполнено, false иначе.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringFindWithOptions(_ theString: CFString!, _ stringToFind: CFString!, _ rangeToSearch: CFRange, _ searchOptions: CFStringCompareFlags, _ result: UnsafeMutablePointer<CFRange>) -> Boolean

    Objective C

    Boolean CFStringFindWithOptions ( CFStringRef theString, CFStringRef stringToFind, CFRange rangeToSearch, CFStringCompareFlags searchOptions, CFRange *result );

    Параметры

    theString

    Строка та, в который к искать stringToFind.

    stringToFind

    Подстрока для поиска в theString.

    rangeToSearch

    Диапазон символов для поиска в theString. Указанный диапазон не должен превышать длину строки.

    searchOptions

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

    result

    По возврату, если функциональный результат true, содержит стартовое расположение и длину найденной подстроки. Можно передать NULL если Вы только хотите знать, существует ли подстрока в большей строке.

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

    true если подстрока была найдена, false иначе.

    Обсуждение

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringFindWithOptionsAndLocale(_ theString: CFString!, _ stringToFind: CFString!, _ rangeToSearch: CFRange, _ searchOptions: CFStringCompareFlags, _ locale: CFLocale!, _ result: UnsafeMutablePointer<CFRange>) -> Boolean

    Objective C

    Boolean CFStringFindWithOptionsAndLocale ( CFStringRef theString, CFStringRef stringToFind, CFRange rangeToSearch, CFStringCompareFlags searchOptions, CFLocaleRef locale, CFRange *result );

    Параметры

    theString

    Строка та, в который к искать stringToFind.

    stringToFind

    Подстрока для поиска в theString.

    rangeToSearch

    Диапазон символов для поиска в theString. Указанный диапазон не должен превышать длину строки.

    searchOptions

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

    locale

    Локаль для использования для поискового сравнения. NULL указывает каноническую локаль (возвращаемое значение от CFLocaleGetSystem).

    Параметр локали влияет на алгоритм проверки равенства. Например, для турецкой локали, нечувствительной к регистру, сравнивают соответствия «я» с «ı» (кодовая точка Unicode U+0131, латинский Маленький Dotless I), не нормальное, которое «я» изображаю.

    result

    По возврату, если функциональный результат true содержит стартовое расположение и длину найденной подстроки. Можно передать NULL если Вы только хотите знать если theString содержит stringToFind.

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

    true если подстрока была найдена, false иначе.

    Обсуждение

    Если stringToFind пустая строка (нулевая длина), ничто не найдено.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetLineBounds(_ theString: CFString!, _ range: CFRange, _ lineBeginIndex: UnsafeMutablePointer<CFIndex>, _ lineEndIndex: UnsafeMutablePointer<CFIndex>, _ contentsEndIndex: UnsafeMutablePointer<CFIndex>)

    Objective C

    void CFStringGetLineBounds ( CFStringRef theString, CFRange range, CFIndex *lineBeginIndex, CFIndex *lineEndIndex, CFIndex *contentsEndIndex );

    Параметры

    theString

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

    range

    Диапазон символов для рассмотрения. Указанный диапазон не должен превышать длину строки.

    lineBeginIndex

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

    lineEndIndex

    По возврату, индексу первого символа строки после указанного диапазона. Передача NULL если Вы не хотите этот результат.

    contentsEndIndex

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

    Обсуждение

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

    Для определения разделения строки функция ищет стандартные символы разделителя строк: возвраты каретки (CR и CRLF), переводы строки (LF), и строка Unicode и разделители абзацев. Три заключительных параметра функции косвенно возвращаются, в порядке, индексе первого символа, запускающего строку, индекс первого символа следующей строки (включая символы конца строки) и индекс последнего знака строки (исключая символы конца строки). Передача NULL для любого из этих параметров, если Вы не интересуетесь результатом.

    Определить число символов в строке:

    • Вычесть lineBeginIndex от lineEndIndex найти число символов в строке, включая разделители строки.

    • Вычесть lineBeginIndex от contentsEndIndex найти число символов в строке, исключая разделители строки.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Сравнивает одну строку с другой строкой.

    Объявление

    Swift

    func CFStringCompare(_ theString1: CFString!, _ theString2: CFString!, _ compareOptions: CFStringCompareFlags) -> CFComparisonResult

    Objective C

    CFComparisonResult CFStringCompare ( CFStringRef theString1, CFStringRef theString2, CFStringCompareFlags compareOptions );

    Параметры

    theString1

    Первая строка, которая будет использовать в сравнении.

    theString2

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

    compareOptions

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

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

    A Comparison Results значение, указывающее ли theString1 равно, меньше, чем, или больше, чем theString2.

    Обсуждение

    Можно влиять, как сравнение продолжается путем указания одного или более флагов опции в compareOptions. Не все опции сравнения в настоящее время реализуются.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCompareWithOptions(_ theString1: CFString!, _ theString2: CFString!, _ rangeToCompare: CFRange, _ compareOptions: CFStringCompareFlags) -> CFComparisonResult

    Objective C

    CFComparisonResult CFStringCompareWithOptions ( CFStringRef theString1, CFStringRef theString2, CFRange rangeToCompare, CFStringCompareFlags compareOptions );

    Параметры

    theString1

    Первая строка, которая будет использовать в сравнении.

    theString2

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

    rangeToCompare

    Диапазон символов в theString1 использоваться в сравнении с theString2. Для использования целой строки передайте диапазон CFRangeMake(0, CFStringGetLength(theString1)) или используйте CFStringCompare. Указанный диапазон не должен превышать длину строки.

    compareOptions

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

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

    A Comparison Results значение, указывающее ли theString1 равно, меньше, чем, или больше, чем theString2.

    Обсуждение

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringCompareWithOptionsAndLocale(_ theString1: CFString!, _ theString2: CFString!, _ rangeToCompare: CFRange, _ compareOptions: CFStringCompareFlags, _ locale: CFLocale!) -> CFComparisonResult

    Objective C

    CFComparisonResult CFStringCompareWithOptionsAndLocale ( CFStringRef theString1, CFStringRef theString2, CFRange rangeToCompare, CFStringCompareFlags compareOptions, CFLocaleRef locale );

    Параметры

    theString1

    Первая строка, которая будет использовать в сравнении.

    theString2

    Вторая строка для использования в сравнении. Полный спектр этой строки используется.

    rangeToCompare

    Диапазон символов в theString1 использоваться в сравнении с theString2. Для использования целой строки передайте диапазон CFRangeMake(0, CFStringGetLength(theString1)). Указанный диапазон не должен превышать границы строки.

    compareOptions

    Флаги, выбирающие различные типы сравнений, такие как нечувствительное к регистру сравнение и нелитеральное сравнение. Если Вы хотите поведение сравнения по умолчанию, передачу 0. Посмотрите Флаги Сравнения строк для доступных флагов. kCFCompareBackwards и kCFCompareAnchored не применимы.

    locale

    Локаль для использования для сравнения. NULL указывает каноническую локаль (возвращаемое значение от CFLocaleGetSystem). Параметр локали влияет и на алгоритмы равенства и упорядочивания. Например, в некоторых локалях, символы с диакритикой сразу упорядочиваются после основы; другие локали упорядочивают их после «z».

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

    A Comparison Results значение, указывающее ли theString1 равно, меньше, чем, или больше, чем theString2.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringHasPrefix(_ theString: CFString!, _ prefix: CFString!) -> Boolean

    Objective C

    Boolean CFStringHasPrefix ( CFStringRef theString, CFStringRef prefix );

    Параметры

    theString

    Строка для поиска.

    prefix

    Префикс для поиска.

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

    true если theString начинается prefix, false если иначе.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringHasSuffix(_ theString: CFString!, _ suffix: CFString!) -> Boolean

    Objective C

    Boolean CFStringHasSuffix ( CFStringRef theString, CFStringRef suffix );

    Параметры

    theString

    Строка, которая будет оценена.

    suffix

    Суффикс для поиска.

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

    true если theString концы с suffix, false иначе.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает “внешнее представление” объекта CFString, т.е. объекта CFData.

    Объявление

    Swift

    func CFStringCreateExternalRepresentation(_ alloc: CFAllocator!, _ theString: CFString!, _ encoding: CFStringEncoding, _ lossByte: UInt8) -> CFData!

    Objective C

    CFDataRef CFStringCreateExternalRepresentation ( CFAllocatorRef alloc, CFStringRef theString, CFStringEncoding encoding, UInt8 lossByte );

    Параметры

    alloc

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

    theString

    Строка для преобразования во внешнее представление.

    encoding

    Строковое кодирование для использования для внешнего представления.

    lossByte

    Символьное значение для присвоения к символам, которые не могут быть преобразованы в требуемое кодирование. Передача 0 если Вы хотите, чтобы преобразование остановило в первом такую ошибку; если это происходит, функциональные возвраты NULL.

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

    CFData возражает, что хранит символы объекта CFString как “внешнее представление”. Возвраты NULL если никакой байт потерь не был указан, и функция не могла бы преобразовать символы в указанное кодирование. Владение соблюдает Создать Правило.

    Обсуждение

    В форме объекта CFData строка может быть записана в диск как файл или отослана по сети. Если кодирование символов в объекте данных является Unicode, функция может вставить BOM (маркер порядка байтов) для указания порядка байтов. Однако представления создаются с кодированием констант kCFStringEncodingUTF16BE, kCFStringEncodingUTF16LE, kCFStringEncodingUTF32BE, и kCFStringEncodingUTF32LE не включайте BOM, потому что порядок байтов явно обозначен буквами «BE» (обратный порядок байтов) и «LE» (прямой порядок байтов).

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

    При создании внешнего представления от объекта CFMutableString это теряет эту характеристику переменчивости, когда это преобразовывается назад в объект CFString.

    CFStringCreateFromExternalRepresentation функциональные дополнения эта функция путем создания CFString возражают от “внешнего представления” объекту CFData.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetBytes(_ theString: CFString!, _ range: CFRange, _ encoding: CFStringEncoding, _ lossByte: UInt8, _ isExternalRepresentation: Boolean, _ buffer: UnsafeMutablePointer<UInt8>, _ maxBufLen: CFIndex, _ usedBufLen: UnsafeMutablePointer<CFIndex>) -> CFIndex

    Objective C

    CFIndex CFStringGetBytes ( CFStringRef theString, CFRange range, CFStringEncoding encoding, UInt8 lossByte, Boolean isExternalRepresentation, UInt8 *buffer, CFIndex maxBufLen, CFIndex *usedBufLen );

    Параметры

    theString

    Строка, на которую можно действовать.

    range

    Диапазон символов в theString обработать. Указанный диапазон не должен превышать длину строки.

    encoding

    Строковое кодирование символов для копирования в буфер байта. 8, 16, и 32-разрядные кодировки поддерживаются.

    lossByte

    Символ (например, '?'), которым нужно заменить символы, которые не могут быть преобразованы в указанное кодирование. Передача 0 если Вы не хотите, чтобы произошло преобразование с потерями.

    isExternalRepresentation

    true если Вы хотите результат быть во “внешнем представлении” формат, иначе false. Во “внешнем представлении” формат, результат может содержать порядок байтов указания маркера порядка байтов (BOM), и этой функции, возможно, придется выполнить свопинг байта.

    buffer

    Буфер байта, в который записаны преобразованные символы. Буфер может быть выделен на «куче» или штабеле. Передача NULL если Вы не хотите, чтобы преобразование имело место, но вместо этого хотело знать, успешно выполнится ли преобразование (функциональный результат больше, чем 0) и, если так, сколько байтов требуется (usedBufLen).

    maxBufLen

    Размер buffer и максимальное количество байтов, которые могут быть записаны в него.

    usedBufLen

    По возврату, числу преобразованных байтов фактически в buffer. Можно передать NULL если Вы не интересуетесь этой информацией.

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

    Число символов преобразовывается.

    Обсуждение

    Эта функция является основной функцией преобразования кодирования для объектов CFString. Как с другими функциями, получающими символьное содержание объектов CFString, это позволяет преобразование в поддерживаемое 8-разрядное кодирование. В отличие от большинства тех других функций, это также позволяет “преобразование с потерями”. Функция разрешает спецификацию “байта потерь” в параметре; если символ не может быть преобразован, этим символом заменяют и доходы преобразования. (С другими функциями преобразование останавливается в первой ошибке и сбоях работы.)

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

    Эта функция также обрабатывает любое необходимое манипулирование символьными данными во “внешнем представлении” формат. Этот формат делает данные переносимыми и персистентными (перезаписываемый диском); в Unicode это часто включает BOM (маркер порядка байтов), который указывает порядок байтов данных.

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает символ Unicode в указанном расположении в строке.

    Объявление

    Swift

    func CFStringGetCharacterAtIndex(_ theString: CFString!, _ idx: CFIndex) -> UniChar

    Objective C

    UniChar CFStringGetCharacterAtIndex ( CFStringRef theString, CFIndex idx );

    Параметры

    theString

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

    idx

    Позиция символа Unicode в CFString.

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

    Символ Unicode.

    Обсуждение

    Эта функция обычно вызывается в цикле, чтобы выбрать символы Unicode строки в последовательности или выбрать символ в известной позиции (сначала или в последний раз, например). Используя его в цикле может быть неэффективным, особенно с более длинными строками, поэтому рассмотреть CFStringGetCharacters функционируйте или встроенные буферные функции (CFStringInitInlineBuffer и CFStringGetCharacterFromInlineBuffer) как альтернативы.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetCharacters(_ theString: CFString!, _ range: CFRange, _ buffer: UnsafeMutablePointer<UniChar>)

    Objective C

    void CFStringGetCharacters ( CFStringRef theString, CFRange range, UniChar *buffer );

    Параметры

    theString

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

    range

    Диапазон символов для копирования. Указанный диапазон не должен превышать длину строки.

    buffer

    UniChar буфер длины range.length то, что Вы выделили на штабеле или «куче». По возврату буфер содержит требуемые символы Unicode.

    Обсуждение

    Используйте эту функцию для получения некоторых или всех символов Unicode, представленных объектом CFString. Если эта работа включает большое количество символов, вызов функции может быть дорогим с точки зрения памяти. Вместо этого Вы могли бы хотеть рассмотреть использование встроенных буферных функций CFStringInitInlineBuffer и CFStringGetCharacterFromInlineBuffer извлечь символы инкрементно.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Быстро получает указатель на содержание строки как буфер символов Unicode.

    Объявление

    Swift

    func CFStringGetCharactersPtr(_ theString: CFString!) -> UnsafePointer<UniChar>

    Objective C

    const UniChar * CFStringGetCharactersPtr ( CFStringRef theString );

    Параметры

    theString

    Строка, к содержанию которой Вы хотите получить доступ.

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

    Указатель на буфер символа Unicode, или NULL если внутренняя память theString не позволяет этому быть возвращенным эффективно.

    Обсуждение

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает символ Unicode в определенном расположении во встроенном буфере.

    Объявление

    Swift

    func CFStringGetCharacterFromInlineBuffer(_ buf: UnsafeMutablePointer<CFStringInlineBuffer>, _ idx: CFIndex) -> UniChar

    Objective C

    UniChar CFStringGetCharacterFromInlineBuffer ( CFStringInlineBuffer *buf, CFIndex idx );

    Параметры

    buf

    Инициализированный CFStringInlineBuffer структура, в которой сохранены символы. Необходимо инициализировать структуру с CFStringInitInlineBuffer функция.

    idx

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

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

    Символ Unicode, или 0 если указано расположение вне исходного диапазона.

    Обсуждение

    Этот функциональные доступы один из символов строки, записанной во встроенный буфер. Это обычно вызывают из цикла для доступа к каждому символу в буфере в последовательности. Необходимо инициализировать буфер с CFStringInitInlineBuffer функция. Встроенные буферные функции, вместе с CFStringInlineBuffer структура, предоставьте Вам доступ к символам объекта CFString. Метод для встроенного буферного доступа комбинирует удобство по одному символьного доступа с эффективностью объемного доступа.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetCString(_ theString: CFString!, _ buffer: UnsafeMutablePointer<Int8>, _ bufferSize: CFIndex, _ encoding: CFStringEncoding) -> Boolean

    Objective C

    Boolean CFStringGetCString ( CFStringRef theString, char *buffer, CFIndex bufferSize, CFStringEncoding encoding );

    Параметры

    theString

    Строка, к содержанию которой Вы хотите получить доступ.

    buffer

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

    Буфер должен быть достаточно большим для содержания преобразованных символов и a NUL разделитель. Например, если строка Toby, буфер должен быть по крайней мере 5 байтов длиной.

    bufferSize

    Длина buffer в байтах.

    encoding

    Строковое кодирование то, к который символьное содержание theString должен быть преобразован. Кодирование должно указать 8-разрядное кодирование.

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

    true на успех или false если сбои преобразования или предоставленный буфер являются слишком маленькими.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetCStringPtr(_ theString: CFString!, _ encoding: CFStringEncoding) -> UnsafePointer<Int8>

    Objective C

    const char * CFStringGetCStringPtr ( CFStringRef theString, CFStringEncoding encoding );

    Параметры

    theString

    Строка, к содержанию которой Вы хотите получить доступ.

    encoding

    Строковое кодирование то, к который символьное содержание theString должен быть преобразован. Кодирование должно указать 8-разрядное кодирование.

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

    Указатель на струну до или NULL если внутренняя память theString не позволяет этому быть возвращенным эффективно.

    Обсуждение

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает число (с точки зрения пар кода UTF-16) символов Unicode в строке.

    Объявление

    Swift

    func CFStringGetLength(_ theString: CFString!) -> CFIndex

    Objective C

    CFIndex CFStringGetLength ( CFStringRef theString );

    Параметры

    theString

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

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

    Число (с точки зрения UTF-16 кодируют пар) символов, сохраненных в theString.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Копирует символьное содержание объекта CFString к локальному строковому буферу Паскаля после преобразования символов к требуемому кодированию.

    Объявление

    Swift

    func CFStringGetPascalString(_ theString: CFString!, _ buffer: StringPtr, _ bufferSize: CFIndex, _ encoding: CFStringEncoding) -> Boolean

    Objective C

    Boolean CFStringGetPascalString ( CFStringRef theString, StringPtr buffer, CFIndex bufferSize, CFStringEncoding encoding );

    Параметры

    theString

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

    buffer

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

    bufferSize

    Длина локальной переменной buffer в байтах (составляющий байт длины).

    encoding

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

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

    true если работа успешно выполняется или false если сбои преобразования или предоставленный буфер являются слишком маленькими.

    Обсуждение

    Эта функция полезна при необходимости в собственной копии символьных данных объекта CFString как строка Паскаля. Можно также вызвать его как «резервную» работу когда предшествующий вызов к CFStringGetPascalStringPtr функциональные сбои.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetPascalStringPtr(_ theString: CFString!, _ encoding: CFStringEncoding) -> ConstStringPtr

    Objective C

    ConstStringPtr CFStringGetPascalStringPtr ( CFStringRef theString, CFStringEncoding encoding );

    Параметры

    theString

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

    encoding

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

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

    Указатель на Паскаль представляет буфер в виде строки или NULL если внутренняя память theString не позволяет этому быть возвращенным эффективно.

    Обсуждение

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetRangeOfComposedCharactersAtIndex(_ theString: CFString!, _ theIndex: CFIndex) -> CFRange

    Objective C

    CFRange CFStringGetRangeOfComposedCharactersAtIndex ( CFStringRef theString, CFIndex theIndex );

    Параметры

    theString

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

    theIndex

    Индекс символа содержится в составленной последовательности символов. Если индекс вне диапазона строки (0 к N-1 включительно, где N длина строки), поведение не определено.

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

    Диапазон составленной последовательности символов.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringInitInlineBuffer(_ str: CFString!, _ buf: UnsafeMutablePointer<CFStringInlineBuffer>, _ range: CFRange)

    Objective C

    void CFStringInitInlineBuffer ( CFStringRef str, CFStringInlineBuffer *buf, CFRange range );

    Параметры

    str

    Строка для копирования во встроенный буфер.

    buf

    (Неинициализированный) CFStringInlineBuffer структура для инициализации. По возврату, инициализированная структура, которая может использоваться в a CFStringGetCharacterFromInlineBuffer вызов функции. Обычно этот буфер выделяется на штабеле.

    range

    Диапазон символов в str скопировать в buf. Указанный диапазон не должен превышать длину строки.

    Обсуждение

    Эта функция инициализирует CFStringInlineBuffer структура, которая может использоваться для доступа к символам строки. Как только буфер инициализируется, можно вызвать CFStringGetCharacterFromInlineBuffer функционируйте для доступа к символам в буфере по одному. Встроенные буферные функции, вместе с CFStringInlineBuffer структура, предоставьте Вам доступ к символам строки. Метод для встроенного буферного доступа комбинирует удобство по одному символьного доступа с эффективностью объемного доступа.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetHyphenationLocationBeforeIndex(_ string: CFString!, _ location: CFIndex, _ limitRange: CFRange, _ options: CFOptionFlags, _ locale: CFLocale!, _ character: UnsafeMutablePointer<UTF32Char>) -> CFIndex

    Objective C

    CFIndex CFStringGetHyphenationLocationBeforeIndex ( CFStringRef string, CFIndex location, CFRange limitRange, CFOptionFlags options, CFLocaleRef locale, UTF32Char *character );

    Параметры

    string

    Строка, которая будет написана через дефис. Если этот параметр не является допустимым объектом CFString, поведение не определено.

    location

    Индекс в строке. Если допустимый индекс дефиса будет возвращен, то это будет перед этим индексом.

    limitRange

    Диапазон символов в строке для поиска. Если расположение диапазона или конечная точка (определенный расположением плюс длина минус 1) вне индексного пространства строки (0 к N-1 включительно, где N является длиной строки), поведение не определено. Если длина диапазона отрицательна, поведение не определено. Диапазон может быть пустым (длина 0), когда не сгенерировано никакое расположение дефиса.

    options

    Зарезервированный для будущего использования.

    locale

    Допустимая локаль, указывающая который соглашения расстановки переносов языка использовать. Данные расстановки переносов не доступны для всех локалей. Можно использовать CFStringIsHyphenationAvailableForLocale протестировать на доступность данных расстановки переносов.

    character

    Предложенный символ дефиса для вставки. Передача NULL если Вам не нужна эта информация.

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

    Индекс в строке, где является надлежащим вставить дефис, если Вы существуете; иначе, kCFNotFound.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringIsHyphenationAvailableForLocale(_ locale: CFLocale!) -> Boolean

    Objective C

    Boolean CFStringIsHyphenationAvailableForLocale ( CFLocaleRef locale );

    Параметры

    locale

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringConvertEncodingToIANACharSetName(_ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFStringConvertEncodingToIANACharSetName ( CFStringEncoding encoding );

    Параметры

    encoding

    Базовое строковое кодирование Основы для использования.

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

    Имя IANA «набор символов», который является самым близким отображением на encoding. Возвраты NULL если не распознано кодирование.

    Обсуждение

    CFStringConvertIANACharSetNameToEncoding функция дополнительна к этой функции.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringConvertEncodingToNSStringEncoding(_ encoding: CFStringEncoding) -> UInt

    Objective C

    unsigned long CFStringConvertEncodingToNSStringEncoding ( CFStringEncoding encoding );

    Параметры

    encoding

    Базовое строковое кодирование Основы для использования.

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

    Кодирование Какао (типа NSStringEncoding) это является самым близким к Базовому кодированию Основы encoding. Если недопустимое строковое кодирование передается, поведение не определено.

    Обсуждение

    CFStringConvertNSStringEncodingToEncoding функция дополнительна к этой функции.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringConvertEncodingToWindowsCodepage(_ encoding: CFStringEncoding) -> UInt32

    Objective C

    UInt32 CFStringConvertEncodingToWindowsCodepage ( CFStringEncoding encoding );

    Параметры

    encoding

    Базовое строковое кодирование Основы для использования.

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

    Значение кодовой страницы Windows, которое является самым близким к Базовому кодированию Основы encoding. Если недопустимое строковое кодирование передается, поведение не определено.

    Обсуждение

    CFStringConvertWindowsCodepageToEncoding функция дополнительна к этой функции.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает Базовую Основу, кодирующую постоянный, который является самым близким отображением на данное имя «набора символов» реестра IANA.

    Объявление

    Swift

    func CFStringConvertIANACharSetNameToEncoding(_ IANAName: CFString!) -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringConvertIANACharSetNameToEncoding ( CFStringRef theString );

    Параметры

    IANAName

    Имя «набора символов» IANA к использованию.

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

    Базовая строка Основы, кодирующая, который является самым близким к IANA «набор символов» IANAName. Возвраты kCFStringEncodingInvalidId постоянный, если не распознано имя.

    Обсуждение

    CFStringConvertEncodingToIANACharSetName функция дополнительна к этой функции.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringConvertNSStringEncodingToEncoding(_ encoding: UInt) -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringConvertNSStringEncodingToEncoding ( unsigned long encoding );

    Параметры

    encoding

    Строковое кодирование Какао (типа NSStringEncoding) использовать.

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

    Базовая строка Основы, кодирующая, который является самым близким к строковому кодированию Какао encoding. Возвраты kCFStringEncodingInvalidId постоянный, если не известно отображение.

    Обсуждение

    CFStringConvertEncodingToNSStringEncoding функция дополнительна к этой функции.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringConvertWindowsCodepageToEncoding(_ codepage: UInt32) -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringConvertWindowsCodepageToEncoding ( UInt32 codepage );

    Параметры

    codepage

    Идентификатор кодовой страницы Windows для использования.

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

    Базовая строка Основы, кодирующая, который является самым близким к идентификатору кодовой страницы Windows codepage. Возвраты kCFStringEncodingInvalidId постоянный, если не известно отображение.

    Обсуждение

    CFStringConvertEncodingToWindowsCodepage функция дополнительна к этой функции.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetFastestEncoding(_ theString: CFString!) -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringGetFastestEncoding ( CFStringRef theString );

    Параметры

    theString

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

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetListOfAvailableEncodings() -> UnsafePointer<CFStringEncoding>

    Objective C

    const CFStringEncoding * CFStringGetListOfAvailableEncodings ( void );

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

    Указатель на a kCFStringEncodingInvalidId- завершенный список enum константы, каждый тип CFStringEncoding.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetMaximumSizeForEncoding(_ length: CFIndex, _ encoding: CFStringEncoding) -> CFIndex

    Objective C

    CFIndex CFStringGetMaximumSizeForEncoding ( CFIndex length, CFStringEncoding encoding );

    Параметры

    length

    Число символов Unicode для оценки.

    encoding

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

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

    Максимальное количество байтов, которые могли потребоваться, чтобы представлять length число символов Unicode со строковым кодированием encoding. Число байтов, которых кодирование фактически заканчивает тем, что требовало при преобразовании любой определенной строки, могло быть меньше, чем это, но никогда.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает самое совместимое значение сценария Mac OS для данного входного кодирования.

    Объявление

    Swift

    func CFStringGetMostCompatibleMacStringEncoding(_ encoding: CFStringEncoding) -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringGetMostCompatibleMacStringEncoding ( CFStringEncoding encoding );

    Параметры

    encoding

    Кодирование, для которого Вы хотите найти совместимое значение сценария Mac OS.

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

    Самый совместимый сценарий Mac OS оценивает за encoding.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetNameOfEncoding(_ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFStringGetNameOfEncoding ( CFStringEncoding encoding );

    Параметры

    encoding

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

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

    Имя encoding; нелокализованный. Владение соблюдает Получить Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetSmallestEncoding(_ theString: CFString!) -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringGetSmallestEncoding ( CFStringRef theString );

    Параметры

    theString

    Строка, для которой можно найти самое маленькое кодирование.

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

    Строка, кодирующая, который имеет наименьшее представление theString.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetSystemEncoding() -> CFStringEncoding

    Objective C

    CFStringEncoding CFStringGetSystemEncoding ( void );

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

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

    Обсуждение

    Эта функция возвращает текстовое кодирование по умолчанию, используемое OS, когда это создает строки. В OS X это кодирование определяется предпочтительной установкой языка пользователя. Предпочтительный язык является первым языком, перечисленным в области International Установок системы.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringIsEncodingAvailable(_ encoding: CFStringEncoding) -> Boolean

    Objective C

    Boolean CFStringIsEncodingAvailable ( CFStringEncoding encoding );

    Параметры

    encoding

    Базовое строковое кодирование Основы для тестирования.

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

    true если кодирование доступно, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetDoubleValue(_ str: CFString!) -> Double

    Objective C

    double CFStringGetDoubleValue ( CFStringRef str );

    Параметры

    str

    Строка, представляющая двойное значение. Единственные допустимые символы являются символами цифры ASCII (ASCII 0x30 - 0x39), знак «плюс» (ASCII 0x2B), знак «минус» (ASCII 0x2D), и символ точки (ASCII 0x2E).

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

    double значение, представленное str, или 0.0 если существует ошибка сканирования (если строка содержит запрещенные символы или не представляет двойное значение).

    Обсуждение

    Рассмотрите следующий пример:

    • double val = CFStringGetDoubleValue(CFSTR("0.123"));

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetIntValue(_ str: CFString!) -> Int32

    Objective C

    SInt32 CFStringGetIntValue ( CFStringRef str );

    Параметры

    str

    Строка, представляющая значение целого числа со знаком. Единственные допустимые символы являются символами цифры ASCII (ASCII 0x30 - 0x39), знак «плюс» (ASCII 0x2B), знак «минус» (ASCII 0x2D), и символ точки (ASCII 0x2E).

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

    Значение целого числа со знаком, представленное str. Результат 0 если существует ошибка сканирования (если строка содержит запрещенные символы или не представляет целочисленное значение), или INT_MAX или INT_MIN если существует ошибка переполнения.

    Обсуждение

    Рассмотрите следующий пример:

    • SInt32 val = CFStringGetIntValue(CFSTR("-123"));

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Распечатывает атрибуты строки во время отладки.

    Объявление

    Swift

    func CFShowStr(_ str: CFString!)

    Objective C

    void CFShowStr ( CFStringRef str );

    Параметры

    str

    Строка, атрибуты которой Вы хотите распечатать.

    Обсуждение

    Используйте эту функцию для приобретения знаний об определенных атрибутах объекта CFString во время отладки. Эти атрибуты включают следующее:

    • Длина (в символах Unicode)

    • Было ли первоначально это 8-разрядной строкой и, если так, было ли это C (HasNullByte) или Паскаль (HasLengthByte) строка

    • Является ли это непостоянным или неизменным объектом

    • Средство выделения раньше создавало его

    • Адрес памяти символьного содержания и встроено ли то содержание

    Информация, предоставленная этой функцией, для отладки целей только. Значения любого из этих атрибутов могли бы измениться между различными выпусками и на различных платформах. Отметьте в частности, что эта функция не показывает содержание строки. Если Вы хотите вывести на экран содержание строки, использовать CFShow.

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

    Можно использовать CFShowStr одним из двух общих способов. Если Ваш отладчик поддерживает вызовы функции (такой как gdb делает), вызвать CFShowStr в отладчике:

    • (gdb) call (void) CFShowStr(string)
    • Length 11
    • IsEightBit 1
    • HasLengthByte 1
    • HasNullByte 1
    • InlineContents 1
    • Allocator SystemDefault
    • Mutable 0
    • Contents 0x4e7c0

    Можно также включить вызовы к CFShowStr в тестовой версии Вашего кода для печати описаний CFString возражает против консоли.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает идентификатор типа для непрозрачного типа CFString.

    Объявление

    Swift

    func CFStringGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CFStringGetTypeID ( void );

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

    Идентификатор типа для непрозрачного типа CFString.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает CFString из завершенного нулем представления файловой системы POSIX.

    Объявление

    Swift

    func CFStringCreateWithFileSystemRepresentation(_ alloc: CFAllocator!, _ buffer: UnsafePointer<Int8>) -> CFString!

    Objective C

    CFStringRef CFStringCreateWithFileSystemRepresentation ( CFAllocatorRef alloc, const char *buffer );

    Параметры

    alloc

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

    buffer

    Струна до, которую Вы хотите преобразовать.

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

    Представляющая строка buffer. Результат NULL если была проблема в создании строки (возможный, если преобразование приводит к сбою вследствие байтов в буфере не быть допустимой последовательностью байтов для надлежащей кодировки символов). Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Извлекает содержание строки как a NULL- завершенная 8-разрядная строка, подходящая для передачи POSIX APIs.

    Объявление

    Swift

    func CFStringGetFileSystemRepresentation(_ string: CFString!, _ buffer: UnsafeMutablePointer<Int8>, _ maxBufLen: CFIndex) -> Boolean

    Objective C

    Boolean CFStringGetFileSystemRepresentation ( CFStringRef string, char *buffer, CFIndex maxBufLen );

    Параметры

    string

    Строка для преобразования.

    buffer

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

    maxBufLen

    Максимальная длина буфера.

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

    true если правильно преобразовывается строка; false если преобразование перестало работать, или результаты не вписываются в буфер.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringGetMaximumSizeOfFileSystemRepresentation(_ string: CFString!) -> CFIndex

    Objective C

    CFIndex CFStringGetMaximumSizeOfFileSystemRepresentation ( CFStringRef string );

    Параметры

    string

    Строка для преобразования.

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

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

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Учитывая диапазон символов в строке, получает границы абзаца — т.е. индексы первого символа и последние символы абзаца (ев), содержащего диапазон.

    Объявление

    Swift

    func CFStringGetParagraphBounds(_ theString: CFString!, _ range: CFRange, _ parBeginIndex: UnsafeMutablePointer<CFIndex>, _ parEndIndex: UnsafeMutablePointer<CFIndex>, _ contentsEndIndex: UnsafeMutablePointer<CFIndex>)

    Objective C

    void CFStringGetParagraphBounds ( CFStringRef string, CFRange range, CFIndex *parBeginIndex, CFIndex *parEndIndex, CFIndex *contentsEndIndex );

    Параметры

    theString

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

    range

    Диапазон символов для рассмотрения. Указанный диапазон не должен превышать длину строки.

    parBeginIndex

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

    parEndIndex

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

    contentsEndIndex

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

    Обсуждение

    Эта функция совпадает с CFStringGetLineBounds(), однако это только ищет абзацы (т.е. это не останавливается в символах Unicode NextLine или LineSeparator).

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

    Для определения разделения строки функция ищет стандартные символы разделителя абзацев: возвраты каретки (CR и CRLF), переводы строки (LF) и разделители абзацев Unicode. Три заключительных параметра функции косвенно возвращаются, в порядке, индексе первого символа, запускающего строку, индекс первого символа следующей строки (включая символы конца строки) и индекс последнего знака строки (исключая символы конца строки). Передача NULL для любого из этих параметров, если Вы не интересуетесь результатом.

    Определить число символов в абзаце:

    • Вычесть parBeginIndex от parEndIndex найти число символов в абзаце, включая разделители абзацев.

    • Вычесть parBeginIndex от contentsEndIndex найти число символов в абзаце, исключая разделители абзацев.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает символ UTF-32, соответствующий данной паре суррогатных символов UTF-16.

    Объявление

    Swift

    func CFStringGetLongCharacterForSurrogatePair(_ surrogateHigh: UniChar, _ surrogateLow: UniChar) -> UTF32Char

    Objective C

    UTF32Char CFStringGetLongCharacterForSurrogatePair ( UniChar surrogateHigh, UniChar surrogateLow );

    Параметры

    surrogateHigh

    Высокий суррогатный символ.

    surrogateLow

    Низкий суррогатный символ.

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

    UTF32Char, соответствующий комбинации surrogateHigh и surrogateLow.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Отображает данный символ UTF-32 на пару суррогатных символов UTF-16.

    Объявление

    Swift

    func CFStringGetSurrogatePairForLongCharacter(_ character: UTF32Char, _ surrogates: UnsafeMutablePointer<UniChar>) -> Boolean

    Objective C

    Boolean CFStringGetSurrogatePairForLongCharacter ( UTF32Char character, UniChar *surrogates );

    Параметры

    character

    Символ UTF-32.

    surrogates

    Буфер для содержания возвращенной суррогатной пары.

    Буфер должен иметь пространство по крайней мере для 2 символов UTF-16.

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

    true если character отображается на суррогатной паре, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringIsSurrogateHighCharacter(_ character: UniChar) -> Boolean

    Objective C

    Boolean CFStringIsSurrogateHighCharacter ( UniChar character );

    Параметры

    character

    Символ UTF-16.

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

    true если character высокий символ в суррогатной паре, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFStringIsSurrogateLowCharacter(_ character: UniChar) -> Boolean

    Objective C

    Boolean CFStringIsSurrogateLowCharacter ( UniChar character );

    Параметры

    character

    Символ UTF-16.

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

    true если character низкий символ в суррогатной паре, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Типы данных

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

  • Целый тип для констант раньше указывал поддерживаемые строковые кодировки в различных функциях CFString.

    Объявление

    Swift

    typealias CFStringEncoding = UInt32

    Objective C

    typedef UInt32 CFStringEncoding;

    Обсуждение

    Этот тип используется для определения констант для встроенных кодировок (см. Встроенные Строковые Кодировки для списка), и для зависимых от платформы кодировок (см. Внешние Строковые Кодировки). Если CFString не будет распознавать или поддерживать строковое кодирование определенной строки, то функции CFString идентифицируют кодирование строки как kCFStringEncodingInvalidId.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Индексный тип для констант раньше указывал внешние строковые кодировки.

    Объявление

    Swift

    enum CFStringEncodings : CFIndex { case MacJapanese case MacChineseTrad case MacKorean case MacArabic case MacHebrew case MacGreek case MacCyrillic case MacDevanagari case MacGurmukhi case MacGujarati case MacOriya case MacBengali case MacTamil case MacTelugu case MacKannada case MacMalayalam case MacSinhalese case MacBurmese case MacKhmer case MacThai case MacLaotian case MacGeorgian case MacArmenian case MacChineseSimp case MacTibetan case MacMongolian case MacEthiopic case MacCentralEurRoman case MacVietnamese case MacExtArabic case MacSymbol case MacDingbats case MacTurkish case MacCroatian case MacIcelandic case MacRomanian case MacCeltic case MacGaelic case MacFarsi case MacUkrainian case MacInuit case MacVT100 case MacHFS case ISOLatin2 case ISOLatin3 case ISOLatin4 case ISOLatinCyrillic case ISOLatinArabic case ISOLatinGreek case ISOLatinHebrew case ISOLatin5 case ISOLatin6 case ISOLatinThai case ISOLatin7 case ISOLatin8 case ISOLatin9 case ISOLatin10 case DOSLatinUS case DOSGreek case DOSBalticRim case DOSLatin1 case DOSGreek1 case DOSLatin2 case DOSCyrillic case DOSTurkish case DOSPortuguese case DOSIcelandic case DOSHebrew case DOSCanadianFrench case DOSArabic case DOSNordic case DOSRussian case DOSGreek2 case DOSThai case DOSJapanese case DOSChineseSimplif case DOSKorean case DOSChineseTrad case WindowsLatin2 case WindowsCyrillic case WindowsGreek case WindowsLatin5 case WindowsHebrew case WindowsArabic case WindowsBalticRim case WindowsVietnamese case WindowsKoreanJohab case ANSEL case JIS_X0201_76 case JIS_X0208_83 case JIS_X0208_90 case JIS_X0212_90 case JIS_C6226_78 case ShiftJIS_X0213 case ShiftJIS_X0213_MenKuTen case GB_2312_80 case GBK_95 case GB_18030_2000 case KSC_5601_87 case KSC_5601_92_Johab case CNS_11643_92_P1 case CNS_11643_92_P2 case CNS_11643_92_P3 case ISO_2022_JP case ISO_2022_JP_2 case ISO_2022_JP_1 case ISO_2022_JP_3 case ISO_2022_CN case ISO_2022_CN_EXT case ISO_2022_KR case EUC_JP case EUC_CN case EUC_TW case EUC_KR case ShiftJIS case KOI8_R case Big5 case MacRomanLatin1 case HZ_GB_2312 case Big5_HKSCS_1999 case VISCII case KOI8_U case Big5_E case NextStepJapanese case EBCDIC_US case EBCDIC_CP037 case UTF7 case UTF7_IMAP }

    Objective C

    typedef CFIndex CFStringEncodings;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • A CFOptionFlags введите для указания опций для сравнения строк.

    Объявление

    Swift

    struct CFStringCompareFlags : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var CompareCaseInsensitive: CFStringCompareFlags { get } static var CompareBackwards: CFStringCompareFlags { get } static var CompareAnchored: CFStringCompareFlags { get } static var CompareNonliteral: CFStringCompareFlags { get } static var CompareLocalized: CFStringCompareFlags { get } static var CompareNumerically: CFStringCompareFlags { get } static var CompareDiacriticInsensitive: CFStringCompareFlags { get } static var CompareWidthInsensitive: CFStringCompareFlags { get } static var CompareForcedOrdering: CFStringCompareFlags { get } }

    Objective C

    typedef CFOptionFlags CFStringCompareFlags;

    Обсуждение

    Посмотрите Флаги Сравнения строк для значений.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Определяет буферные и смежные области, используемые для встроенного буферного доступа символов в объектах CFString.

    Объявление

    Swift

    struct CFStringInlineBuffer { var buffer: (UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar) var theString: Unmanaged<CFString>! var directUniCharBuffer: UnsafePointer<UniChar> var directCStringBuffer: UnsafePointer<Int8> var rangeToBuffer: CFRange var bufferedRangeStart: CFIndex var bufferedRangeEnd: CFIndex init() init(buffer buffer: (UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar, UniChar), theString theString: Unmanaged<CFString>!, directUniCharBuffer directUniCharBuffer: UnsafePointer<UniChar>, directCStringBuffer directCStringBuffer: UnsafePointer<Int8>, rangeToBuffer rangeToBuffer: CFRange, bufferedRangeStart bufferedRangeStart: CFIndex, bufferedRangeEnd bufferedRangeEnd: CFIndex) }

    Objective C

    #define __kCFStringInlineBufferLength 64 typedef struct { UniChar buffer[__kCFStringInlineBufferLength]; CFStringRef theString; const UniChar *directBuffer; CFRange rangeToBuffer; CFIndex bufferedRangeStart; CFIndex bufferedRangeEnd; } CFStringInlineBuffer;

    Обсуждение

    Эта структура используется для встроенного буферного доступа символов, содержавших объектом CFString. Используйте CFStringInitInlineBuffer функция для инициализации полей этой структуры; не делайте этого вручную. Как только буфер инициализируется, используйте CFStringGetCharacterFromInlineBuffer функционируйте для доступа к символам от буфера. Не получайте доступ к полям непосредственно, поскольку они могли бы измениться между выпусками.

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

    Доступность

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

  • Ссылка на объект CFString.

    Объявление

    Swift

    typealias CFStringRef = CFString

    Objective C

    typedef const struct __CFString *CFStringRef;

    Обсуждение

    CFStringRef тип относится к объекту CFString, «инкапсулирующему» Unicode, следуют за его длиной. CFString является непрозрачным типом, определяющим характеристики и поведение объектов CFString.

    Значения типа CFStringRef может относиться к неизменным или непостоянным строкам, поскольку объекты CFMutableString реагируют на все функции, предназначенные для неизменных объектов CFString. Принимающие функции CFStringRef значения, и который должен держаться за значения неизменно, должны вызвать CFStringCreateCopy (вместо CFRetain) сделать так.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Константы

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

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

    Объявление

    Swift

    struct CFStringCompareFlags : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var CompareCaseInsensitive: CFStringCompareFlags { get } static var CompareBackwards: CFStringCompareFlags { get } static var CompareAnchored: CFStringCompareFlags { get } static var CompareNonliteral: CFStringCompareFlags { get } static var CompareLocalized: CFStringCompareFlags { get } static var CompareNumerically: CFStringCompareFlags { get } static var CompareDiacriticInsensitive: CFStringCompareFlags { get } static var CompareWidthInsensitive: CFStringCompareFlags { get } static var CompareForcedOrdering: CFStringCompareFlags { get } }

    Objective C

    enum CFStringCompareFlags { kCFCompareCaseInsensitive = 1, kCFCompareBackwards = 4, kCFCompareAnchored = 8, kCFCompareNonliteral = 16, kCFCompareLocalized = 32, kCFCompareNumerically = 64, kCFCompareDiacriticInsensitive = 128, kCFCompareWidthInsensitive = 256, kCFCompareForcedOrdering = 512 };

    Константы

    • CompareCaseInsensitive

      kCFCompareCaseInsensitive

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

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

    • CompareBackwards

      kCFCompareBackwards

      Указывает, что сравнение должно запуститься в последних элементах сравниваемых объектов (например, строки или массивы).

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

    • CompareAnchored

      kCFCompareAnchored

      Выполняет поиск только на символах вначале или конце диапазона.

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

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

    • CompareNonliteral

      kCFCompareNonliteral

      Указывает, что свободная эквивалентность приемлема, тем более, что принадлежит диакритическим знакам.

      Например, «Ф» представленный как два отличных символа («o» и «умляут») эквивалентно «Ф», представленному отдельным символом («o-умляут»). Обратите внимание на то, что это не то же как диакритическая нечувствительность.

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

    • CompareLocalized

      kCFCompareLocalized

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

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

    • CompareNumerically

      kCFCompareNumerically

      Указывает, что представленные числовые значения должны использоваться в качестве основания для сравнения а не фактических символьных значений.

      Например, «версия 2» является меньше, чем «версия 10».

      Это сравнение не работает если kCFCompareLocalized указан в системах перед OS X v10.3.

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

    • CompareDiacriticInsensitive

      kCFCompareDiacriticInsensitive

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

      Например, «Ф» («o-умляут») эквивалентно «o».

      Диакритические маркеры определяются как все метки без интервалов ниже U+0510.

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

    • CompareWidthInsensitive

      kCFCompareWidthInsensitive

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

      Например, эквивалентного UFF41.

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

    • CompareForcedOrdering

      kCFCompareForcedOrdering

      Указывает, что сравнение вынуждено возвратиться также kCFCompareLessThan или kCFCompareGreaterThan если строки эквивалентны, но не строго равны.

      Вы используете эту опцию для устойчивости при сортировке (например, с kCFCompareCaseInsensitive указанный «aaa» больше, чем «AAA»).

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

    Обсуждение

    Эти константы являются флагами, предназначенными для использования в опциональных параметрах сравнения в функциях сравнения такой как CFStringCompare. Если Вы хотите запросить многократные опции, объединить их с работой битового «ИЛИ».

  • Кодировки, которые встроены на всех платформах, на которых работает OS X.

    Объявление

    Swift

    enum CFStringBuiltInEncodings : CFStringEncoding { case MacRoman case WindowsLatin1 case ISOLatin1 case NextStepLatin case ASCII case Unicode case UTF8 case NonLossyASCII case UTF16BE case UTF16LE case UTF32 case UTF32BE case UTF32LE }

    Objective C

    enum CFStringBuiltInEncodings { kCFStringEncodingMacRoman = 0, kCFStringEncodingWindowsLatin1 = 0x0500, kCFStringEncodingISOLatin1 = 0x0201, kCFStringEncodingNextStepLatin = 0x0B01, kCFStringEncodingASCII = 0x0600, kCFStringEncodingUnicode = 0x0100, kCFStringEncodingUTF8 = 0x08000100, kCFStringEncodingNonLossyASCII = 0x0BFF, kCFStringEncodingUTF16 = 0x0100, kCFStringEncodingUTF16BE = 0x10000100, kCFStringEncodingUTF16LE = 0x14000100, kCFStringEncodingUTF32 = 0x0c000100, kCFStringEncodingUTF32BE = 0x18000100, kCFStringEncodingUTF32LE = 0x1c000100 }; typedef enum CFStringBuiltInEncodings CFStringBuiltInEncodings;

    Константы

    • MacRoman

      kCFStringEncodingMacRoman

      Кодирование, постоянное, который идентифицирует Мак Романа, кодирующего.

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

    • WindowsLatin1

      kCFStringEncodingWindowsLatin1

      Кодирование, постоянное, который идентифицирует кодирование Windows Latin 1 (кодовая страница ANSI 1252).

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

    • ISOLatin1

      kCFStringEncodingISOLatin1

      Кодирование, постоянное, который идентифицирует латынь ISO 1 кодирование (ISO 8859-1)

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

    • NextStepLatin

      kCFStringEncodingNextStepLatin

      Кодирование, постоянное, который идентифицирует кодирование NextStep/OpenStep.

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

    • ASCII

      kCFStringEncodingASCII

      Кодирование, постоянное, который идентифицирует кодирование ASCII (десятичные значения 0 до 127).

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

    • Unicode

      kCFStringEncodingUnicode

      Кодирование, постоянное, который идентифицирует кодирование Unicode.

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

    • UTF8

      kCFStringEncodingUTF8

      Кодирование, постоянное, который идентифицирует кодирование UTF 8.

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

    • NonLossyASCII

      kCFStringEncodingNonLossyASCII

      Кодирование, постоянное, который идентифицирует кодирование ASCII нес потерями.

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

    • kCFStringEncodingUTF16

      Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF16Format кодирующий (псевдоним kCFStringEncodingUnicode).

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

    • UTF16BE

      kCFStringEncodingUTF16BE

      Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF16BEFormat кодирование. Эта константа указывает обратный порядок байтов.

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

    • UTF16LE

      kCFStringEncodingUTF16LE

      Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF16LEFormat кодирование. Эта константа указывает прямой порядок байтов.

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

    • UTF32

      kCFStringEncodingUTF32

      Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF32Format кодирование.

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

    • UTF32BE

      kCFStringEncodingUTF32BE

      Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF32BEFormat кодирование. Эта константа указывает обратный порядок байтов.

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

    • UTF32LE

      kCFStringEncodingUTF32LE

      Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF32LEFormat кодирование. Эта константа указывает прямой порядок байтов.

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    var kCFStringEncodingInvalidId: UInt32 { get }

    Objective C

    #define kCFStringEncodingInvalidId (0xffffffffU)

    Константы

    • kCFStringEncodingInvalidId

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

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

  • CFStringEncoding константы для кодировок, которые могут поддерживаться CFString.

    Объявление

    Swift

    enum CFStringEncodings : CFIndex { case MacJapanese case MacChineseTrad case MacKorean case MacArabic case MacHebrew case MacGreek case MacCyrillic case MacDevanagari case MacGurmukhi case MacGujarati case MacOriya case MacBengali case MacTamil case MacTelugu case MacKannada case MacMalayalam case MacSinhalese case MacBurmese case MacKhmer case MacThai case MacLaotian case MacGeorgian case MacArmenian case MacChineseSimp case MacTibetan case MacMongolian case MacEthiopic case MacCentralEurRoman case MacVietnamese case MacExtArabic case MacSymbol case MacDingbats case MacTurkish case MacCroatian case MacIcelandic case MacRomanian case MacCeltic case MacGaelic case MacFarsi case MacUkrainian case MacInuit case MacVT100 case MacHFS case ISOLatin2 case ISOLatin3 case ISOLatin4 case ISOLatinCyrillic case ISOLatinArabic case ISOLatinGreek case ISOLatinHebrew case ISOLatin5 case ISOLatin6 case ISOLatinThai case ISOLatin7 case ISOLatin8 case ISOLatin9 case ISOLatin10 case DOSLatinUS case DOSGreek case DOSBalticRim case DOSLatin1 case DOSGreek1 case DOSLatin2 case DOSCyrillic case DOSTurkish case DOSPortuguese case DOSIcelandic case DOSHebrew case DOSCanadianFrench case DOSArabic case DOSNordic case DOSRussian case DOSGreek2 case DOSThai case DOSJapanese case DOSChineseSimplif case DOSKorean case DOSChineseTrad case WindowsLatin2 case WindowsCyrillic case WindowsGreek case WindowsLatin5 case WindowsHebrew case WindowsArabic case WindowsBalticRim case WindowsVietnamese case WindowsKoreanJohab case ANSEL case JIS_X0201_76 case JIS_X0208_83 case JIS_X0208_90 case JIS_X0212_90 case JIS_C6226_78 case ShiftJIS_X0213 case ShiftJIS_X0213_MenKuTen case GB_2312_80 case GBK_95 case GB_18030_2000 case KSC_5601_87 case KSC_5601_92_Johab case CNS_11643_92_P1 case CNS_11643_92_P2 case CNS_11643_92_P3 case ISO_2022_JP case ISO_2022_JP_2 case ISO_2022_JP_1 case ISO_2022_JP_3 case ISO_2022_CN case ISO_2022_CN_EXT case ISO_2022_KR case EUC_JP case EUC_CN case EUC_TW case EUC_KR case ShiftJIS case KOI8_R case Big5 case MacRomanLatin1 case HZ_GB_2312 case Big5_HKSCS_1999 case VISCII case KOI8_U case Big5_E case NextStepJapanese case EBCDIC_US case EBCDIC_CP037 case UTF7 case UTF7_IMAP }

    Objective C

    enum { kCFStringEncodingMacRoman = 0L, kCFStringEncodingMacJapanese = 1, kCFStringEncodingMacChineseTrad = 2, kCFStringEncodingMacKorean = 3, kCFStringEncodingMacArabic = 4, kCFStringEncodingMacHebrew = 5, kCFStringEncodingMacGreek = 6, kCFStringEncodingMacCyrillic = 7, kCFStringEncodingMacDevanagari = 9, kCFStringEncodingMacGurmukhi = 10, kCFStringEncodingMacGujarati = 11, kCFStringEncodingMacOriya = 12, kCFStringEncodingMacBengali = 13, kCFStringEncodingMacTamil = 14, kCFStringEncodingMacTelugu = 15, kCFStringEncodingMacKannada = 16, kCFStringEncodingMacMalayalam = 17, kCFStringEncodingMacSinhalese = 18, kCFStringEncodingMacBurmese = 19, kCFStringEncodingMacKhmer = 20, kCFStringEncodingMacThai = 21, kCFStringEncodingMacLaotian = 22, kCFStringEncodingMacGeorgian = 23, kCFStringEncodingMacArmenian = 24, kCFStringEncodingMacChineseSimp = 25, kCFStringEncodingMacTibetan = 26, kCFStringEncodingMacMongolian = 27, kCFStringEncodingMacEthiopic = 28, kCFStringEncodingMacCentralEurRoman = 29, kCFStringEncodingMacVietnamese = 30, kCFStringEncodingMacExtArabic = 31, kCFStringEncodingMacSymbol = 33, kCFStringEncodingMacDingbats = 34, kCFStringEncodingMacTurkish = 35, kCFStringEncodingMacCroatian = 36, kCFStringEncodingMacIcelandic = 37, kCFStringEncodingMacRomanian = 38, kCFStringEncodingMacCeltic = 39, kCFStringEncodingMacGaelic = 40, kCFStringEncodingMacFarsi = 0x8C, kCFStringEncodingMacUkrainian = 0x98, kCFStringEncodingMacInuit = 0xEC, kCFStringEncodingMacVT100 = 0xFC, kCFStringEncodingMacHFS = 0xFF, kCFStringEncodingISOLatin1 = 0x0201, kCFStringEncodingISOLatin2 = 0x0202, kCFStringEncodingISOLatin3 = 0x0203, kCFStringEncodingISOLatin4 = 0x0204, kCFStringEncodingISOLatinCyrillic = 0x0205, kCFStringEncodingISOLatinArabic = 0x0206, kCFStringEncodingISOLatinGreek = 0x0207, kCFStringEncodingISOLatinHebrew = 0x0208, kCFStringEncodingISOLatin5 = 0x0209, kCFStringEncodingISOLatin6 = 0x020A, kCFStringEncodingISOLatinThai = 0x020B, kCFStringEncodingISOLatin7 = 0x020D, kCFStringEncodingISOLatin8 = 0x020E, kCFStringEncodingISOLatin9 = 0x020F, kCFStringEncodingISOLatin10 = 0x0210, kCFStringEncodingDOSLatinUS = 0x0400, kCFStringEncodingDOSGreek = 0x0405, kCFStringEncodingDOSBalticRim = 0x0406, kCFStringEncodingDOSLatin1 = 0x0410, kCFStringEncodingDOSGreek1 = 0x0411, kCFStringEncodingDOSLatin2 = 0x0412, kCFStringEncodingDOSCyrillic = 0x0413, kCFStringEncodingDOSTurkish = 0x0414, kCFStringEncodingDOSPortuguese = 0x0415, kCFStringEncodingDOSIcelandic = 0x0416, kCFStringEncodingDOSHebrew = 0x0417, kCFStringEncodingDOSCanadianFrench = 0x0418, kCFStringEncodingDOSArabic = 0x0419, kCFStringEncodingDOSNordic = 0x041A, kCFStringEncodingDOSRussian = 0x041B, kCFStringEncodingDOSGreek2 = 0x041C, kCFStringEncodingDOSThai = 0x041D, kCFStringEncodingDOSJapanese = 0x0420, kCFStringEncodingDOSChineseSimplif = 0x0421, kCFStringEncodingDOSKorean = 0x0422, kCFStringEncodingDOSChineseTrad = 0x0423, kCFStringEncodingWindowsLatin1 = 0x0500, kCFStringEncodingWindowsLatin2 = 0x0501, kCFStringEncodingWindowsCyrillic = 0x0502, kCFStringEncodingWindowsGreek = 0x0503, kCFStringEncodingWindowsLatin5 = 0x0504, kCFStringEncodingWindowsHebrew = 0x0505, kCFStringEncodingWindowsArabic = 0x0506, kCFStringEncodingWindowsBalticRim = 0x0507, kCFStringEncodingWindowsVietnamese = 0x0508, kCFStringEncodingWindowsKoreanJohab = 0x0510, kCFStringEncodingASCII = 0x0600, kCFStringEncodingANSEL = 0x0601, kCFStringEncodingJIS_X0201_76 = 0x0620, kCFStringEncodingJIS_X0208_83 = 0x0621, kCFStringEncodingJIS_X0208_90 = 0x0622, kCFStringEncodingJIS_X0212_90 = 0x0623, kCFStringEncodingJIS_C6226_78 = 0x0624, kCFStringEncodingShiftJIS_X0213 = 0x0628, kCFStringEncodingShiftJIS_X0213_MenKuTen = 0x0629, kCFStringEncodingGB_2312_80 = 0x0630, kCFStringEncodingGBK_95 = 0x0631, kCFStringEncodingGB_18030_2000 = 0x0632, kCFStringEncodingKSC_5601_87 = 0x0640, kCFStringEncodingKSC_5601_92_Johab = 0x0641, kCFStringEncodingCNS_11643_92_P1 = 0x0651, kCFStringEncodingCNS_11643_92_P2 = 0x0652, kCFStringEncodingCNS_11643_92_P3 = 0x0653, kCFStringEncodingISO_2022_JP = 0x0820, kCFStringEncodingISO_2022_JP_2 = 0x0821, kCFStringEncodingISO_2022_JP_1 = 0x0822, kCFStringEncodingISO_2022_JP_3 = 0x0823, kCFStringEncodingISO_2022_CN = 0x0830, kCFStringEncodingISO_2022_CN_EXT = 0x0831, kCFStringEncodingISO_2022_KR = 0x0840, kCFStringEncodingEUC_JP = 0x0920, kCFStringEncodingEUC_CN = 0x0930, kCFStringEncodingEUC_TW = 0x0931, kCFStringEncodingEUC_KR = 0x0940, kCFStringEncodingShiftJIS = 0x0A01, kCFStringEncodingKOI8_R = 0x0A02, kCFStringEncodingBig5 = 0x0A03, kCFStringEncodingMacRomanLatin1 = 0x0A04, kCFStringEncodingHZ_GB_2312 = 0x0A05, kCFStringEncodingBig5_HKSCS_1999 = 0x0A06, kCFStringEncodingVISCII = 0x0A07, kCFStringEncodingKOI8_U = 0x0A08, kCFStringEncodingBig5_E = 0x0A09, kCFStringEncodingNextStepLatin = 0x0B01, kCFStringEncodingNextStepJapanese = 0x0B02, kCFStringEncodingEBCDIC_US = 0x0C01, kCFStringEncodingEBCDIC_CP037 = 0x0C02, kCFStringEncodingUTF7 = 0x04000100, kCFStringEncodingUTF7_IMAP = 0x0A10, kCFStringEncodingShiftJIS_X0213_00 = 0x0628 /* Deprecated */ };

    Константы

    • MacJapanese

      kCFStringEncodingMacJapanese

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

    • MacChineseTrad

      kCFStringEncodingMacChineseTrad

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

    • MacKorean

      kCFStringEncodingMacKorean

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

    • MacArabic

      kCFStringEncodingMacArabic

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

    • MacHebrew

      kCFStringEncodingMacHebrew

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

    • MacGreek

      kCFStringEncodingMacGreek

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

    • MacCyrillic

      kCFStringEncodingMacCyrillic

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

    • MacDevanagari

      kCFStringEncodingMacDevanagari

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

    • MacGurmukhi

      kCFStringEncodingMacGurmukhi

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

    • MacGujarati

      kCFStringEncodingMacGujarati

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

    • MacOriya

      kCFStringEncodingMacOriya

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

    • MacBengali

      kCFStringEncodingMacBengali

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

    • MacTamil

      kCFStringEncodingMacTamil

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

    • MacTelugu

      kCFStringEncodingMacTelugu

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

    • MacKannada

      kCFStringEncodingMacKannada

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

    • MacMalayalam

      kCFStringEncodingMacMalayalam

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

    • MacSinhalese

      kCFStringEncodingMacSinhalese

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

    • MacBurmese

      kCFStringEncodingMacBurmese

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

    • MacKhmer

      kCFStringEncodingMacKhmer

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

    • MacThai

      kCFStringEncodingMacThai

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

    • MacLaotian

      kCFStringEncodingMacLaotian

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

    • MacGeorgian

      kCFStringEncodingMacGeorgian

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

    • MacArmenian

      kCFStringEncodingMacArmenian

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

    • MacChineseSimp

      kCFStringEncodingMacChineseSimp

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

    • MacTibetan

      kCFStringEncodingMacTibetan

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

    • MacMongolian

      kCFStringEncodingMacMongolian

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

    • MacEthiopic

      kCFStringEncodingMacEthiopic

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

    • MacCentralEurRoman

      kCFStringEncodingMacCentralEurRoman

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

    • MacVietnamese

      kCFStringEncodingMacVietnamese

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

    • MacExtArabic

      kCFStringEncodingMacExtArabic

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

    • MacSymbol

      kCFStringEncodingMacSymbol

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

    • MacDingbats

      kCFStringEncodingMacDingbats

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

    • MacTurkish

      kCFStringEncodingMacTurkish

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

    • MacCroatian

      kCFStringEncodingMacCroatian

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

    • MacIcelandic

      kCFStringEncodingMacIcelandic

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

    • MacRomanian

      kCFStringEncodingMacRomanian

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

    • MacCeltic

      kCFStringEncodingMacCeltic

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

    • MacGaelic

      kCFStringEncodingMacGaelic

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

    • MacFarsi

      kCFStringEncodingMacFarsi

      Как Макарабик, но цифры фарси использования.

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

    • MacUkrainian

      kCFStringEncodingMacUkrainian

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

    • MacInuit

      kCFStringEncodingMacInuit

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

    • MacVT100

      kCFStringEncodingMacVT100

      Шрифт VT100102 от Панели инструментов Коммуникации: латинский 1 репертуар + поле, рисующее и т.д.

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

    • MacHFS

      kCFStringEncodingMacHFS

      Метаоцените, никогда не должен появляться в таблице.

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

    • ISOLatin2

      kCFStringEncodingISOLatin2

      ISO 8859-2.

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

    • ISOLatin3

      kCFStringEncodingISOLatin3

      ISO 8859-3.

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

    • ISOLatin4

      kCFStringEncodingISOLatin4

      ISO 8859-4.

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

    • ISOLatinCyrillic

      kCFStringEncodingISOLatinCyrillic

      ISO 8859-5.

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

    • ISOLatinArabic

      kCFStringEncodingISOLatinArabic

      ISO 8859-6, =ASMO 708, =DOS CP 708.

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

    • ISOLatinGreek

      kCFStringEncodingISOLatinGreek

      ISO 8859-7.

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

    • ISOLatinHebrew

      kCFStringEncodingISOLatinHebrew

      ISO 8859-8.

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

    • ISOLatin5

      kCFStringEncodingISOLatin5

      ISO 8859-9.

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

    • ISOLatin6

      kCFStringEncodingISOLatin6

      ISO 8859-10.

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

    • ISOLatinThai

      kCFStringEncodingISOLatinThai

      ISO 8859-11.

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

    • ISOLatin7

      kCFStringEncodingISOLatin7

      ISO 8859-13.

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

    • ISOLatin8

      kCFStringEncodingISOLatin8

      ISO 8859-14.

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

    • ISOLatin9

      kCFStringEncodingISOLatin9

      ISO 8859-15.

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

    • ISOLatin10

      kCFStringEncodingISOLatin10

      ISO 8859-16.

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

    • DOSLatinUS

      kCFStringEncodingDOSLatinUS

      Кодовая страница 437.

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

    • DOSGreek

      kCFStringEncodingDOSGreek

      Кодовая страница 737 (раньше кодовая страница 437G).

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

    • DOSBalticRim

      kCFStringEncodingDOSBalticRim

      Кодовая страница 775.

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

    • DOSLatin1

      kCFStringEncodingDOSLatin1

      Кодовая страница 850, «Многоязычная».

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

    • DOSGreek1

      kCFStringEncodingDOSGreek1

      Кодовая страница 851.

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

    • DOSLatin2

      kCFStringEncodingDOSLatin2

      Кодовая страница 852, славянская.

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

    • DOSCyrillic

      kCFStringEncodingDOSCyrillic

      Кодовая страница 855, Кириллица IBM.

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

    • DOSTurkish

      kCFStringEncodingDOSTurkish

      Кодовая страница 857, турецкий язык IBM.

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

    • DOSPortuguese

      kCFStringEncodingDOSPortuguese

      Кодовая страница 860.

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

    • DOSIcelandic

      kCFStringEncodingDOSIcelandic

      Кодовая страница 861.

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

    • DOSHebrew

      kCFStringEncodingDOSHebrew

      Кодовая страница 862.

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

    • DOSCanadianFrench

      kCFStringEncodingDOSCanadianFrench

      Кодовая страница 863.

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

    • DOSArabic

      kCFStringEncodingDOSArabic

      Кодовая страница 864.

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

    • DOSNordic

      kCFStringEncodingDOSNordic

      Кодовая страница 865.

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

    • DOSRussian

      kCFStringEncodingDOSRussian

      Кодовая страница 866.

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

    • DOSGreek2

      kCFStringEncodingDOSGreek2

      Кодовая страница 869, IBM современный греческий язык.

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

    • DOSThai

      kCFStringEncodingDOSThai

      Кодовая страница 874, также для Windows.

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

    • DOSJapanese

      kCFStringEncodingDOSJapanese

      Кодовая страница 932, также для Windows.

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

    • DOSChineseSimplif

      kCFStringEncodingDOSChineseSimplif

      Кодовая страница 936, также для Windows.

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

    • DOSKorean

      kCFStringEncodingDOSKorean

      Кодовая страница 949, также для Windows; Объединенный Код Хангула.

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

    • DOSChineseTrad

      kCFStringEncodingDOSChineseTrad

      Кодовая страница 950, также для Windows.

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

    • WindowsLatin2

      kCFStringEncodingWindowsLatin2

      Кодовая страница 1250, Центральная Европа.

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

    • WindowsCyrillic

      kCFStringEncodingWindowsCyrillic

      Кодовая страница 1251, славянская Кириллица.

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

    • WindowsGreek

      kCFStringEncodingWindowsGreek

      Кодовая страница 1253.

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

    • WindowsLatin5

      kCFStringEncodingWindowsLatin5

      Кодовая страница 1254, турецкий язык.

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

    • WindowsHebrew

      kCFStringEncodingWindowsHebrew

      Кодовая страница 1255.

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

    • WindowsArabic

      kCFStringEncodingWindowsArabic

      Кодовая страница 1256.

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

    • WindowsBalticRim

      kCFStringEncodingWindowsBalticRim

      Кодовая страница 1257.

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

    • WindowsVietnamese

      kCFStringEncodingWindowsVietnamese

      Кодовая страница 1258.

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

    • WindowsKoreanJohab

      kCFStringEncodingWindowsKoreanJohab

      Кодовая страница 1361, для Windows NT.

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

    • ANSEL

      kCFStringEncodingANSEL

      ANSEL (ANSI Z39.47).

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

    • JIS_X0201_76

      kCFStringEncodingJIS_X0201_76

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

    • JIS_X0208_83

      kCFStringEncodingJIS_X0208_83

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

    • JIS_X0208_90

      kCFStringEncodingJIS_X0208_90

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

    • JIS_X0212_90

      kCFStringEncodingJIS_X0212_90

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

    • JIS_C6226_78

      kCFStringEncodingJIS_C6226_78

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

    • ShiftJIS_X0213

      kCFStringEncodingShiftJIS_X0213

      Кодирование формата Shift-JIS плоскостей JIS X0213 1 и 2.

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

    • ShiftJIS_X0213_MenKuTen

      kCFStringEncodingShiftJIS_X0213_MenKuTen

      JIS X0213 в нотации плоского столбца строки.

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

    • GB_2312_80

      kCFStringEncodingGB_2312_80

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

    • GBK_95

      kCFStringEncodingGBK_95

      Приложение в Великобританию 13000-93; для Windows 95.

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

    • GB_18030_2000

      kCFStringEncodingGB_18030_2000

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

    • KSC_5601_87

      kCFStringEncodingKSC_5601_87

      То же как KSC 5601-92 без приложения Johab.

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

    • KSC_5601_92_Johab

      kCFStringEncodingKSC_5601_92_Johab

      KSC 5601-92 приложения Johab.

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

    • CNS_11643_92_P1

      kCFStringEncodingCNS_11643_92_P1

      CNS 11643-1992 плоскости 1.

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

    • CNS_11643_92_P2

      kCFStringEncodingCNS_11643_92_P2

      CNS 11643-1992 плоскости 2.

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

    • CNS_11643_92_P3

      kCFStringEncodingCNS_11643_92_P3

      CNS 11643-1992 плоскости 3 (был плоский 14 в 1986 версия).

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

    • ISO_2022_JP

      kCFStringEncodingISO_2022_JP

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

    • ISO_2022_JP_2

      kCFStringEncodingISO_2022_JP_2

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

    • ISO_2022_JP_1

      kCFStringEncodingISO_2022_JP_1

      RFC 2237.

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

    • ISO_2022_JP_3

      kCFStringEncodingISO_2022_JP_3

      JIS X0213.

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

    • ISO_2022_CN

      kCFStringEncodingISO_2022_CN

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

    • ISO_2022_CN_EXT

      kCFStringEncodingISO_2022_CN_EXT

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

    • ISO_2022_KR

      kCFStringEncodingISO_2022_KR

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

    • EUC_JP

      kCFStringEncodingEUC_JP

      ISO 646, 1 байт katakana, JIS 208, JIS 212.

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

    • EUC_CN

      kCFStringEncodingEUC_CN

      ISO 646, ГБАЙТ 2312-80.

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

    • EUC_TW

      kCFStringEncodingEUC_TW

      ISO 646, CNS 11643-1992 плоскости 1-16.

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

    • EUC_KR

      kCFStringEncodingEUC_KR

      ISO 646, KS C 5601-1987.

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

    • ShiftJIS

      kCFStringEncodingShiftJIS

      Простой Shift-JIS.

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

    • KOI8_R

      kCFStringEncodingKOI8_R

      Российский интернет-стандарт.

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

    • Big5

      kCFStringEncodingBig5

      Большие 5 (имеет варианты),

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

    • MacRomanLatin1

      kCFStringEncodingMacRomanLatin1

      Римлянин Mac OS переставил для выравнивания с латынью ISO 1.

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

    • HZ_GB_2312

      kCFStringEncodingHZ_GB_2312

      HZ (RFC 1842, для китайской почты и новостей).

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

    • Big5_HKSCS_1999

      kCFStringEncodingBig5_HKSCS_1999

      Большие 5 с Гонконгом специальное символьное дополнение набора.

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

    • VISCII

      kCFStringEncodingVISCII

      RFC 1456, вьетнамский язык.

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

    • KOI8_U

      kCFStringEncodingKOI8_U

      RFC 2319, украинский язык.

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

    • Big5_E

      kCFStringEncodingBig5_E

      Тайвань Большой-5E стандарт.

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

    • NextStepJapanese

      kCFStringEncodingNextStepJapanese

      Японское кодирование NextStep.

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

    • EBCDIC_US

      kCFStringEncodingEBCDIC_US

      основные EBCDIC-США

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

    • EBCDIC_CP037

      kCFStringEncodingEBCDIC_CP037

      кодовая страница 037, расширенный EBCDIC (латинский 1 набор) для США, Канады.

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

    • UTF7

      kCFStringEncodingUTF7

      kTextEncodingUnicodeDefault + kUnicodeUTF7Format RFC2152.

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

    • UTF7_IMAP

      kCFStringEncodingUTF7_IMAP

      UTF-7 (вариант папки IMAP) RFC3501.

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

    • kCFStringEncodingShiftJIS_X0213_00

      Кодирование формата Shift-JIS плоскостей JIS X0213 1 и 2.

      Осуждаемый. Использовать kCFStringEncodingShiftJIS_X0213 вместо этого.

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

    Обсуждение

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