Ссылка CFString

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

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

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

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

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

Функции

Создание CFString


    
    CFSTR
    CFSTR

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

Объявление

Objective C

CFStringRef CFSTR ( const char *cStr );

Параметры


      cStr

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

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

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

Обсуждение

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

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

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

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

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

Objective C

@import CoreFoundation;

Доступность

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


    
    CFStringCreateArrayBySeparatingStrings (_: _: _:)
    CFStringCreateArrayBySeparatingStrings

Создает массив объектов 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

Доступность

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


    
    CFStringCreateByCombiningStrings (_: _: _:)
    CFStringCreateByCombiningStrings

Создает единственную строку из отдельных объектов 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

Доступность

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


    
    CFStringCreateCopy (_: _:)
    CFStringCreateCopy

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

Объявление

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

Доступность

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


    
    CFStringCreateFromExternalRepresentation (_: _: _:)
    CFStringCreateFromExternalRepresentation

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

Объявление

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

Доступность

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


    
    CFStringCreateWithBytes (_: _: _: _: _:)
    CFStringCreateWithBytes

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

Объявление

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

Доступность

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


    
    CFStringCreateWithBytesNoCopy (_: _: _: _: _: _:)
    CFStringCreateWithBytesNoCopy

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

Объявление

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

Доступность

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

См. также

CFStringCreateWithBytes
CFStringCreateWithCharactersNoCopy
CFStringCreateWithCStringNoCopy
CFStringCreateWithPascalStringNoCopy


    
    CFStringCreateWithCharacters (_: _: _:)
    CFStringCreateWithCharacters

Создает строку из буфера символов 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

Доступность

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


    
    CFStringCreateWithCharactersNoCopy (_: _: _: _:)
    CFStringCreateWithCharactersNoCopy

Создает строку из буфера символов 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`.

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

Обсуждение

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

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

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

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

См. также

CFStringCreateWithCharacters
CFStringCreateWithBytesNoCopy
CFStringCreateWithCStringNoCopy
CFStringCreateWithPascalStringNoCopy


    
    CFStringCreateWithCString (_: _: _:)
    CFStringCreateWithCString

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

Объявление

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

Доступность

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


    
    CFStringCreateWithCStringNoCopy (_: _: _: _:)
    CFStringCreateWithCStringNoCopy

Создает объект 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`.

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

Обсуждение

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

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

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

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

См. также

CFStringCreateWithCString
CFStringCreateWithBytesNoCopy
CFStringCreateWithCharactersNoCopy
CFStringCreateWithPascalStringNoCopy


    
    CFStringCreateWithFormat
    CFStringCreateWithFormat

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

Объявление

Objective C

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

Параметры

`alloc`	Средство выделения для использования для выделения памяти для новой строки. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`formatOptions`	Объект CFDictionary, содержащий параметры форматирования для строки (такие как тысяча символа разделителя, зависящего от локали). В настоящее время эти опции являются нереализованной функцией.
`format`	Отформатированная строка с `printf`- спецификаторы стиля. Для получения информации о поддерживаемых спецификаторах посмотрите Спецификаторы Формата строки.
`...`	Список переменных значений, которые будут вставлены в `format`.

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

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

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

Objective C

@import CoreFoundation;

Доступность

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


    
    CFStringCreateWithFormatAndArguments (_: _: _: _:)
    CFStringCreateWithFormatAndArguments

Создает неизменную строку из отформатированной строки и переменного числа параметров (указанный в параметре типа 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

Доступность

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


    
    CFStringCreateWithPascalString (_: _: _:)
    CFStringCreateWithPascalString

Создает неизменный объект 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

Доступность

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


    
    CFStringCreateWithPascalStringNoCopy (_: _: _: _:)
    CFStringCreateWithPascalStringNoCopy

Создает объект 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`.

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

Обсуждение

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

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

См. также

CFStringCreateWithPascalString
CFStringCreateWithBytesNoCopy
CFStringCreateWithCStringNoCopy
CFStringCreateWithCharactersNoCopy


    
    CFStringCreateWithSubstring (_: _: _:)
    CFStringCreateWithSubstring

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

Объявление

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

Доступность

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

Поиск строк


    
    CFStringCreateArrayWithFindResults (_: _: _: _: _:)
    CFStringCreateArrayWithFindResults

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

Объявление

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

Доступность

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


    
    CFStringFind (_: _: _:)
    CFStringFind

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

Объявление

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

Доступность

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


    
    CFStringFindCharacterFromSet (_: _: _: _: _:)
    CFStringFindCharacterFromSet

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

Объявление

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

Доступность

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


    
    CFStringFindWithOptions (_: _: _: _: _:)
    CFStringFindWithOptions

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

Объявление

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

Доступность

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


    
    CFStringFindWithOptionsAndLocale (_: _: _: _: _: _:)
    CFStringFindWithOptionsAndLocale

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

Объявление

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

Доступность

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


    
    CFStringGetLineBounds (_: _: _: _: _:)
    CFStringGetLineBounds

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

Объявление

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

Доступность

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

Сравнение строк


    
    CFStringCompare (_: _: _:)
    CFStringCompare

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

Объявление

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

Доступность

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


    
    CFStringCompareWithOptions (_: _: _: _:)
    CFStringCompareWithOptions

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

Объявление

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

Доступность

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


    
    CFStringCompareWithOptionsAndLocale (_: _: _: _: _:)
    CFStringCompareWithOptionsAndLocale

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

Объявление

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

Доступность

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


    
    CFStringHasPrefix (_: _:)
    CFStringHasPrefix

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

Объявление

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

Доступность

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


    
    CFStringHasSuffix (_: _:)
    CFStringHasSuffix

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

Объявление

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

Доступность

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

Доступ к символам


    
    CFStringCreateExternalRepresentation (_: _: _: _:)
    CFStringCreateExternalRepresentation

Создает “внешнее представление” объекта 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

Доступность

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


    
    CFStringGetBytes (_: _: _: _: _: _: _: _:)
    CFStringGetBytes

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

Объявление

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

Доступность

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


    
    CFStringGetCharacterAtIndex (_: _:)
    CFStringGetCharacterAtIndex

Возвращает символ 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

Доступность

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


    
    CFStringGetCharacters (_: _: _:)
    CFStringGetCharacters

Копирует диапазон символов 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

Доступность

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

CFStringGetCharactersPtr (_:) CFStringGetCharactersPtr

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

Доступность

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


    
    CFStringGetCharacterFromInlineBuffer (_: _:)
    CFStringGetCharacterFromInlineBuffer

Возвращает символ 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

Доступность

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


    
    CFStringGetCString (_: _: _: _:)
    CFStringGetCString

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

Объявление

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

Доступность

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


    
    CFStringGetCStringPtr (_: _:)
    CFStringGetCStringPtr

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

Объявление

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

Доступность

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

CFStringGetLength (_:) CFStringGetLength

Возвращает число (с точки зрения пар кода 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

Доступность

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


    
    CFStringGetPascalString (_: _: _: _:)
    CFStringGetPascalString

Копирует символьное содержание объекта 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

Доступность

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


    
    CFStringGetPascalStringPtr (_: _:)
    CFStringGetPascalStringPtr

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

Объявление

Swift

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

Objective C

ConstStringPtr CFStringGetPascalStringPtr ( CFStringRef theString, CFStringEncoding encoding );

Параметры

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

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFStringGetRangeOfComposedCharactersAtIndex (_: _:)
    CFStringGetRangeOfComposedCharactersAtIndex

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

Объявление

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

Доступность

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


    
    CFStringInitInlineBuffer (_: _: _:)
    CFStringInitInlineBuffer

Инициализирует встроенный буфер для использования для эффективного доступа символов объекта 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

Доступность

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

Работа с расстановкой переносов


    
    CFStringGetHyphenationLocationBeforeIndex (_: _: _: _: _: _:)
    CFStringGetHyphenationLocationBeforeIndex

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

Объявление

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

Доступность

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


    
    CFStringIsHyphenationAvailableForLocale (_:)
    CFStringIsHyphenationAvailableForLocale

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

Объявление

Swift

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

Objective C

Boolean CFStringIsHyphenationAvailableForLocale ( CFLocaleRef locale );

Параметры


      locale

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

См. также

CFStringGetHyphenationLocationBeforeIndex

Работа с кодировками

CFStringConvertEncodingToIANACharSetName (_:) CFStringConvertEncodingToIANACharSetName

Возвращает имя реестра 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

Доступность

Доступный в OS X v10.0 и позже.
CFStringConvertEncodingToNSStringEncoding (_:) CFStringConvertEncodingToNSStringEncoding

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

Объявление

Swift

func CFStringConvertEncodingToNSStringEncoding(_ encoding: CFStringEncoding) -> UInt

Objective C

unsigned long CFStringConvertEncodingToNSStringEncoding ( CFStringEncoding encoding );

Параметры

encoding

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

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.0 и позже.
CFStringConvertEncodingToWindowsCodepage (_:) CFStringConvertEncodingToWindowsCodepage

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

Объявление

Swift

func CFStringConvertEncodingToWindowsCodepage(_ encoding: CFStringEncoding) -> UInt32

Objective C

UInt32 CFStringConvertEncodingToWindowsCodepage ( CFStringEncoding encoding );

Параметры

encoding

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

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.0 и позже.
CFStringConvertIANACharSetNameToEncoding (_:) CFStringConvertIANACharSetNameToEncoding

Возвращает Базовую Основу, кодирующую постоянный, который является самым близким отображением на данное имя «набора символов» реестра 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

Доступность

Доступный в OS X v10.0 и позже.
CFStringConvertNSStringEncodingToEncoding (_:) CFStringConvertNSStringEncodingToEncoding

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

Объявление

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

Доступность

Доступный в OS X v10.0 и позже.
CFStringConvertWindowsCodepageToEncoding (_:) CFStringConvertWindowsCodepageToEncoding

Возвращает Базовую Основу, кодирующую постоянный, который является самым близким отображением на данный идентификатор кодовой страницы 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

Доступность

Доступный в OS X v10.0 и позже.
CFStringGetFastestEncoding (_:) CFStringGetFastestEncoding

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

Объявление

Swift

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

Objective C

CFStringEncoding CFStringGetFastestEncoding ( CFStringRef theString );

Параметры

theString

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

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

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

Объявление

Swift

func CFStringGetListOfAvailableEncodings() -> UnsafePointer<CFStringEncoding>

Objective C

const CFStringEncoding * CFStringGetListOfAvailableEncodings ( void );

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFStringGetMaximumSizeForEncoding (_: _:)
    CFStringGetMaximumSizeForEncoding

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

Доступность

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


    
    CFStringGetMostCompatibleMacStringEncoding (_:)
    CFStringGetMostCompatibleMacStringEncoding

Возвращает самое совместимое значение сценария 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

Доступность

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

CFStringGetNameOfEncoding (_:) CFStringGetNameOfEncoding

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

Объявление

Swift

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

Objective C

CFStringRef CFStringGetNameOfEncoding ( CFStringEncoding encoding );

Параметры

encoding

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

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.0 и позже.
CFStringGetSmallestEncoding (_:) CFStringGetSmallestEncoding

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

Объявление

Swift

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

Objective C

CFStringEncoding CFStringGetSmallestEncoding ( CFStringRef theString );

Параметры

theString

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

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

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

Объявление

Swift

func CFStringGetSystemEncoding() -> CFStringEncoding

Objective C

CFStringEncoding CFStringGetSystemEncoding ( void );

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

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

Обсуждение

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

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.0 и позже.
CFStringIsEncodingAvailable (_:) CFStringIsEncodingAvailable

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

Объявление

Swift

func CFStringIsEncodingAvailable(_ encoding: CFStringEncoding) -> Boolean

Objective C

Boolean CFStringIsEncodingAvailable ( CFStringEncoding encoding );

Параметры

encoding

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

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Получение числовых значений


    
    CFStringGetDoubleValue (_:)
    CFStringGetDoubleValue

Возвращает основное устройство 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

Доступность

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


    
    CFStringGetIntValue (_:)
    CFStringGetIntValue

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

Объявление

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

Доступность

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

Получение свойств строки

CFShowStr (_:) CFShowStr
Распечатывает атрибуты строки во время отладки.

Объявление

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

Доступность

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

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

Объявление

Swift

func CFStringGetTypeID() -> CFTypeID

Objective C

CFTypeID CFStringGetTypeID ( void );

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Представьте представления файловой системы в виде строки


    
    CFStringCreateWithFileSystemRepresentation (_: _:)
    CFStringCreateWithFileSystemRepresentation

Создает 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

Доступность

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


    
    CFStringGetFileSystemRepresentation (_: _: _:)
    CFStringGetFileSystemRepresentation

Извлекает содержание строки как 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

Доступность

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

CFStringGetMaximumSizeOfFileSystemRepresentation (_:) CFStringGetMaximumSizeOfFileSystemRepresentation

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

Объявление

Swift

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

Objective C

CFIndex CFStringGetMaximumSizeOfFileSystemRepresentation ( CFStringRef string );

Параметры

string

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

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

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Получение границ абзаца


    
    CFStringGetParagraphBounds (_: _: _: _: _:)
    CFStringGetParagraphBounds

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

Объявление

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

Доступность

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

Управление заместителями


    
    CFStringGetLongCharacterForSurrogatePair (_: _:)
    CFStringGetLongCharacterForSurrogatePair

Возвращает символ 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

Доступность

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


    
    CFStringGetSurrogatePairForLongCharacter (_: _:)
    CFStringGetSurrogatePairForLongCharacter

Отображает данный символ 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

Доступность

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

CFStringIsSurrogateHighCharacter (_:) CFStringIsSurrogateHighCharacter

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

Объявление

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

Доступность

Доступный в OS X v10.6 и позже.
CFStringIsSurrogateLowCharacter (_:) CFStringIsSurrogateLowCharacter

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

Объявление

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

Доступность

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

Типы данных

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

CFStringEncoding CFStringEncoding

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

Объявление

Swift

typealias CFStringEncoding = UInt32

Objective C

typedef UInt32 CFStringEncoding;

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

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

Объявление

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

Доступность

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

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

Доступность

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

Определяет буферные и смежные области, используемые для встроенного буферного доступа символов в объектах 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 }

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

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

Доступность

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

Ссылка на объект 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

Доступность

Доступный в OS X v10.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
  
  Указывает, что сравнение должно проигнорировать различия в случае, если между алфавитными символами.
  
  Доступный в OS X v10.0 и позже.
- CompareBackwards
  
  kCFCompareBackwards
  
  Указывает, что сравнение должно запуститься в последних элементах сравниваемых объектов (например, строки или массивы).
  
  Доступный в OS X v10.0 и позже.
- CompareAnchored
  
  kCFCompareAnchored
  
  Выполняет поиск только на символах вначале или конце диапазона.
  
  Никакое соответствие вначале или конец не означают, что ничто не найдено, даже если соответствующая последовательность символов происходит в другом месте в строке.
  
  Доступный в OS X v10.0 и позже.
- CompareNonliteral
  
  kCFCompareNonliteral
  
  Указывает, что свободная эквивалентность приемлема, тем более, что принадлежит диакритическим знакам.
  
  Например, «Ф» представленный как два отличных символа («o» и «умляут») эквивалентно «Ф», представленному отдельным символом («o-умляут»). Обратите внимание на то, что это не то же как диакритическая нечувствительность.
  
  Доступный в OS X v10.0 и позже.
- CompareLocalized
  
  kCFCompareLocalized
  
  Указывает, что сравнение должно принять во внимание различия, связанные с локалью, такие как тысячи символа разделителя.
  
  Доступный в OS X v10.0 и позже.
- CompareNumerically
  
  kCFCompareNumerically
  
  Указывает, что представленные числовые значения должны использоваться в качестве основания для сравнения а не фактических символьных значений.
  
  Например, «версия 2» является меньше, чем «версия 10».
  
  Это сравнение не работает если kCFCompareLocalized указан в системах перед OS X v10.3.
  
  Доступный в OS X v10.0 и позже.
- CompareDiacriticInsensitive
  
  kCFCompareDiacriticInsensitive
  
  Указывает, что сравнение должно проигнорировать диакритические маркеры.
  
  Например, «Ф» («o-умляут») эквивалентно «o».
  
  Диакритические маркеры определяются как все метки без интервалов ниже U+0510.
  
  Доступный в OS X v10.5 и позже.
- CompareWidthInsensitive
  
  kCFCompareWidthInsensitive
  
  Указывает, что сравнение должно проигнорировать различия в ширине.
  
  Например, эквивалентного UFF41.
  
  Доступный в OS X v10.5 и позже.
- CompareForcedOrdering
  
  kCFCompareForcedOrdering
  
  Указывает, что сравнение вынуждено возвратиться также kCFCompareLessThan или kCFCompareGreaterThan если строки эквивалентны, но не строго равны.
  
  Вы используете эту опцию для устойчивости при сортировке (например, с kCFCompareCaseInsensitive указанный «aaa» больше, чем «AAA»).
  
  Доступный в OS X v10.5 и позже.
Обсуждение

Эти константы являются флагами, предназначенными для использования в опциональных параметрах сравнения в функциях сравнения такой как 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
  
  Кодирование, постоянное, который идентифицирует Мак Романа, кодирующего.
  
  Доступный в OS X v10.0 и позже.
- WindowsLatin1
  
  kCFStringEncodingWindowsLatin1
  
  Кодирование, постоянное, который идентифицирует кодирование Windows Latin 1 (кодовая страница ANSI 1252).
  
  Доступный в OS X v10.0 и позже.
- ISOLatin1
  
  kCFStringEncodingISOLatin1
  
  Кодирование, постоянное, который идентифицирует латынь ISO 1 кодирование (ISO 8859-1)
  
  Доступный в OS X v10.0 и позже.
- NextStepLatin
  
  kCFStringEncodingNextStepLatin
  
  Кодирование, постоянное, который идентифицирует кодирование NextStep/OpenStep.
  
  Доступный в OS X v10.0 и позже.
- ASCII
  
  kCFStringEncodingASCII
  
  Кодирование, постоянное, который идентифицирует кодирование ASCII (десятичные значения 0 до 127).
  
  Доступный в OS X v10.0 и позже.
- Unicode
  
  kCFStringEncodingUnicode
  
  Кодирование, постоянное, который идентифицирует кодирование Unicode.
  
  Доступный в OS X v10.0 и позже.
- UTF8
  
  kCFStringEncodingUTF8
  
  Кодирование, постоянное, который идентифицирует кодирование UTF 8.
  
  Доступный в OS X v10.0 и позже.
- NonLossyASCII
  
  kCFStringEncodingNonLossyASCII
  
  Кодирование, постоянное, который идентифицирует кодирование ASCII нес потерями.
  
  Доступный в OS X v10.0 и позже.
- kCFStringEncodingUTF16
  
  kCFStringEncodingUTF16
  
  Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF16Format кодирующий (псевдоним kCFStringEncodingUnicode).
  
  Доступный в OS X v10.4 и позже.
- UTF16BE
  
  kCFStringEncodingUTF16BE
  
  Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF16BEFormat кодирование. Эта константа указывает обратный порядок байтов.
  
  Доступный в OS X v10.4 и позже.
- UTF16LE
  
  kCFStringEncodingUTF16LE
  
  Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF16LEFormat кодирование. Эта константа указывает прямой порядок байтов.
  
  Доступный в OS X v10.4 и позже.
- UTF32
  
  kCFStringEncodingUTF32
  
  Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF32Format кодирование.
  
  Доступный в OS X v10.4 и позже.
- UTF32BE
  
  kCFStringEncodingUTF32BE
  
  Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF32BEFormat кодирование. Эта константа указывает обратный порядок байтов.
  
  Доступный в OS X v10.4 и позже.
- UTF32LE
  
  kCFStringEncodingUTF32LE
  
  Кодирование, постоянное, который идентифицирует kTextEncodingUnicodeDefault + kUnicodeUTF32LEFormat кодирование. Эта константа указывает прямой порядок байтов.
  
  Доступный в OS X v10.4 и позже.
Оператор импорта

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.0 и позже.
Недопустимый строковый флаг кодирования
Специальное значение возвратилось из функций для указания строки, кодирующей, который не поддерживается или распознается CFString.

Объявление

Swift

var kCFStringEncodingInvalidId: UInt32 { get }

Objective C

#define kCFStringEncodingInvalidId (0xffffffffU)

Константы
- kCFStringEncodingInvalidId
  
  kCFStringEncodingInvalidId
  
  Используемый в качестве функционального результата идентифицировать кодирование, не поддерживающееся или распознающееся CFString.
  
  Доступный в OS X v10.2 и позже.
Внешние строковые кодировки
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
  
  Доступный в OS X v10.0 и позже.
- MacChineseTrad
  
  kCFStringEncodingMacChineseTrad
  
  Доступный в OS X v10.0 и позже.
- MacKorean
  
  kCFStringEncodingMacKorean
  
  Доступный в OS X v10.0 и позже.
- MacArabic
  
  kCFStringEncodingMacArabic
  
  Доступный в OS X v10.0 и позже.
- MacHebrew
  
  kCFStringEncodingMacHebrew
  
  Доступный в OS X v10.0 и позже.
- MacGreek
  
  kCFStringEncodingMacGreek
  
  Доступный в OS X v10.0 и позже.
- MacCyrillic
  
  kCFStringEncodingMacCyrillic
  
  Доступный в OS X v10.0 и позже.
- MacDevanagari
  
  kCFStringEncodingMacDevanagari
  
  Доступный в OS X v10.0 и позже.
- MacGurmukhi
  
  kCFStringEncodingMacGurmukhi
  
  Доступный в OS X v10.0 и позже.
- MacGujarati
  
  kCFStringEncodingMacGujarati
  
  Доступный в OS X v10.0 и позже.
- MacOriya
  
  kCFStringEncodingMacOriya
  
  Доступный в OS X v10.0 и позже.
- MacBengali
  
  kCFStringEncodingMacBengali
  
  Доступный в OS X v10.0 и позже.
- MacTamil
  
  kCFStringEncodingMacTamil
  
  Доступный в OS X v10.0 и позже.
- MacTelugu
  
  kCFStringEncodingMacTelugu
  
  Доступный в OS X v10.0 и позже.
- MacKannada
  
  kCFStringEncodingMacKannada
  
  Доступный в OS X v10.0 и позже.
- MacMalayalam
  
  kCFStringEncodingMacMalayalam
  
  Доступный в OS X v10.0 и позже.
- MacSinhalese
  
  kCFStringEncodingMacSinhalese
  
  Доступный в OS X v10.0 и позже.
- MacBurmese
  
  kCFStringEncodingMacBurmese
  
  Доступный в OS X v10.0 и позже.
- MacKhmer
  
  kCFStringEncodingMacKhmer
  
  Доступный в OS X v10.0 и позже.
- MacThai
  
  kCFStringEncodingMacThai
  
  Доступный в OS X v10.0 и позже.
- MacLaotian
  
  kCFStringEncodingMacLaotian
  
  Доступный в OS X v10.0 и позже.
- MacGeorgian
  
  kCFStringEncodingMacGeorgian
  
  Доступный в OS X v10.0 и позже.
- MacArmenian
  
  kCFStringEncodingMacArmenian
  
  Доступный в OS X v10.0 и позже.
- MacChineseSimp
  
  kCFStringEncodingMacChineseSimp
  
  Доступный в OS X v10.0 и позже.
- MacTibetan
  
  kCFStringEncodingMacTibetan
  
  Доступный в OS X v10.0 и позже.
- MacMongolian
  
  kCFStringEncodingMacMongolian
  
  Доступный в OS X v10.0 и позже.
- MacEthiopic
  
  kCFStringEncodingMacEthiopic
  
  Доступный в OS X v10.0 и позже.
- MacCentralEurRoman
  
  kCFStringEncodingMacCentralEurRoman
  
  Доступный в OS X v10.0 и позже.
- MacVietnamese
  
  kCFStringEncodingMacVietnamese
  
  Доступный в OS X v10.0 и позже.
- MacExtArabic
  
  kCFStringEncodingMacExtArabic
  
  Доступный в OS X v10.0 и позже.
- MacSymbol
  
  kCFStringEncodingMacSymbol
  
  Доступный в OS X v10.0 и позже.
- MacDingbats
  
  kCFStringEncodingMacDingbats
  
  Доступный в OS X v10.0 и позже.
- MacTurkish
  
  kCFStringEncodingMacTurkish
  
  Доступный в OS X v10.0 и позже.
- MacCroatian
  
  kCFStringEncodingMacCroatian
  
  Доступный в OS X v10.0 и позже.
- MacIcelandic
  
  kCFStringEncodingMacIcelandic
  
  Доступный в OS X v10.0 и позже.
- MacRomanian
  
  kCFStringEncodingMacRomanian
  
  Доступный в OS X v10.0 и позже.
- MacCeltic
  
  kCFStringEncodingMacCeltic
  
  Доступный в OS X v10.0 и позже.
- MacGaelic
  
  kCFStringEncodingMacGaelic
  
  Доступный в OS X v10.0 и позже.
- MacFarsi
  
  kCFStringEncodingMacFarsi
  
  Как Макарабик, но цифры фарси использования.
  
  Доступный в OS X v10.0 и позже.
- MacUkrainian
  
  kCFStringEncodingMacUkrainian
  
  Доступный в OS X v10.0 и позже.
- MacInuit
  
  kCFStringEncodingMacInuit
  
  Доступный в OS X v10.0 и позже.
- MacVT100
  
  kCFStringEncodingMacVT100
  
  Шрифт VT100102 от Панели инструментов Коммуникации: латинский 1 репертуар + поле, рисующее и т.д.
  
  Доступный в OS X v10.0 и позже.
- MacHFS
  
  kCFStringEncodingMacHFS
  
  Метаоцените, никогда не должен появляться в таблице.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin2
  
  kCFStringEncodingISOLatin2
  
  ISO 8859-2.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin3
  
  kCFStringEncodingISOLatin3
  
  ISO 8859-3.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin4
  
  kCFStringEncodingISOLatin4
  
  ISO 8859-4.
  
  Доступный в OS X v10.0 и позже.
- ISOLatinCyrillic
  
  kCFStringEncodingISOLatinCyrillic
  
  ISO 8859-5.
  
  Доступный в OS X v10.0 и позже.
- ISOLatinArabic
  
  kCFStringEncodingISOLatinArabic
  
  ISO 8859-6, =ASMO 708, =DOS CP 708.
  
  Доступный в OS X v10.0 и позже.
- ISOLatinGreek
  
  kCFStringEncodingISOLatinGreek
  
  ISO 8859-7.
  
  Доступный в OS X v10.0 и позже.
- ISOLatinHebrew
  
  kCFStringEncodingISOLatinHebrew
  
  ISO 8859-8.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin5
  
  kCFStringEncodingISOLatin5
  
  ISO 8859-9.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin6
  
  kCFStringEncodingISOLatin6
  
  ISO 8859-10.
  
  Доступный в OS X v10.0 и позже.
- ISOLatinThai
  
  kCFStringEncodingISOLatinThai
  
  ISO 8859-11.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin7
  
  kCFStringEncodingISOLatin7
  
  ISO 8859-13.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin8
  
  kCFStringEncodingISOLatin8
  
  ISO 8859-14.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin9
  
  kCFStringEncodingISOLatin9
  
  ISO 8859-15.
  
  Доступный в OS X v10.0 и позже.
- ISOLatin10
  
  kCFStringEncodingISOLatin10
  
  ISO 8859-16.
  
  Доступный в OS X v10.4 и позже.
- DOSLatinUS
  
  kCFStringEncodingDOSLatinUS
  
  Кодовая страница 437.
  
  Доступный в OS X v10.0 и позже.
- DOSGreek
  
  kCFStringEncodingDOSGreek
  
  Кодовая страница 737 (раньше кодовая страница 437G).
  
  Доступный в OS X v10.0 и позже.
- DOSBalticRim
  
  kCFStringEncodingDOSBalticRim
  
  Кодовая страница 775.
  
  Доступный в OS X v10.0 и позже.
- DOSLatin1
  
  kCFStringEncodingDOSLatin1
  
  Кодовая страница 850, «Многоязычная».
  
  Доступный в OS X v10.0 и позже.
- DOSGreek1
  
  kCFStringEncodingDOSGreek1
  
  Кодовая страница 851.
  
  Доступный в OS X v10.0 и позже.
- DOSLatin2
  
  kCFStringEncodingDOSLatin2
  
  Кодовая страница 852, славянская.
  
  Доступный в OS X v10.0 и позже.
- DOSCyrillic
  
  kCFStringEncodingDOSCyrillic
  
  Кодовая страница 855, Кириллица IBM.
  
  Доступный в OS X v10.0 и позже.
- DOSTurkish
  
  kCFStringEncodingDOSTurkish
  
  Кодовая страница 857, турецкий язык IBM.
  
  Доступный в OS X v10.0 и позже.
- DOSPortuguese
  
  kCFStringEncodingDOSPortuguese
  
  Кодовая страница 860.
  
  Доступный в OS X v10.0 и позже.
- DOSIcelandic
  
  kCFStringEncodingDOSIcelandic
  
  Кодовая страница 861.
  
  Доступный в OS X v10.0 и позже.
- DOSHebrew
  
  kCFStringEncodingDOSHebrew
  
  Кодовая страница 862.
  
  Доступный в OS X v10.0 и позже.
- DOSCanadianFrench
  
  kCFStringEncodingDOSCanadianFrench
  
  Кодовая страница 863.
  
  Доступный в OS X v10.0 и позже.
- DOSArabic
  
  kCFStringEncodingDOSArabic
  
  Кодовая страница 864.
  
  Доступный в OS X v10.0 и позже.
- DOSNordic
  
  kCFStringEncodingDOSNordic
  
  Кодовая страница 865.
  
  Доступный в OS X v10.0 и позже.
- DOSRussian
  
  kCFStringEncodingDOSRussian
  
  Кодовая страница 866.
  
  Доступный в OS X v10.0 и позже.
- DOSGreek2
  
  kCFStringEncodingDOSGreek2
  
  Кодовая страница 869, IBM современный греческий язык.
  
  Доступный в OS X v10.0 и позже.
- DOSThai
  
  kCFStringEncodingDOSThai
  
  Кодовая страница 874, также для Windows.
  
  Доступный в OS X v10.0 и позже.
- DOSJapanese
  
  kCFStringEncodingDOSJapanese
  
  Кодовая страница 932, также для Windows.
  
  Доступный в OS X v10.0 и позже.
- DOSChineseSimplif
  
  kCFStringEncodingDOSChineseSimplif
  
  Кодовая страница 936, также для Windows.
  
  Доступный в OS X v10.0 и позже.
- DOSKorean
  
  kCFStringEncodingDOSKorean
  
  Кодовая страница 949, также для Windows; Объединенный Код Хангула.
  
  Доступный в OS X v10.0 и позже.
- DOSChineseTrad
  
  kCFStringEncodingDOSChineseTrad
  
  Кодовая страница 950, также для Windows.
  
  Доступный в OS X v10.0 и позже.
- WindowsLatin2
  
  kCFStringEncodingWindowsLatin2
  
  Кодовая страница 1250, Центральная Европа.
  
  Доступный в OS X v10.0 и позже.
- WindowsCyrillic
  
  kCFStringEncodingWindowsCyrillic
  
  Кодовая страница 1251, славянская Кириллица.
  
  Доступный в OS X v10.0 и позже.
- WindowsGreek
  
  kCFStringEncodingWindowsGreek
  
  Кодовая страница 1253.
  
  Доступный в OS X v10.0 и позже.
- WindowsLatin5
  
  kCFStringEncodingWindowsLatin5
  
  Кодовая страница 1254, турецкий язык.
  
  Доступный в OS X v10.0 и позже.
- WindowsHebrew
  
  kCFStringEncodingWindowsHebrew
  
  Кодовая страница 1255.
  
  Доступный в OS X v10.0 и позже.
- WindowsArabic
  
  kCFStringEncodingWindowsArabic
  
  Кодовая страница 1256.
  
  Доступный в OS X v10.0 и позже.
- WindowsBalticRim
  
  kCFStringEncodingWindowsBalticRim
  
  Кодовая страница 1257.
  
  Доступный в OS X v10.0 и позже.
- WindowsVietnamese
  
  kCFStringEncodingWindowsVietnamese
  
  Кодовая страница 1258.
  
  Доступный в OS X v10.0 и позже.
- WindowsKoreanJohab
  
  kCFStringEncodingWindowsKoreanJohab
  
  Кодовая страница 1361, для Windows NT.
  
  Доступный в OS X v10.0 и позже.
- ANSEL
  
  kCFStringEncodingANSEL
  
  ANSEL (ANSI Z39.47).
  
  Доступный в OS X v10.4 и позже.
- JIS_X0201_76
  
  kCFStringEncodingJIS_X0201_76
  
  Доступный в OS X v10.0 и позже.
- JIS_X0208_83
  
  kCFStringEncodingJIS_X0208_83
  
  Доступный в OS X v10.0 и позже.
- JIS_X0208_90
  
  kCFStringEncodingJIS_X0208_90
  
  Доступный в OS X v10.0 и позже.
- JIS_X0212_90
  
  kCFStringEncodingJIS_X0212_90
  
  Доступный в OS X v10.0 и позже.
- JIS_C6226_78
  
  kCFStringEncodingJIS_C6226_78
  
  Доступный в OS X v10.0 и позже.
- ShiftJIS_X0213
  
  kCFStringEncodingShiftJIS_X0213
  
  Кодирование формата Shift-JIS плоскостей JIS X0213 1 и 2.
  
  Доступный в OS X v10.5 и позже.
- ShiftJIS_X0213_MenKuTen
  
  kCFStringEncodingShiftJIS_X0213_MenKuTen
  
  JIS X0213 в нотации плоского столбца строки.
  
  Доступный в OS X v10.4 и позже.
- GB_2312_80
  
  kCFStringEncodingGB_2312_80
  
  Доступный в OS X v10.0 и позже.
- GBK_95
  
  kCFStringEncodingGBK_95
  
  Приложение в Великобританию 13000-93; для Windows 95.
  
  Доступный в OS X v10.0 и позже.
- GB_18030_2000
  
  kCFStringEncodingGB_18030_2000
  
  Доступный в OS X v10.2 и позже.
- KSC_5601_87
  
  kCFStringEncodingKSC_5601_87
  
  То же как KSC 5601-92 без приложения Johab.
  
  Доступный в OS X v10.0 и позже.
- KSC_5601_92_Johab
  
  kCFStringEncodingKSC_5601_92_Johab
  
  KSC 5601-92 приложения Johab.
  
  Доступный в OS X v10.0 и позже.
- CNS_11643_92_P1
  
  kCFStringEncodingCNS_11643_92_P1
  
  CNS 11643-1992 плоскости 1.
  
  Доступный в OS X v10.0 и позже.
- CNS_11643_92_P2
  
  kCFStringEncodingCNS_11643_92_P2
  
  CNS 11643-1992 плоскости 2.
  
  Доступный в OS X v10.0 и позже.
- CNS_11643_92_P3
  
  kCFStringEncodingCNS_11643_92_P3
  
  CNS 11643-1992 плоскости 3 (был плоский 14 в 1986 версия).
  
  Доступный в OS X v10.0 и позже.
- ISO_2022_JP
  
  kCFStringEncodingISO_2022_JP
  
  Доступный в OS X v10.0 и позже.
- ISO_2022_JP_2
  
  kCFStringEncodingISO_2022_JP_2
  
  Доступный в OS X v10.0 и позже.
- ISO_2022_JP_1
  
  kCFStringEncodingISO_2022_JP_1
  
  RFC 2237.
  
  Доступный в OS X v10.2 и позже.
- ISO_2022_JP_3
  
  kCFStringEncodingISO_2022_JP_3
  
  JIS X0213.
  
  Доступный в OS X v10.2 и позже.
- ISO_2022_CN
  
  kCFStringEncodingISO_2022_CN
  
  Доступный в OS X v10.0 и позже.
- ISO_2022_CN_EXT
  
  kCFStringEncodingISO_2022_CN_EXT
  
  Доступный в OS X v10.0 и позже.
- ISO_2022_KR
  
  kCFStringEncodingISO_2022_KR
  
  Доступный в OS X v10.0 и позже.
- EUC_JP
  
  kCFStringEncodingEUC_JP
  
  ISO 646, 1 байт katakana, JIS 208, JIS 212.
  
  Доступный в OS X v10.0 и позже.
- EUC_CN
  
  kCFStringEncodingEUC_CN
  
  ISO 646, ГБАЙТ 2312-80.
  
  Доступный в OS X v10.0 и позже.
- EUC_TW
  
  kCFStringEncodingEUC_TW
  
  ISO 646, CNS 11643-1992 плоскости 1-16.
  
  Доступный в OS X v10.0 и позже.
- EUC_KR
  
  kCFStringEncodingEUC_KR
  
  ISO 646, KS C 5601-1987.
  
  Доступный в OS X v10.0 и позже.
- ShiftJIS
  
  kCFStringEncodingShiftJIS
  
  Простой Shift-JIS.
  
  Доступный в OS X v10.0 и позже.
- KOI8_R
  
  kCFStringEncodingKOI8_R
  
  Российский интернет-стандарт.
  
  Доступный в OS X v10.0 и позже.
- Big5
  
  kCFStringEncodingBig5
  
  Большие 5 (имеет варианты),
  
  Доступный в OS X v10.0 и позже.
- MacRomanLatin1
  
  kCFStringEncodingMacRomanLatin1
  
  Римлянин Mac OS переставил для выравнивания с латынью ISO 1.
  
  Доступный в OS X v10.0 и позже.
- HZ_GB_2312
  
  kCFStringEncodingHZ_GB_2312
  
  HZ (RFC 1842, для китайской почты и новостей).
  
  Доступный в OS X v10.0 и позже.
- Big5_HKSCS_1999
  
  kCFStringEncodingBig5_HKSCS_1999
  
  Большие 5 с Гонконгом специальное символьное дополнение набора.
  
  Доступный в OS X v10.2 и позже.
- VISCII
  
  kCFStringEncodingVISCII
  
  RFC 1456, вьетнамский язык.
  
  Доступный в OS X v10.4 и позже.
- KOI8_U
  
  kCFStringEncodingKOI8_U
  
  RFC 2319, украинский язык.
  
  Доступный в OS X v10.4 и позже.
- Big5_E
  
  kCFStringEncodingBig5_E
  
  Тайвань Большой-5E стандарт.
  
  Доступный в OS X v10.4 и позже.
- NextStepJapanese
  
  kCFStringEncodingNextStepJapanese
  
  Японское кодирование NextStep.
  
  Доступный в OS X v10.4 и позже.
- EBCDIC_US
  
  kCFStringEncodingEBCDIC_US
  
  основные EBCDIC-США
  
  Доступный в OS X v10.0 и позже.
- EBCDIC_CP037
  
  kCFStringEncodingEBCDIC_CP037
  
  кодовая страница 037, расширенный EBCDIC (латинский 1 набор) для США, Канады.
  
  Доступный в OS X v10.0 и позже.
- UTF7
  
  kCFStringEncodingUTF7
  
  kTextEncodingUnicodeDefault + kUnicodeUTF7Format RFC2152.
  
  Доступный в OS X v10.6 и позже.
- UTF7_IMAP
  
  kCFStringEncodingUTF7_IMAP
  
  UTF-7 (вариант папки IMAP) RFC3501.
  
  Доступный в OS X v10.6 и позже.
- kCFStringEncodingShiftJIS_X0213_00
  
  kCFStringEncodingShiftJIS_X0213_00
  
  Кодирование формата Shift-JIS плоскостей JIS X0213 1 и 2.
  Осуждаемый. Использовать kCFStringEncodingShiftJIS_X0213 вместо этого.
  
  Доступный в OS X v10.2 и позже.
Обсуждение

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