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

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

Разработчик

Эталонный текст платформы CoreServices , кодирующий менеджера по преобразованию ссылка

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

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

Текст, кодирующий менеджера по преобразованию ссылка

Менеджер Text Encoding Conversion (TEC) предоставляет две услуги — текст, Кодирующий Преобразователь и Преобразователь Unicode — который Ваше приложение может использовать для обработки текста, кодирующего преобразование на Mac OS. Вы найдете текст, Кодирующий менеджера по Преобразованию полезный при разработке Интернет-приложений, таких как веб-браузеры или почтовые программы, приложения, передающие текст через различные платформы или приложения, базируемые в Unicode.

Функции

  • Создает и возвращает текст, кодирующий спецификацию.

    Объявление

    Swift

    func CreateTextEncoding(_ encodingBase: TextEncodingBase, _ encodingVariant: TextEncodingVariant, _ encodingFormat: TextEncodingFormat) -> TextEncoding

    Objective C

    TextEncoding CreateTextEncoding ( TextEncodingBase encodingBase, TextEncodingVariant encodingVariant, TextEncodingFormat encodingFormat );

    Параметры

    encodingBase

    Кодирование основного текста.

    encodingVariant

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

    encodingFormat

    Формат для кодирования основного текста. Для указания формата по умолчанию для основного кодирования можно использовать kTextEncodingDefaultFormat постоянный. Если Вы хотите получить a TextEncoding оцените это ссылки UTF-16 или UTF-8, передача kUnicode16BitFormat или kUnicodeUTF8Format .

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

    Текст, кодирующий спецификацию, которую функция создает из значений, Вы передаете его.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func GetTextEncodingBase(_ encoding: TextEncoding) -> TextEncodingBase

    Objective C

    TextEncodingBase GetTextEncodingBase ( TextEncoding encoding );

    Параметры

    encoding

    Текст, кодирующий спецификацию, основа которой, кодирующая Вас, хочет получить.

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

    Часть кодирования основы указанного текстового кодирования.

    Обсуждение

    Посмотрите тип данных TextEncodingRun

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func GetTextEncodingFormat(_ encoding: TextEncoding) -> TextEncodingFormat

    Objective C

    TextEncodingFormat GetTextEncodingFormat ( TextEncoding encoding );

    Параметры

    encoding

    Текст, кодирующий спецификацию.

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

    Значение формата кодировки текста, содержавшееся в тексте, кодирующем Вас указанный.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func GetTextEncodingName(_ iEncoding: TextEncoding, _ iNamePartSelector: TextEncodingNameSelector, _ iPreferredRegion: RegionCode, _ iPreferredEncoding: TextEncoding, _ iOutputBufLen: ByteCount, _ oNameLength: UnsafeMutablePointer<ByteCount>, _ oActualRegion: UnsafeMutablePointer<RegionCode>, _ oActualEncoding: UnsafeMutablePointer<TextEncoding>, _ oEncodingName: TextPtr) -> OSStatus

    Objective C

    OSStatus GetTextEncodingName ( TextEncoding iEncoding, TextEncodingNameSelector iNamePartSelector, RegionCode iPreferredRegion, TextEncoding iPreferredEncoding, ByteCount iOutputBufLen, ByteCount *oNameLength, RegionCode *oActualRegion, TextEncoding *oActualEncoding, TextPtr oEncodingName );

    Параметры

    iEncoding

    Текст, кодирующий спецификацию, имя которой Вы хотите получить.

    iNamePartSelector

    Часть имени кодирования Вы хотите получить. См., что текст Кодирует Селекторы Имени для списка возможных значений.

    iPreferredRegion

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

    iPreferredEncoding

    Предпочтительное кодирование для использования для имени. Например, ASCII, римлянин Mac OS или Shift-JIS. Если функция не может возвратить имя с помощью предпочтительного кодирования, это возвращает имя с помощью другого кодирования, такого как Unicode или ASCII.

    iOutputBufLen

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

    oNameLength

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

    oActualRegion

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

    oActualEncoding

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

    oEncodingName

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Имена, возвращенные GetTextEncodingName (в буфере, именуемом oEncodingName) может содержать круглые скобки и другие метасимволы пункта меню, и так не может использоваться с AppendMenu или InsertMenuItem. Можно использовать их с SetMenuItemText.

    Эта функция может возвратить ресурсы и ошибки памяти и следующие коды результата:

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

    • kTECMissingTableErr, который указывает, что отсутствует ресурс имени, связанный с кодированием.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func GetTextEncodingVariant(_ encoding: TextEncoding) -> TextEncodingVariant

    Objective C

    TextEncodingVariant GetTextEncodingVariant ( TextEncoding encoding );

    Параметры

    encoding

    Текст, кодирующий спецификацию.

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

    Текст, кодирующий различную часть указанного текстового кодирования.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func ResolveDefaultTextEncoding(_ encoding: TextEncoding) -> TextEncoding

    Objective C

    TextEncoding ResolveDefaultTextEncoding ( TextEncoding encoding );

    Параметры

    encoding

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

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

    Текст, кодирующий спецификацию, содержащую только реальные значения кодирования основы.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает данный текст Mac OS, кодирующий спецификацию к соответствующему коду сценария и, если это возможно, кодовое название языка и имя шрифта.

    Объявление

    Swift

    func RevertTextEncodingToScriptInfo(_ iEncoding: TextEncoding, _ oTextScriptID: UnsafeMutablePointer<ScriptCode>, _ oTextLanguageID: UnsafeMutablePointer<LangCode>, _ oTextFontname: UnsafeMutablePointer<UInt8>) -> OSStatus

    Objective C

    OSStatus RevertTextEncodingToScriptInfo ( TextEncoding iEncoding, ScriptCode *oTextScriptID, LangCode *oTextLanguageID, Str255 oTextFontname );

    Параметры

    iEncoding

    Текст, кодирующий спецификацию, которая будет преобразована.

    oTextScriptID

    Указатель на значение типа ScriptCode. По возврату, код сценария Mac OS, соответствующий тексту, кодирующему спецификацию, которую Вы идентифицировали в iEncoding параметр. Если Вы не передаете указатель для этого параметра, функция возвращает a paramErr код результата.

    oTextLanguageID

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

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

    oTextFontname

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

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Функциональные возвраты paramErr если текст, кодирующий входное значение параметра спецификации, недопустим. Функция возвращает a kTECTableFormatErr закончитесь код, если внутренние таблицы отображения, используемые для перевода, недопустимы. Для списка других возможных кодов результата см. «Типы данных».

    Обсуждение

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

    Для получения дополнительной информации посмотрите UpgradeScriptInfoToTextEncoding текст функции и Кодировки Основного текста.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает любую комбинацию кода сценария Mac OS, кода языка, кода области и имени шрифта к текстовому кодированию.

    Объявление

    Swift

    func UpgradeScriptInfoToTextEncoding(_ iTextScriptID: ScriptCode, _ iTextLanguageID: LangCode, _ iRegionID: RegionCode, _ iTextFontname: ConstStr255Param, _ oEncoding: UnsafeMutablePointer<TextEncoding>) -> OSStatus

    Objective C

    OSStatus UpgradeScriptInfoToTextEncoding ( ScriptCode iTextScriptID, LangCode iTextLanguageID, RegionCode iRegionID, ConstStr255Param iTextFontname, TextEncoding *oEncoding );

    Параметры

    iTextScriptID

    Допустимый менеджер по Сценарию код сценария. Менеджер по Сценарию Mac OS определяет константы для кодов сценария с помощью этого формата: smXxx. Для обозначения системного сценария укажите метазначение smSystemScript. Называть текущий сценарий на основе шрифта указанным в графическом порту (grafPort), укажите метазначение smCurrentScript. Чтобы указать, что Вы не хотите обеспечивать код сценария для этого параметра, укажите константу kTextScriptDontCare.

    iTextLanguageID

    Допустимый менеджер по Сценарию код языка. Менеджер по Сценарию Mac OS определяет константы для кодов языка с помощью этого формата: langXxx. Чтобы указать, что Вы не хотите обеспечивать код языка для этого параметра, укажите константу kTextLanguageDontCare.

    iRegionID

    Допустимый менеджер по Сценарию код области. Менеджер по Сценарию Mac OS определяет константы для кодов области с помощью этого формата: verXxx. Чтобы указать, что Вы не хотите обеспечивать код области для этого параметра, укажите константу kTextRegionDontCare.

    iTextFontname

    Имя шрифта связалось с определенным текстом, кодирующим спецификацию, такую как Символ или Zapf Dingbats или имя любого шрифта, в настоящее время устанавливающегося в системе. Чтобы указать, что Вы не хотите обеспечивать имя шрифта, укажите значение NULL.

    oEncoding

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Эта функция возвраты paramErr если два или больше из входного конфликта значений параметров в некотором роде — например, код языка Mac OS не принадлежит сценарию, код сценария которого Вы указали, или если входные значения параметров недопустимы. Функция возвращает a kTECTableFormatErr закончитесь код, если внутренние таблицы отображения, используемые для перевода, недопустимы.

    Обсуждение

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

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

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

    Имя шрифта, такой как 'Symbol' или 'Zapf Dingbats,' может указать определенный текст, кодирующий основу. Другие имена шрифтов могут указать особые разновидности, связанные с определенным текстом, кодирующим основу. Иначе, имя шрифта используется для получения кода сценария, и этот код сценария будет проверен по любому сценарию, кодируют Вас предоставление (в этом случае, шрифт должен быть установлен; если это не, функция возвращает a paramErr закончитесь код). Если Вы не предоставляете или код языка, или код области и сценарий кодируют Вас предоставление или то, полученное, соответствует системный сценарий, то локализация системы используется для определения надлежащей области и кода языка. Это используется для того, чтобы получить текст, кодирующий основные значения, зависящие от области и языка, такой как kTextEncodingMacTurkish.

    Для получения дополнительной информации посмотрите RevertTextEncodingToScriptInfo текст функции и Кодировки Основного текста.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECCountAvailableTextEncodings(_ numberEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountAvailableTextEncodings ( ItemCount *numberEncodings );

    Параметры

    numberEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Число текстовых кодировок включает каждый экземпляр текстового кодирования. Если различные плагины преобразования будут поддерживать то же текстовое кодирование, то текстовое кодирование будет считаться несколько раз. Например, японский плагин Кодировок поддерживает японца Mac OS, и плагин Кодировок Unicode - также. Начиная с TECGetAvailableTextEncodings функция игнорирует двойной текст, кодирующий спецификации, TECCountAvailableTextEncodings может возвратить число, больше, чем число элементов матрицы, необходимых для availableEncodings [] параметр.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Количества и возвраты число подкодировок текст, кодирующий поддержки.

    Объявление

    Swift

    func TECCountSubTextEncodings(_ inputEncoding: TextEncoding, _ numberOfEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountSubTextEncodings ( TextEncoding inputEncoding, ItemCount *numberOfEncodings );

    Параметры

    inputEncoding

    Текст, кодирующий спецификацию, содержащую подкодировки.

    numberOfEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Подкодировки являются текстовыми кодировками, встраивающимися как часть большего текста, кодирующего спецификацию. Например, EUC-JP содержит римлянина JIS или ASCII, JIS X0208, JIS X0212 и полуширину Katakana от JIS X0201. Не каждое кодирование, которое может быть повреждено в многократные кодировки обязательно, поддерживает эту подпрограмму. Именно до сменного разработчика для решения кодировок могло бы быть полезным для разбивания. Подкодировки не являются тем же как текстом, кодирующим варианты.

    Если кодирование может быть преобразовано в многократные выполнения кодировок (как обозначено целевым основным кодированием kTextEncodingMultiRun), можно вызвать TECGetSubTextEncodings функция для получения списка выходных кодировок. Посмотрите TECCreateOneToManyConverter и TECGetDestinationTextEncodings функции для получения информации.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetAvailableTextEncodings(_ availableEncodings: UnsafeMutablePointer<TextEncoding>, _ maxAvailableEncodings: ItemCount, _ actualAvailableEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetAvailableTextEncodings ( TextEncoding availableEncodings[], ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings );

    Параметры

    availableEncodings

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

    maxAvailableEncodings

    Число текста, кодирующего спецификации availableEncodings массив может содержать.

    actualAvailableEncodings

    По возврату указатель на число текстовых кодировок возвратился в availableEncodings массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetSubTextEncodings(_ inputEncoding: TextEncoding, _ subEncodings: UnsafeMutablePointer<TextEncoding>, _ maxSubEncodings: ItemCount, _ actualSubEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetSubTextEncodings ( TextEncoding inputEncoding, TextEncoding subEncodings[], ItemCount maxSubEncodings, ItemCount *actualSubEncodings );

    Параметры

    inputEncoding

    Текст, кодирующий спецификацию.

    subEncodings

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

    maxSubEncodings

    Число текста, кодирующего спецификации subEncodings массив может содержать.

    actualSubEncodings

    По возврату, указателю на число подкодировок в subEncodings массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Подкодировки являются текстовыми кодировками, встраивающимися как часть большего текста, кодирующего спецификацию. Например, EUC-JP содержит римлянина JIS или ASCII, JIS X0208, JIS X0212 и полуширину Katakana от JIS X0201. Не каждое кодирование, которое может быть повреждено в многократные кодировки обязательно, поддерживает эту подпрограмму. Именно до сменного разработчика для решения кодировок могло бы быть полезным для разбивания. Подкодировки не являются тем же как текстом, кодирующим варианты

    Если кодирование может быть преобразовано в многократные выполнения кодировок (как обозначено целевым основным кодированием kTextEncodingMultiRun), можно вызвать TECGetSubTextEncodings функция для получения списка выходных кодировок. Посмотрите TECCreateOneToManyConverter и TECGetDestinationTextEncodings функции для получения информации о многократном выводе, кодирующем выполненные преобразования.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Получает лучшее и альтернативное текстовое кодирование Mac.

    Объявление

    Swift

    func NearestMacTextEncodings(_ generalEncoding: TextEncoding, _ bestMacEncoding: UnsafeMutablePointer<TextEncoding>, _ alternateMacEncoding: UnsafeMutablePointer<TextEncoding>) -> OSStatus

    Objective C

    OSStatus NearestMacTextEncodings ( TextEncoding generalEncoding, TextEncoding *bestMacEncoding, TextEncoding *alternateMacEncoding );

    Параметры

    generalEncoding

    Текстовое кодирование, для которого Вы хотите получить текстовое кодирование Mac.

    bestMacEncoding

    По возврату текст Mac, кодирующий это лучше всего, соответствует кодирование, указанное generalEncoding параметр.

    alternateMacEncoding

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECCountDirectTextEncodingConversions(_ numberOfEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountDirectTextEncodingConversions ( ItemCount *numberOfEncodings );

    Параметры

    numberOfEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Число прямых преобразований включает каждый экземпляр преобразования. Если различные плагины преобразования поддерживают то же прямое преобразование, прямое преобразование считается несколько раз.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetDirectTextEncodingConversions(_ availableConversions: UnsafeMutablePointer<TECConversionInfo>, _ maxAvailableConversions: ItemCount, _ actualAvailableConversions: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetDirectTextEncodingConversions ( TECConversionInfo availableConversions[], ItemCount maxAvailableConversions, ItemCount *actualAvailableConversions );

    Параметры

    availableConversions

    Массив сочинил текста, кодирующего информационные структуры преобразования, каждая из которых указывает ряд источника и целевых кодировок для типа преобразования. Посмотрите TECConversionInfo для получения дополнительной информации. Необходимо использовать TECGetDirectTextEncodingConversions функция, чтобы определить, как большой для создания массива.

    maxAvailableConversions

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

    actualAvailableConversions

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Количества и возвраты число целевых кодировок, в которые указанное исходное кодирование может быть преобразовано за один шаг.

    Объявление

    Swift

    func TECCountDestinationTextEncodings(_ inputEncoding: TextEncoding, _ numberOfEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountDestinationTextEncodings ( TextEncoding inputEncoding, ItemCount *numberOfEncodings );

    Параметры

    inputEncoding

    Текст, кодирующий спецификацию, описывающую исходный текст.

    numberOfEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetDestinationTextEncodings(_ inputEncoding: TextEncoding, _ destinationEncodings: UnsafeMutablePointer<TextEncoding>, _ maxDestinationEncodings: ItemCount, _ actualDestinationEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetDestinationTextEncodings ( TextEncoding inputEncoding, TextEncoding destinationEncodings[], ItemCount maxDestinationEncodings, ItemCount *actualDestinationEncodings );

    Параметры

    inputEncoding

    Текст, кодирующий спецификацию, описывающую исходный текст.

    destinationEncodings

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

    maxDestinationEncodings

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

    actualDestinationEncodings

    По возврату, указателю на число текста, кодирующего спецификации в целевом массиве кодировок.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Можно вывести на экран имена этих целевых кодировок пользователю.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetInfo(_ tecInfo: UnsafeMutablePointer<TECInfoHandle>) -> OSStatus

    Objective C

    OSStatus TECGetInfo ( TECInfoHandle *tecInfo );

    Параметры

    tecInfo

    Дескриптор к структуре типа TECInfo содержа информацию о преобразователе.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Эта функция может возвратить ошибки памяти.

    Обсуждение

    Когда Вы закончены с дескриптором, Ваше приложение должно избавиться от него использование DisposeHandle. Необходимо также выполнить, любой потребовал preflighting или перестановки памяти перед вызовом TECGetInfo.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECCreateConverter(_ newEncodingConverter: UnsafeMutablePointer<Unmanaged<TECObject>?>, _ inputEncoding: TextEncoding, _ outputEncoding: TextEncoding) -> OSStatus

    Objective C

    OSStatus TECCreateConverter ( TECObjectRef *newEncodingConverter, TextEncoding inputEncoding, TextEncoding outputEncoding );

    Параметры

    newEncodingConverter

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

    inputEncoding

    Текст, кодирующий спецификацию для кодирования исходного текста.

    outputEncoding

    Текст, кодирующий спецификацию для кодирования текста привязки.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Если функция не находит прямой путь преобразования, она создает косвенный путь преобразования. Можно использовать функцию TECCreateConverterFromPath указать явный путь преобразования.

    Необходимо использовать TECDisposeConverter функция для удаления объекта преобразователя.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECCreateConverterFromPath(_ newEncodingConverter: UnsafeMutablePointer<Unmanaged<TECObject>?>, _ inPath: UnsafePointer<TextEncoding>, _ inEncodings: ItemCount) -> OSStatus

    Objective C

    OSStatus TECCreateConverterFromPath ( TECObjectRef *newEncodingConverter, const TextEncoding inPath[], ItemCount inEncodings );

    Параметры

    newEncodingConverter

    Указатель на ссылку на объект преобразователя. По возврату, контрольным точкам к недавно создаваемому текстовому объекту преобразователя.

    inPath

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

    inEncodings

    Число текста, кодирующего спецификации в inPath массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Эта функция быстрее, чем функция TECCreateConverter так как это не должно искать путь преобразования. Можно использовать TECGetDestinationTextEncodings функция для определения каждого шага в последовательности от источника до целевого кодирования.

    Для удаления объекта преобразователя необходимо вызвать функцию TECDisposeConverter.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECClearConverterContextInfo(_ encodingConverter: TECObject!) -> OSStatus

    Objective C

    OSStatus TECClearConverterContextInfo ( TECObjectRef encodingConverter );

    Параметры

    encodingConverter

    Ссылка на текст, кодирующий преобразователь, возражает, что Вы хотите сбросить. Это может быть ссылка, возвращенная TECCreateConverter, TECCreateOneToManyConverter, или TECCreateConverterFromPath функции.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Избавляется от объекта преобразователя.

    Объявление

    Swift

    func TECDisposeConverter(_ newEncodingConverter: TECObject!) -> OSStatus

    Objective C

    OSStatus TECDisposeConverter ( TECObjectRef newEncodingConverter );

    Параметры

    newEncodingConverter

    Ссылка на текст, кодирующий преобразователь, возражает, что Вы хотите удалить. Это может быть ссылкой, возвращенной TECCreateConverter, TECCreateConverterFromPath, или TECCreateOneToManyConverter функции.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECConvertText(_ encodingConverter: TECObject!, _ inputBuffer: ConstTextPtr, _ inputBufferLength: ByteCount, _ actualInputLength: UnsafeMutablePointer<ByteCount>, _ outputBuffer: TextPtr, _ outputBufferLength: ByteCount, _ actualOutputLength: UnsafeMutablePointer<ByteCount>) -> OSStatus

    Objective C

    OSStatus TECConvertText ( TECObjectRef encodingConverter, ConstTextPtr inputBuffer, ByteCount inputBufferLength, ByteCount *actualInputLength, TextPtr outputBuffer, ByteCount outputBufferLength, ByteCount *actualOutputLength );

    Параметры

    encodingConverter

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

    inputBuffer

    Поток текста Вы хотите преобразовать.

    inputBufferLength

    Длина в байтах (UInt8 или unsigned char) из потока текста.

    actualInputLength

    По возврату, указателю на число байтов исходного текста, преобразованных из входного буфера.

    outputBuffer

    Указатель на буфер для потока байтов. На выводе буфер содержит преобразованный текст.

    outputBufferLength

    Длина в байтах outputBuffer параметр.

    actualOutputLength

    По возврату указатель на число байтов преобразованного текста возвратился в outputBuffer параметр.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Если существует недостаточно памяти, доступной для TECConvertText для преобразования текста при выделении внутренних буферов функция возвращает надлежащий код результата Диспетчера памяти.

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

    Обсуждение

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

    • Базируйте длину буфера на оценке требований байта целевого кодирования. Удостоверьтесь, что Вы составляете дополнительные байты, необходимые месту назначения, кодирующему (например, escape-последовательность) в дополнение к фактическому тексту.

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

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

    • Если целевое кодирование является схемой кодировки символов — такой как ISO-2022-JP, начинающийся в ASCII и переключающийся на другие кодированные наборы символов через ограниченные комбинации escape-последовательностей — тогда необходимо выделить достаточно площади для размещения escape-последовательностей тот сигнал переключатели. ISO-2022-JP требует 3 - 5 байтов для escape-последовательности, предшествующей 1-байтовому или 2-байтовому символу, который он представляет. Если Вы выделяете буфер, который составляет меньше чем 5 байтов, функция TECConvertText могла перестать работать, в зависимости от преобразовываемого текста.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECFlushText(_ encodingConverter: TECObject!, _ outputBuffer: TextPtr, _ outputBufferLength: ByteCount, _ actualOutputLength: UnsafeMutablePointer<ByteCount>) -> OSStatus

    Objective C

    OSStatus TECFlushText ( TECObjectRef encodingConverter, TextPtr outputBuffer, ByteCount outputBufferLength, ByteCount *actualOutputLength );

    Параметры

    encodingConverter

    Ссылка на текстовый преобразователь возражает, чье содержание должно быть сброшено. Это может быть ссылкой, возвращенной TECCreateConverter или TECCreateConverterFromPath функции.

    outputBuffer

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

    outputBufferLength

    Длина в байтах буфера, предоставленного outputBuffer параметр.

    actualOutputLength

    По возврату указатель на число байтов преобразованного текста возвратился в буфере, указанном outputBuffer параметр.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    • Базируйте длину буфера на оценке требований байта целевого кодирования. Удостоверьтесь, что Вы составляете дополнительные байты, необходимые месту назначения, кодирующему (например, escape-последовательность) в дополнение к фактическому тексту.

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECConvertTextToMultipleEncodings(_ encodingConverter: TECObject!, _ inputBuffer: ConstTextPtr, _ inputBufferLength: ByteCount, _ actualInputLength: UnsafeMutablePointer<ByteCount>, _ outputBuffer: TextPtr, _ outputBufferLength: ByteCount, _ actualOutputLength: UnsafeMutablePointer<ByteCount>, _ outEncodingsBuffer: UnsafeMutablePointer<TextEncodingRun>, _ maxOutEncodingRuns: ItemCount, _ actualOutEncodingRuns: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECConvertTextToMultipleEncodings ( TECObjectRef encodingConverter, ConstTextPtr inputBuffer, ByteCount inputBufferLength, ByteCount *actualInputLength, TextPtr outputBuffer, ByteCount outputBufferLength, ByteCount *actualOutputLength, TextEncodingRun outEncodingsBuffer[], ItemCount maxOutEncodingRuns, ItemCount *actualOutEncodingRuns );

    Параметры

    encodingConverter

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

    inputBuffer

    Поток текста, который будет преобразован.

    inputBufferLength

    Длина в байтах потока текста, указанного в inputBuffer параметр.

    actualInputLength

    По возврату, указателю на число преобразованных байтов исходного текста.

    outputBuffer

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

    outputBufferLength

    Длина в байтах outputBuffer параметр.

    actualOutputLength

    По возврату указатель на число байтов преобразованного текста возвратился в outputBuffer параметр.

    outEncodingsBuffer

    Массив текста, кодирующего выполнения для вывода. Обратите внимание на то, что фактический размер байта этого буфера должен быть actualOutEncodingRuns * sizeof(TextEncodingRun).

    maxOutEncodingRuns

    Максимальное количество выполнений, которые могут вписаться outEncodingsBuffer массив.

    actualOutEncodingRuns

    По возврату, указателю на число выполнений в outEncodingsBuffer массив.

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

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

    Обсуждение

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

    • Базируйте длину буфера на оценке требований байта целевого кодирования. Удостоверьтесь, что Вы составляете дополнительные байты, необходимые месту назначения, кодирующему (например, escape-последовательность) в дополнение к фактическому тексту.

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

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

    • Если целевое кодирование является схемой кодировки символов — такой как ISO-2022-JP, начинающийся в ASCII и переключающийся на другие кодированные наборы символов через ограниченные комбинации escape-последовательностей — тогда необходимо выделить достаточно площади для размещения escape-последовательностей тот сигнал переключатели. ISO-2022-JP требует 3 - 5 байтов для escape-последовательности, предшествующей 1-байтовому или 2-байтовому символу, который он представляет. Если Вы выделяете буфер, который составляет меньше чем 5 байтов, TECConvertText функция могла перестать работать, в зависимости от преобразовываемого текста.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет путь преобразования для исходного кодирования и целевых кодировок, которые Вы указываете, создает текст, кодирующий объект преобразователя, и возвращает ссылку на него.

    Объявление

    Swift

    func TECCreateOneToManyConverter(_ newEncodingConverter: UnsafeMutablePointer<Unmanaged<TECObject>?>, _ inputEncoding: TextEncoding, _ numOutputEncodings: ItemCount, _ outputEncodings: UnsafePointer<TextEncoding>) -> OSStatus

    Objective C

    OSStatus TECCreateOneToManyConverter ( TECObjectRef *newEncodingConverter, TextEncoding inputEncoding, ItemCount numOutputEncodings, const TextEncoding outputEncodings[] );

    Параметры

    newEncodingConverter

    Указатель на объект преобразователя. По возврату это указывает на недавно создаваемый one-many объект преобразователя.

    inputEncoding

    Текст, кодирующий спецификацию для кодирования исходного текста.

    numOutputEncodings

    Число текста, кодирующего спецификации в outputEncoding массив.

    outputEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Для удаления объекта преобразователя необходимо вызвать функцию TECDisposeConverter.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECFlushMultipleEncodings(_ encodingConverter: TECObject!, _ outputBuffer: TextPtr, _ outputBufferLength: ByteCount, _ actualOutputLength: UnsafeMutablePointer<ByteCount>, _ outEncodingsBuffer: UnsafeMutablePointer<TextEncodingRun>, _ maxOutEncodingRuns: ItemCount, _ actualOutEncodingRuns: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECFlushMultipleEncodings ( TECObjectRef encodingConverter, TextPtr outputBuffer, ByteCount outputBufferLength, ByteCount *actualOutputLength, TextEncodingRun outEncodingsBuffer[], ItemCount maxOutEncodingRuns, ItemCount *actualOutEncodingRuns );

    Параметры

    encodingConverter

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

    outputBuffer

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

    outputBufferLength

    Длина в байтах outputBuffer параметр.

    actualOutputLength

    По возврату указателю на фактическое число байтов преобразованного текста возвратилось в outputBuffer параметр.

    outEncodingsBuffer

    Упорядоченный массив текста, кодирующего выполнения для кодирования текста привязки. Обратите внимание на то, что фактический размер байта этого буфера должен быть actualOutEncodingRuns * sizeof(TextEncodingRun).

    maxOutEncodingRuns

    Максимальное количество кодирования работает, который может вписаться outEncodingsBuffer[].

    actualOutEncodingRuns

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    • Базируйте длину буфера на оценке требований байта целевого кодирования. Удостоверьтесь, что Вы составляете дополнительные байты, необходимые месту назначения, кодирующему (например, escape-последовательность) в дополнение к фактическому тексту.

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

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

    • Если целевое кодирование является схемой кодировки символов — такой как ISO-2022-JP, начинающийся в ASCII и переключающийся на другие кодированные наборы символов через ограниченные комбинации escape-последовательностей — тогда необходимо выделить достаточно площади для размещения escape-последовательностей тот сигнал переключатели. ISO-2022-JP требует 3 - 5 байтов для escape-последовательности, предшествующей 1-байтовому или 2-байтовому символу, который он представляет. Если Вы выделяете буфер, который составляет меньше чем 5 байтов, TECConvertText функция могла перестать работать, в зависимости от преобразовываемого текста.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Получает список целевых кодировок от объекта преобразователя.

    Объявление

    Swift

    func TECGetEncodingList(_ encodingConverter: TECObject!, _ numEncodings: UnsafeMutablePointer<ItemCount>, _ encodingList: UnsafeMutablePointer<Handle>) -> OSStatus

    Objective C

    OSStatus TECGetEncodingList ( TECObjectRef encodingConverter, ItemCount *numEncodings, Handle *encodingList );

    Параметры

    encodingConverter

    Ссылка на текст, кодирующий объект преобразования, возвращенный TECCreateOneToManyConverter функция.

    numEncodings

    По возврату, указателю на число кодировок, указанных encodingList дескриптор.

    encodingList

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    TECDisposeConverter функция автоматически избавляется от указателя для Вас. Это означает, что Вы не должны ссылаться на указатель после избавления от объекта преобразователя.

    Плагины, выполняющие one-many использование преобразований TECGetEncodingList функция для получения выходного списка кодировок от ссылки на объект преобразователя.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECCreateSniffer(_ encodingSniffer: UnsafeMutablePointer<Unmanaged<TECSnifferObject>?>, _ testEncodings: UnsafePointer<TextEncoding>, _ numTextEncodings: ItemCount) -> OSStatus

    Objective C

    OSStatus TECCreateSniffer ( TECSnifferObjectRef *encodingSniffer, const TextEncoding testEncodings[], ItemCount numTextEncodings );

    Параметры

    encodingSniffer

    Указатель на ссылку на объект сниффера, имеющую тип TECSnifferObjectRef. По возврату ссылка принадлежит недавно создаваемому объекту сниффера.

    testEncodings

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

    numTextEncodings

    Число текста, кодирующего спецификации в testEncodings[] массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Для удаления объекта сниффера необходимо вызвать функцию TECDisposeSniffer.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Сбрасывает объект сниффера к его начальным установкам, таким образом, можно снова использовать его.

    Объявление

    Swift

    func TECClearSnifferContextInfo(_ encodingSniffer: TECSnifferObject!) -> OSStatus

    Objective C

    OSStatus TECClearSnifferContextInfo ( TECSnifferObjectRef encodingSniffer );

    Параметры

    encodingSniffer

    Указатель на сниффера возражает, что Вы хотите сбросить.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Избавляется от объекта сниффера.

    Объявление

    Swift

    func TECDisposeSniffer(_ encodingSniffer: TECSnifferObject!) -> OSStatus

    Objective C

    OSStatus TECDisposeSniffer ( TECSnifferObjectRef encodingSniffer );

    Параметры

    encodingSniffer

    Ссылка на объект сниффера Вы хотите удалить.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Эта функция выпускает всю память, выделенную объекту сниффера, создаваемому TECCreateSniffer функция.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Количества и возвраты число снифферов, доступных во всех установленных плагинах.

    Объявление

    Swift

    func TECCountAvailableSniffers(_ numberOfEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountAvailableSniffers ( ItemCount *numberOfEncodings );

    Параметры

    numberOfEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Эта функция считает каждый экземпляр сниффера. Если различные плагины преобразования поддерживают сниффера для того же кодирования, сниффер считается несколько раз. Начиная с TECGetAvailableSniffers функция игнорирует двойных снифферов, TECCountAvailableSniffers может возвратить число, больше, чем число элементов матрицы, необходимых для availableSniffers[] параметр TECGetAvailableSniffers функция.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetAvailableSniffers(_ availableSniffers: UnsafeMutablePointer<TextEncoding>, _ maxAvailableSniffers: ItemCount, _ actualAvailableSniffers: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetAvailableSniffers ( TextEncoding availableSniffers[], ItemCount maxAvailableSniffers, ItemCount *actualAvailableSniffers );

    Параметры

    availableSniffers

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

    maxAvailableSniffers

    Число текста, кодирующего спецификации availableSniffers массив может содержать.

    actualAvailableSniffers

    По возврату, указателю на число текстовых кодировок в availableSniffers массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECSniffTextEncoding(_ encodingSniffer: TECSnifferObject!, _ inputBuffer: ConstTextPtr, _ inputBufferLength: ByteCount, _ testEncodings: UnsafeMutablePointer<TextEncoding>, _ numTextEncodings: ItemCount, _ numErrsArray: UnsafeMutablePointer<ItemCount>, _ maxErrs: ItemCount, _ numFeaturesArray: UnsafeMutablePointer<ItemCount>, _ maxFeatures: ItemCount) -> OSStatus

    Objective C

    OSStatus TECSniffTextEncoding ( TECSnifferObjectRef encodingSniffer, ConstTextPtr inputBuffer, ByteCount inputBufferLength, TextEncoding testEncodings[], ItemCount numTextEncodings, ItemCount numErrsArray[], ItemCount maxErrs, ItemCount numFeaturesArray[], ItemCount maxFeatures );

    Параметры

    encodingSniffer

    Ссылка на объект сниффера.

    inputBuffer

    Текст, который будет сниффинговым.

    inputBufferLength

    Длина входного буфера.

    testEncodings

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

    numTextEncodings

    Число записей в testEncodings[] параметр.

    numErrsArray

    Массив, который должен содержать, по крайней мере, numTextEncodings элементы. По возврату массив числа ошибок найден для каждого возможного текстового кодирования. Элементы матрицы находятся в том же порядке как testEncodings[] элементы матрицы при выводе.

    maxErrs

    Максимальное количество ошибок сниффер может встретиться. Сниффер прекращает искать кодирование после того, как будет достигнуто это число.

    numFeaturesArray

    Массив этого должен содержать, по крайней мере, numTextEncodings элементы. По возврату массив числа функций найден для каждого возможного текстового кодирования. Элементы матрицы находятся в том же порядке как testEncodings[] элементы матрицы при выводе.

    maxFeatures

    Максимальное количество функций сниффер может встретиться. Сниффер прекращает искать функции после того, как будет достигнуто это число.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Например, последовательность байта, интерпретирующаяся в римлянине Mac OS как «В», могла по закону быть интерпретирована или как римский текст Mac OS или как японский текст Mac OS. Оба сниффера возвратили бы нулевые ошибки, но японский сниффер Mac OS также возвратит две функции японца Mac OS (представление двух юридических 2-байтовых символов.)

    Массивы возвращаются в оцениваемом списке с наиболее вероятными текстовыми кодировками сначала. Результаты сортируются сначала числом ошибок (наименьшее количество к большинству), затем числом функций (большинство к наименьшему количеству), и затем первоначальным заказом в списке. По возврату наиболее вероятное кодирование находится в testEncodings[0] или testEncodings[1].

    Если кодирование не исследовано, его номер ошибок и функций определяется к 0xFFFFFFFF, и кодирование сортируется до конца списка.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECCountMailTextEncodings(_ locale: RegionCode, _ numberEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountMailTextEncodings ( RegionCode locale, ItemCount *numberEncodings );

    Параметры

    locale

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

    numberEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Количества и возвраты число в настоящее время поддерживаемых текстовых кодировок для кода области.

    Объявление

    Swift

    func TECCountWebTextEncodings(_ locale: RegionCode, _ numberEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECCountWebTextEncodings ( RegionCode locale, ItemCount *numberEncodings );

    Параметры

    locale

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

    numberEncodings

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Эта функция считает каждый экземпляр того же кодирования. Т.е. если различные плагины преобразования поддерживают то же текстовое кодирование для процесса преобразования, текстовое кодирование считается несколько раз. Начиная с TECGetWebTextEncodings функция игнорирует двойной текст, кодирующий спецификации, TECCountWebTextEncodings может возвратить число, больше, чем число элементов матрицы, необходимых для availableEncodings[] параметр.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Возвращает в настоящее время поддерживаемые почтовые спецификации кодирования для кода области.

    Объявление

    Swift

    func TECGetMailTextEncodings(_ locale: RegionCode, _ availableEncodings: UnsafeMutablePointer<TextEncoding>, _ maxAvailableEncodings: ItemCount, _ actualAvailableEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetMailTextEncodings ( RegionCode locale, TextEncoding availableEncodings[], ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings );

    Параметры

    locale

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

    availableEncodings

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

    maxAvailableEncodings

    Число текста, кодирующего спецификации availableEncodings массив может содержать.

    actualAvailableEncodings

    По возврату, указателю на число текстовых кодировок в availableEncodings массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Возвращает текст Mac OS, кодирующий спецификацию, соответствующую интернет-имени кодирования.

    Объявление

    Swift

    func TECGetTextEncodingFromInternetName(_ textEncoding: UnsafeMutablePointer<TextEncoding>, _ encodingName: ConstStr255Param) -> OSStatus

    Objective C

    OSStatus TECGetTextEncodingFromInternetName ( TextEncoding *textEncoding, ConstStr255Param encodingName );

    Параметры

    textEncoding

    По возврату, указателю на структуру, содержащую текст Mac OS, кодирующий спецификацию.

    encodingName

    Интернет-имя кодирования, в 7-разрядных США ASCII.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Возвращает интернет-имя кодирования, соответствующее текстовому кодированию Mac OS.

    Объявление

    Swift

    func TECGetTextEncodingInternetName(_ textEncoding: TextEncoding, _ encodingName: UnsafeMutablePointer<UInt8>) -> OSStatus

    Objective C

    OSStatus TECGetTextEncodingInternetName ( TextEncoding textEncoding, Str255 encodingName );

    Параметры

    textEncoding

    Текст Mac OS, кодирующий спецификацию.

    encodingName

    По возврату, интернет-имени кодирования, в 7-разрядных США ASCII. Если существует несколько интернет-имен кодирования для того же текстового кодирования, encodingName параметр содержит предпочтительное имя.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TECGetWebTextEncodings(_ locale: RegionCode, _ availableEncodings: UnsafeMutablePointer<TextEncoding>, _ maxAvailableEncodings: ItemCount, _ actualAvailableEncodings: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus TECGetWebTextEncodings ( RegionCode locale, TextEncoding availableEncodings[], ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings );

    Параметры

    locale

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

    availableEncodings

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

    maxAvailableEncodings

    Число текстовых спецификаций кодировок availableEncodings массив может содержать.

    actualAvailableEncodings

    По возврату, указателю на число текстовых спецификаций кодировок в availableEncodings массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func ChangeTextToUnicodeInfo(_ ioTextToUnicodeInfo: TextToUnicodeInfo, _ iUnicodeMapping: ConstUnicodeMappingPtr) -> OSStatus

    Objective C

    OSStatus ChangeTextToUnicodeInfo ( TextToUnicodeInfo ioTextToUnicodeInfo, ConstUnicodeMappingPtr iUnicodeMapping );

    Параметры

    ioTextToUnicodeInfo

    Объект преобразователя Unicode типа TextToUnicodeInfo содержа отображение, которое будет изменено. Вы используете функцию CreateTextToUnicodeInfo получить тот.

    iUnicodeMapping

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Функция заменяет информацию о таблице отображения, в настоящее время существующую в объекте преобразователя Unicode, на который указывают ioTextToUnicodeInfo параметр с информацией, содержавшейся в UnicodeMapping структура Вы предоставляете как iUnicodeMapping параметр.

    ChangeTextToUnicodeInfo сбрасывает поля объекта преобразователя Unicode по мере необходимости.

    Если ошибка возвращается, объект преобразователя Unicode недопустим.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает строку от любого кодирования до Unicode.

    Объявление

    Swift

    func ConvertFromTextToUnicode(_ iTextToUnicodeInfo: TextToUnicodeInfo, _ iSourceLen: ByteCount, _ iSourceStr: ConstLogicalAddress, _ iControlFlags: OptionBits, _ iOffsetCount: ItemCount, _ iOffsetArray: UnsafePointer<ByteOffset>, _ oOffsetCount: UnsafeMutablePointer<ItemCount>, _ oOffsetArray: UnsafeMutablePointer<ByteOffset>, _ iOutputBufLen: ByteCount, _ oSourceRead: UnsafeMutablePointer<ByteCount>, _ oUnicodeLen: UnsafeMutablePointer<ByteCount>, _ oUnicodeStr: UnsafeMutablePointer<UniChar>) -> OSStatus

    Objective C

    OSStatus ConvertFromTextToUnicode ( TextToUnicodeInfo iTextToUnicodeInfo, ByteCount iSourceLen, ConstLogicalAddress iSourceStr, OptionBits iControlFlags, ItemCount iOffsetCount, const ByteOffset iOffsetArray[], ItemCount *oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount *oSourceRead, ByteCount *oUnicodeLen, UniChar oUnicodeStr[] );

    Параметры

    iTextToUnicodeInfo

    Объект преобразователя Unicode типа TextToUnicodeInfo содержание отображения и информации состояния используется для преобразования. Содержание этого объекта преобразователя Unicode изменяется функцией. Ваше приложение получает объект преобразователя Unicode использование функции CreateTextToUnicodeInfo.

    iSourceLen

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

    iSourceStr

    Адрес исходной строки, которая будет преобразована.

    iControlFlags

    Флаги управления преобразованием. Можно использовать Маски Преобразования для установки iControlFlags параметр.

    iOffsetCount

    Число смещений в iOffsetArray параметр. Ваше приложение предоставляет это значение. Число записей в iOffsetArray должны быть меньше, чем число байтов, указанных в iSourceLen. Если Вы не хотите смещения, возвращенные Вам, указать 0 (нуль) для этого параметра.

    iOffsetArray

    Массив типа ByteOffset. На вводе Вы указываете массив, содержащий упорядоченный список значительных байтовых смещений, имеющих отношение к исходной строке. Эти смещения могут идентифицировать шрифт или изменения стиля, например, в исходной строке. Все записи массива должны быть меньше, чем длина в байтах, указанных iSourceLen параметр. Если Вы не хотите смещения, возвращенные к Вашему приложению, указать NULL для этого параметра и 0 (нуль) для iOffsetCount.

    oOffsetCount

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

    oOffsetArray

    Массив типа ByteOffset. По возврату этот массив содержит соответствующие новые смещения для строки Unicode, произведенной преобразователем.

    iOutputBufLen

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

    oSourceRead

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

    oUnicodeLen

    По возврату, указателю на длину в байтах преобразованного потока.

    oUnicodeStr

    Указатель на массив раньше содержал строку Unicode. На вводе это значение указывает на начало массива для преобразованной строки. По возврату этот буфер содержит преобразованную строку Unicode. (Для инструкций по оценке размера необходимого буфера посмотрите обсуждение.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Функция возвращает a noErr закончитесь код, если он полностью преобразовал входную строку в Unicode, не используя символы нейтрализации.

    Обсуждение

    Вы указываете кодирование исходной строки в структуре отображения Unicode, которую Вы передаете функции CreateTextToUnicodeInfo для получения преобразователя Unicode возражают для преобразования. Вы передаете объект преобразователя Unicode, возвращенный CreateTextToUnicodeInfo к ConvertFromTextToUnicode как iTextToUnicodeInfo параметр.

    В дополнение к преобразованию текстовой строки в любом кодировании к Unicode, ConvertFromTextToUnicode функция может отобразить смещения для получения информации о стилях или информации о шрифтах от строки исходного текста до возвращенной преобразованной строки. Преобразователь читает предоставленные приложение смещения, применяющиеся к исходной строке, и возвращает соответствующие новые смещения в преобразованной строке. Если Вы не хотите смещения, при которых информация о шрифтах или информация о стилях происходят отображенные на получившей строке, необходимо передать NULL для iOffsetArray и 0 (нуль) для iOffsetCount.

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

    Например, для 1-байтовых кодировок, таких как Макрочеловек, строка Unicode, по крайней мере, удвоит размер (больше, если это будет использовать несоставленный Unicode) для Макарабика и Макхебрю, соответствующая строка Unicode могла бы быть до шести раз как более. Для большинства 2-байтовых кодировок, например Shift-JIS, строка Unicode будет меньше, чем дважды размер. Для международной устойчивости Ваше приложение должно выделить буфер, в три - четыре раза более крупный, чем исходная строка. Если текстом вывода Unicode является фактически UTF-8 — который мог бы произойти, начавшись с текущего выпуска текста, Кодирующего менеджера по Преобразованию, версию 1.2.1 — буферный указатель UTF-8 должен быть брошен к UniCharArrayPtr прежде чем это сможет быть передано как oUnicodeStr параметр. Кроме того, длина буфера вывода будет иметь более широкий диапазон изменения, чем для UTF-16; для ввода ASCII вывод будет тем же размером; для ханьского ввода вывод будет вдвое более большим и т.д.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateTextToUnicodeInfo(_ iUnicodeMapping: ConstUnicodeMappingPtr, _ oTextToUnicodeInfo: UnsafeMutablePointer<TextToUnicodeInfo>) -> OSStatus

    Objective C

    OSStatus CreateTextToUnicodeInfo ( ConstUnicodeMappingPtr iUnicodeMapping, TextToUnicodeInfo *oTextToUnicodeInfo );

    Параметры

    iUnicodeMapping

    Указатель на структуру типа UnicodeMapping. Ваше приложение обеспечивает эту структуру для идентификации отображения для использования для преобразования. Необходимо предоставить значение типа TextEncoding в unicodeEncoding поле этой структуры. A TextEncoding тройное, составленное из основы кодирования, варианта кодирования и формата. Можно получить a UnicodeMapping значение путем вызывания функции CreateTextEncoding.

    oTextToUnicodeInfo

    По возврату объект преобразователя Unicode содержит информацию таблицы отображения, которую Вы предоставили как UnicodeMapping параметр и информация состояния имели отношение к преобразованию. Эта информация запрашивается для преобразования текстового потока в кодировании не-Unicode к Unicode.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Вы передаете объект преобразователя Unicode, возвращенный от функционального CreateTextToUnicodeInfo до функции ConvertFromTextToUnicode или ConvertFromPStringToUnicode идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта.

    Вы передаете объект преобразователя Unicode, возвращенный из CreateTextToUnicodeInfo к функции TruncateForTextToUnicode идентифицировать информацию, которая будет использоваться для усечения строки. Эта функция не изменяет содержание объекта преобразователя Unicode.

    Если ошибка возвращается, объект преобразователя Unicode недопустим.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateTextToUnicodeInfoByEncoding(_ iEncoding: TextEncoding, _ oTextToUnicodeInfo: UnsafeMutablePointer<TextToUnicodeInfo>) -> OSStatus

    Objective C

    OSStatus CreateTextToUnicodeInfoByEncoding ( TextEncoding iEncoding, TextToUnicodeInfo *oTextToUnicodeInfo );

    Параметры

    iEncoding

    Текст, кодирующий спецификацию для исходного текста.

    oTextToUnicodeInfo

    Объект преобразователя Unicode типа TextToUnicodeInfo возвращенный функцией.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Вы не можете указать версию Unicode. Функция использует 16-разрядную форму Unicode как значение по умолчанию.

    Вы передаете объект преобразователя Unicode, возвращенный из CreateTextToUnicodeInfoByEncoding к функции ConvertFromTextToUnicode или ConvertFromPStringToUnicode идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта преобразователя Unicode.

    Вы передаете объект преобразователя Unicode, возвращенный из CreateTextToUnicodeInfoByEncoding к функции TruncateForTextToUnicode идентифицировать информацию, которая будет использоваться для усечения строки. Эта функция не изменяет содержание объекта преобразователя Unicode.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func DisposeTextToUnicodeInfo(_ ioTextToUnicodeInfo: UnsafeMutablePointer<TextToUnicodeInfo>) -> OSStatus

    Objective C

    OSStatus DisposeTextToUnicodeInfo ( TextToUnicodeInfo *ioTextToUnicodeInfo );

    Параметры

    ioTextToUnicodeInfo

    Указатель на объект преобразователя Unicode типа TextToUnicodeInfo, используемый для преобразования текста к Unicode. На вводе Вы указываете объект расположить. Это должен быть объект, который Ваше приложение создало использование функции CreateTextToUnicodeInfo или CreateTextToUnicodeInfoByEncoding. Вы не должны указывать ни на какой другой тип объекта преобразователя Unicode. Ваше приложение не должно использовать эту функцию с той же структурой несколько раз.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Если Ваше приложение указывает недопустимый объект преобразователя Unicode, такой как NULL, функция возвращает a paramErr код результата.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Повторно инициализирует всю информацию состояния, хранившую объектами контекста.

    Объявление

    Swift

    func ResetTextToUnicodeInfo(_ ioTextToUnicodeInfo: TextToUnicodeInfo) -> OSStatus

    Objective C

    OSStatus ResetTextToUnicodeInfo ( TextToUnicodeInfo ioTextToUnicodeInfo );

    Параметры

    ioTextToUnicodeInfo

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func ChangeUnicodeToTextInfo(_ ioUnicodeToTextInfo: UnicodeToTextInfo, _ iUnicodeMapping: ConstUnicodeMappingPtr) -> OSStatus

    Objective C

    OSStatus ChangeUnicodeToTextInfo ( UnicodeToTextInfo ioUnicodeToTextInfo, ConstUnicodeMappingPtr iUnicodeMapping );

    Параметры

    ioUnicodeToTextInfo

    Объект преобразователя Unicode типа UnicodeToTextInfo быть измененным. Вы используете функцию CreateUnicodeToTextInfo или CreateUnicodeToTextInfoByEncoding получить объект преобразователя Unicode этого типа.

    iUnicodeMapping

    Структура типа UnicodeMapping использоваться. Это - новое отображение, заменяющее существующее отображение в объекте преобразователя Unicode.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Функция заменяет информацию о таблице отображения, в настоящее время существующую в указанном объекте преобразователя Unicode с информацией, содержавшейся в новой структуре отображения Unicode, которую Вы обеспечиваете.

    ChangeUnicodeToTextInfo сбрасывает поля объекта преобразователя Unicode по мере необходимости. Однако это не инициализирует или сбрасывать состояние преобразования, сохраняемое объектом преобразователя Unicode.

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

    Например, можно изменить другое (целевое) кодирование структуры отображения Unicode, на которую указывают iUnicodeMapping параметр, прежде чем Вы вызовете функцию ConvertFromUnicodeToText преобразовать следующий символ или последовательность символов, требующих различного целевого кодирования.

    Если ошибка возвращается, объект преобразователя Unicode недопустим.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func ConvertFromUnicodeToText(_ iUnicodeToTextInfo: UnicodeToTextInfo, _ iUnicodeLen: ByteCount, _ iUnicodeStr: UnsafePointer<UniChar>, _ iControlFlags: OptionBits, _ iOffsetCount: ItemCount, _ iOffsetArray: UnsafePointer<ByteOffset>, _ oOffsetCount: UnsafeMutablePointer<ItemCount>, _ oOffsetArray: UnsafeMutablePointer<ByteOffset>, _ iOutputBufLen: ByteCount, _ oInputRead: UnsafeMutablePointer<ByteCount>, _ oOutputLen: UnsafeMutablePointer<ByteCount>, _ oOutputStr: LogicalAddress) -> OSStatus

    Objective C

    OSStatus ConvertFromUnicodeToText ( UnicodeToTextInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], OptionBits iControlFlags, ItemCount iOffsetCount, const ByteOffset iOffsetArray[], ItemCount *oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount *oInputRead, ByteCount *oOutputLen, LogicalAddress oOutputStr );

    Параметры

    iUnicodeToTextInfo

    Объект преобразователя Unicode типа UnicodeToTextInfo для преобразования текста от Unicode. Вы используете функцию CreateUnicodeToTextInfo или CreateUnicodeToTextInfoByEncoding для получения преобразователя Unicode возражают для указания для этого параметра. Эта функция изменяет содержание iUnicodeToTextInfo параметр.

    iUnicodeLen

    Длина в байтах Unicode представляет в виде строки, чтобы быть преобразованной.

    iUnicodeStr

    Указатель на Unicode представляет в виде строки, чтобы быть преобразованным. Если входной текст является UTF-8, поддерживающимся для версий 1.2.1 или позже преобразователя, необходимо бросить буферный указатель UTF-8 на ConstUniCharArrayPtr прежде чем можно будет передать его как этот параметр.

    iControlFlags

    Флаги управления преобразованием. Можно использовать Маски Преобразования и Маски Направленности для установки iControlFlags параметр.

    iOffsetCount

    Число смещений, содержавшихся в массиве, предоставленном iOffsetArray параметр. Ваше приложение предоставляет это значение. Если Вы не хотите смещения, возвращенные Вам, указать 0 (нуль) для этого параметра.

    iOffsetArray

    Массив типа ByteOffset. На вводе Вы указываете массив, дающий упорядоченный список значительных байтовых смещений, имеющих отношение к исходной строке Unicode, которая будет преобразована. Эти смещения могут идентифицировать шрифт или изменения стиля, например, в исходной строке. Если Вы не хотите смещения, возвращенные к Вашему приложению, указать NULL для этого параметра и 0 (нуль) для iOffsetCount. Все смещения должны быть меньше, чем iUnicodeLen.

    oOffsetCount

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

    oOffsetArray

    Массив типа ByteOffset. По возврату этот массив содержит соответствующие новые смещения для преобразованной строки в новом кодировании.

    iOutputBufLen

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

    oInputRead

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

    oOutputLen

    По возврату, указателю на длину в байтах потока преобразованного текста.

    oOutputStr

    Значение типа LogicalAddress. На вводе это значение указывает на буфер для преобразованной строки. По возврату буфер содержит строку преобразованного текста. (Для инструкций по оценке размера необходимого буфера посмотрите следующее обсуждение.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Ваше приложение должно выделить буфер, чтобы содержать получающуюся преобразованную строку и передать указатель на буфер в oOutputStr параметр. Для определения размера буфера вывода для выделения необходимо рассмотреть размер и содержание исходной строки Unicode в связи с типом кодирования, в которое это будет преобразовано. Например, для многих кодировок, таких как Макрочеловек и Shift-JIS, размер возвращаемой строки будет между половиной размера и тем же размером как исходная строка Unicode. Однако для некоторых кодировок, которые не являются Mac OS, такими как EUC-JP, имеющий приблизительно 3-байтовые символы для Кандзи, возвращаемая строка могла быть больше, чем исходная строка Unicode. Для Макарабика и Макхебрю, результатом обычно будет меньше чем половина размера строки Unicode.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateUnicodeToTextInfo(_ iUnicodeMapping: ConstUnicodeMappingPtr, _ oUnicodeToTextInfo: UnsafeMutablePointer<UnicodeToTextInfo>) -> OSStatus

    Objective C

    OSStatus CreateUnicodeToTextInfo ( ConstUnicodeMappingPtr iUnicodeMapping, UnicodeToTextInfo *oUnicodeToTextInfo );

    Параметры

    iUnicodeMapping

    Указатель на структуру типа UnicodeMapping. Ваше приложение обеспечивает эту структуру для идентификации отображения, которое будет использоваться для преобразования. unicodeEncoding поле этой структуры может указать формат Unicode kUnicode16BitFormat или kUnicodeUTF8Format. Обратите внимание на то, что версии Преобразователя Unicode до 1.2.1 не поддерживают kUnicodeUTF8Format.

    oUnicodeToTextInfo

    По возврату, указателю на объект преобразователя Unicode, содержащий информацию таблицы отображения, которую Вы предоставляете как iUnicodeMapping параметр и информация состояния имели отношение к преобразованию. Информация, содержавшаяся в объекте преобразователя Unicode, запрашивается для преобразования строки Unicode к кодированию не-Unicode.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Вы передаете объект преобразователя Unicode, возвращенный из CreateUnicodeToTextInfo к функции ConvertFromUnicodeToText или ConvertFromUnicodeToPString идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта преобразователя Unicode.

    Если ошибка возвращается, объект преобразователя Unicode недопустим.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateUnicodeToTextInfoByEncoding(_ iEncoding: TextEncoding, _ oUnicodeToTextInfo: UnsafeMutablePointer<UnicodeToTextInfo>) -> OSStatus

    Objective C

    OSStatus CreateUnicodeToTextInfoByEncoding ( TextEncoding iEncoding, UnicodeToTextInfo *oUnicodeToTextInfo );

    Параметры

    iEncoding

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

    oUnicodeToTextInfo

    Указатель на объект преобразователя Unicode типа UnicodeToTextInfo.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Можно использовать эту функцию вместо CreateUnicodeToTextInfo функция для создания преобразователя Unicode. Однако этот метод менее эффективен внутренне, потому что текст привязки, кодирующий Вас, указывает, должен быть разрешен в отображение Unicode. Используя эту функцию, Вы не можете указать версию Unicode, таким образом, используется версия по умолчанию Unicode; 16-разрядный формат принят.

    Вы передаете объект преобразователя Unicode, возвращенный из функции CreateUnicodeToTextInfoByEncoding к функции ConvertFromUnicodeToText или ConvertFromUnicodeToPString идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта преобразователя Unicode.

    Вы передаете объект преобразователя Unicode, возвращенный из CreateUnicodeToTextInfoByEncoding к функции TruncateForUnicodeToText идентифицировать информацию, которая будет использоваться для усечения строки. Эта функция не изменяет содержание объекта преобразователя Unicode.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func DisposeUnicodeToTextInfo(_ ioUnicodeToTextInfo: UnsafeMutablePointer<UnicodeToTextInfo>) -> OSStatus

    Objective C

    OSStatus DisposeUnicodeToTextInfo ( UnicodeToTextInfo *ioUnicodeToTextInfo );

    Параметры

    ioUnicodeToTextInfo

    Указатель на преобразователь Unicode возражает для преобразования от Unicode до кодирования не-Unicode. Вы указываете, что преобразователь Unicode возражает, что Ваше приложение создало использование функции CreateUnicodeToTextInfo или CreateUnicodeToTextInfoByEncoding. Вы не должны указывать ни на какой другой тип объекта преобразователя Unicode. Ваше приложение не должно пытаться избавиться от того же объекта преобразователя Unicode несколько раз.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Функциональные возвраты noErr если это избавляется от объекта преобразователя Unicode успешно. Если Ваше приложение указывает недопустимый объект преобразователя Unicode, такой как NULL, функция возвращает a paramErr код результата.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Повторно инициализирует всю информацию состояния, хранившую объектом преобразователя Unicode.

    Объявление

    Swift

    func ResetUnicodeToTextInfo(_ ioUnicodeToTextInfo: UnicodeToTextInfo) -> OSStatus

    Objective C

    OSStatus ResetUnicodeToTextInfo ( UnicodeToTextInfo ioUnicodeToTextInfo );

    Параметры

    ioUnicodeToTextInfo

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает строку от Unicode до одних или более кодировок.

    Объявление

    Swift

    func ConvertFromUnicodeToTextRun(_ iUnicodeToTextInfo: UnicodeToTextRunInfo, _ iUnicodeLen: ByteCount, _ iUnicodeStr: UnsafePointer<UniChar>, _ iControlFlags: OptionBits, _ iOffsetCount: ItemCount, _ iOffsetArray: UnsafePointer<ByteOffset>, _ oOffsetCount: UnsafeMutablePointer<ItemCount>, _ oOffsetArray: UnsafeMutablePointer<ByteOffset>, _ iOutputBufLen: ByteCount, _ oInputRead: UnsafeMutablePointer<ByteCount>, _ oOutputLen: UnsafeMutablePointer<ByteCount>, _ oOutputStr: LogicalAddress, _ iEncodingRunBufLen: ItemCount, _ oEncodingRunOutLen: UnsafeMutablePointer<ItemCount>, _ oEncodingRuns: UnsafeMutablePointer<TextEncodingRun>) -> OSStatus

    Objective C

    OSStatus ConvertFromUnicodeToTextRun ( UnicodeToTextRunInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], OptionBits iControlFlags, ItemCount iOffsetCount, const ByteOffset iOffsetArray[], ItemCount *oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount *oInputRead, ByteCount *oOutputLen, LogicalAddress oOutputStr, ItemCount iEncodingRunBufLen, ItemCount *oEncodingRunOutLen, TextEncodingRun oEncodingRuns[] );

    Параметры

    iUnicodeToTextInfo

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

    iUnicodeLen

    Длина в байтах Unicode представляет в виде строки, чтобы быть преобразованной.

    iUnicodeStr

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

    iControlFlags

    Флаги управления преобразованием. Следующие константы определяют маски для флагов управления, допустимых для этого параметра. Можно использовать Маски Преобразования и Маски Направленности для установки iControlFlags параметр.

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

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

    Если Вы устанавливаете kUnicodeTextRunBit управляйте флагом, попытки преобразователя преобразовать полную текстовую строку Unicode в первое кодирование, указанное в Unicode, отображающем структуры, выстраивают Вас, передал CreateUnicodeToTextRunInfo, CreateUnicodeToTextRunInfoByEncoding, или CreateUnicodeToTextRunInfoByScriptCode, когда Вы создали объект преобразователя Unicode для этого преобразования. Если это не может сделать этого, преобразователь тогда пытается преобразовать первый текстовый элемент, переставший работать к остающимся кодировкам в их указанном порядке в массиве. То, что преобразователь делает со следующим текстовым элементом, зависит от установки флага управления, «сохраняют то же кодирование».

    Если флаг управления «сохраняет то же кодирование», ясно, преобразователь возвращается к исходному кодированию и пытается продолжать преобразование с тем кодированием; это эквивалентно преобразованию каждого текстового элемента к первому кодированию, работающему в указанном порядке.

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

    iOffsetCount

    Число смещений в массиве, на который указывают iOffsetArray параметр. Ваше приложение предоставляет это значение. Если Вы не хотите смещения, возвращенные Вам, указать 0 (нуль) для этого параметра.

    iOffsetArray

    Массив типа ByteOffset. На вводе Вы указываете массив, содержащий упорядоченный список значительных байтовых смещений, имеющих отношение к исходной строке Unicode. Эти смещения могут идентифицировать шрифт или изменения стиля, например, в строке Unicode. Если Вы не хотите смещения, возвращенные к Вашему приложению, указать NULL для этого параметра и 0 (нуль) для iOffsetCount. Все смещения должны быть меньше, чем iUnicodeLen.

    oOffsetCount

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

    oOffsetArray

    Массив типа ByteOffset. По возврату этот массив содержит соответствующие новые смещения для получающейся преобразованной строки.

    iOutputBufLen

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

    oInputRead

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

    oOutputLen

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

    oOutputStr

    Значение типа LogicalAddress. На вводе это значение указывает на запуск буфера для преобразованной строки. На выводе этот буфер содержит преобразованную строку в одних или более кодировках. Когда ошибка происходит, ConvertFromUnicodeToTextRun функционируйте возвращает преобразованную строку до символа, вызвавшего ошибку. (Для инструкций по оценке размера необходимого буфера посмотрите, что обсуждение следует описаниям параметра.

    iEncodingRunBufLen

    Число текста, кодирующего выполненные элементы, Вы выделили для кодирования выполненный массив, на который указывают oEncodingRuns параметр. Преобразователь возвращает число допустимых выполнений кодирования в расположении, которым указывают oEncodingRunOutLen. Каждая запись в массиве выполнений кодирования указывает смещение начала в преобразованном тексте и его связанное текстовое кодирование.

    oEncodingRunOutLen

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

    oEncodingRuns

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Использовать ConvertFromUnicodeToTextRun функция, необходимо сначала установить массив структур типа UnicodeMapping содержа, в порядке приоритета, отображающейся информации для преобразования. Для создания объекта преобразователя Unicode Вы вызываете CreateUnicodeToTextRunInfo функционируют передающий его массив отображения Unicode, или Вы можете CreateUnicodeToTextRunInfoByEncoding или CreateUnicodeToTextRunInfoByScriptCode функции, берущие массивы текстовых кодировок или кодов сценария вместо массива отображений Unicode. Вы передаете возвращенный объект преобразователя Unicode как iUnicodeToTextInfo параметр, когда Вы вызываете ConvertFromUnicodeToTextRun функция.

    Два из флагов управления, которые можно установить для iControlFlags параметр позволяет Вам управлять, как Преобразователь Unicode использует многократные кодировки в преобразовании текстовой строки. Эти флаги объяснены в описании iControlFlags параметр. Вот сводка того, как использовать эти два флага управления:

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

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

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает строку от Unicode до одного или более сценариев.

    Объявление

    Swift

    func ConvertFromUnicodeToScriptCodeRun(_ iUnicodeToTextInfo: UnicodeToTextRunInfo, _ iUnicodeLen: ByteCount, _ iUnicodeStr: UnsafePointer<UniChar>, _ iControlFlags: OptionBits, _ iOffsetCount: ItemCount, _ iOffsetArray: UnsafePointer<ByteOffset>, _ oOffsetCount: UnsafeMutablePointer<ItemCount>, _ oOffsetArray: UnsafeMutablePointer<ByteOffset>, _ iOutputBufLen: ByteCount, _ oInputRead: UnsafeMutablePointer<ByteCount>, _ oOutputLen: UnsafeMutablePointer<ByteCount>, _ oOutputStr: LogicalAddress, _ iScriptRunBufLen: ItemCount, _ oScriptRunOutLen: UnsafeMutablePointer<ItemCount>, _ oScriptCodeRuns: UnsafeMutablePointer<ScriptCodeRun>) -> OSStatus

    Objective C

    OSStatus ConvertFromUnicodeToScriptCodeRun ( UnicodeToTextRunInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], OptionBits iControlFlags, ItemCount iOffsetCount, const ByteOffset iOffsetArray[], ItemCount *oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount *oInputRead, ByteCount *oOutputLen, LogicalAddress oOutputStr, ItemCount iScriptRunBufLen, ItemCount *oScriptRunOutLen, ScriptCodeRun oScriptCodeRuns[] );

    Параметры

    iUnicodeToTextInfo

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

    iUnicodeLen

    Длина в байтах Unicode представляет в виде строки, чтобы быть преобразованной.

    iUnicodeStr

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

    iControlFlags

    Флаги управления преобразованием. Следующие константы определяют маски для флагов управления, допустимых для этого параметра. Можно использовать Маски Преобразования и Маски Направленности для установки iControlFlags параметр.

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

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

    Если Вы устанавливаете kUnicodeTextRunBit управляйте флагом, попытки преобразователя преобразовать полную текстовую строку Unicode в первый сценарий, указанный в Unicode, отображающем структуры, выстраивают Вас, передал CreateUnicodeToTextRunInfo, CreateUnicodeToTextRunInfoByEncoding, или CreateUnicodeToTextRunInfoByScriptCode создать объект преобразователя Unicode, используемый для этого преобразования. Если это не может сделать этого, преобразователь тогда пытается преобразовать первый текстовый элемент, переставший работать к остающимся сценариям в их указанном порядке в массиве. То, что преобразователь делает со следующим текстовым элементом, зависит от установки флага управления, «сохраняют то же кодирование»:

    Если флаг управления «сохраняет то же кодирование», ясно, преобразователь возвращается к исходному сценарию и пытается продолжать преобразование с тем сценарием; это эквивалентно преобразованию каждого текстового элемента к первому, работающему в указанном порядке.

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

    iOffsetCount

    Число смещений в массиве, на который указывают iOffsetArray параметр. Ваше приложение предоставляет это значение. Число записей в iOffsetArray должна быть меньше чем половина числа байтов, указанных в iUnicodeLen. Если Вы не хотите смещения, возвращенные Вам, указать 0 (нуль) для этого параметра.

    iOffsetArray

    Массив типа ByteOffset. На вводе Вы указываете массив, содержащий упорядоченный список значительных байтовых смещений, имеющих отношение к исходной строке Unicode. Эти смещения могут идентифицировать шрифт или изменения стиля, например, в строке Unicode. Если Вы не хотите смещения, возвращенные к Вашему приложению, указать NULL для этого параметра и 0 (нуль) для iOffsetCount.

    oOffsetCount

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

    oOffsetArray

    Массив типа ByteOffset. По возврату этот массив содержит соответствующие новые смещения для получающейся преобразованной строки.

    iOutputBufLen

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

    oInputRead

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

    oOutputLen

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

    oOutputStr

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

    iScriptRunBufLen

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

    oScriptRunOutLen

    Указатель на значение типа ItemCount. На выводе это значение содержит число допустимых выполнений кода сценария, возвращенных в oScriptCodeRuns параметр.

    oScriptCodeRuns

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Использовать ConvertFromUnicodeToScriptCodeRun функция, необходимо сначала установить массив кодов сценария, содержащих в порядке приоритета сценарии, которые будут использоваться для преобразования. Для создания объекта преобразователя Unicode Вы вызываете функцию CreateUnicodeToTextRunInfoByScriptCode. Вы передаете возвращенный объект преобразователя Unicode как iUnicodeToTextInfo параметр, когда Вы вызываете ConvertFromUnicodeToScriptCodeRun функция.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateUnicodeToTextRunInfo(_ iNumberOfMappings: ItemCount, _ iUnicodeMappings: UnsafePointer<UnicodeMapping>, _ oUnicodeToTextInfo: UnsafeMutablePointer<UnicodeToTextRunInfo>) -> OSStatus

    Objective C

    OSStatus CreateUnicodeToTextRunInfo ( ItemCount iNumberOfMappings, const UnicodeMapping iUnicodeMappings[], UnicodeToTextRunInfo *oUnicodeToTextInfo );

    Параметры

    iNumberOfMappings

    Число отображений, указанных Вашим приложением для преобразования от Unicode до любых других типов кодировки, включая другие формы Unicode. Если Вы передадите 0 для этого параметра, то преобразователь будет использовать все сценарии, установленные в системе. Основной сценарий является тем с самым высоким приоритетом; ScriptOrder ('itlm' ресурс), определяет приоритет остальных. При установке старшего бита для этого параметра преобразователь Unicode предполагает что iEncodings параметр содержит единственный элемент, указывающий предпочтительное кодирование. Эта функция поддерживается для версий 1.2 или позже преобразователя.

    iUnicodeMappings

    Указатель на массив структур типа UnicodeMapping. Ваше приложение обеспечивает эту структуру для идентификации отображений, которые будут использоваться для преобразования. Порядок, в котором Вы указываете отображения, определяет приоритет целевых кодировок. Для этой функции структура отображения Unicode может указать формат Unicode kUnicode16BitFormat или kUnicodeUTF8Format. Обратите внимание на то, что версии Преобразователя Unicode до текста, Кодирующего менеджера по Преобразованию 1.2.1, не поддерживают kUnicodeUTF8Format. Кроме того, отметьте что unicodeEncoding поле должно быть тем же для всех записей в iUnicodeMappings. Если Вы передаете NULL для iUnicodeMappings параметр, преобразователь использует все сценарии, установленные в системе, принимая версию по умолчанию Unicode с 16-разрядным форматом. Основной сценарий является тем с самым высоким приоритетом и ScriptOrder('itlm' ресурс), определяет приоритет остальных. Это поддерживается, начинаясь с версии 1.2 текста, Кодирующего менеджера по Преобразованию.

    oUnicodeToTextInfo

    Указатель на преобразователь Unicode возражает для преобразования текстовых строк Unicode к строкам в одних или более кодировках не-Unicode. По возврату, указателю на объект преобразователя Unicode, содержащий информацию таблицы отображения, которую Вы предоставляете как iUnicodeMappings параметр и информация состояния имели отношение к преобразованию.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Вы передаете объект преобразователя Unicode, возвращенный из функции CreateUnicodeToTextRunInfo к функции ConvertFromUnicodeToTextRun или ConvertFromUnicodeToScriptCodeRun идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта преобразователя Unicode.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateUnicodeToTextRunInfoByEncoding(_ iNumberOfEncodings: ItemCount, _ iEncodings: UnsafePointer<TextEncoding>, _ oUnicodeToTextInfo: UnsafeMutablePointer<UnicodeToTextRunInfo>) -> OSStatus

    Objective C

    OSStatus CreateUnicodeToTextRunInfoByEncoding ( ItemCount iNumberOfEncodings, const TextEncoding iEncodings[], UnicodeToTextRunInfo *oUnicodeToTextInfo );

    Параметры

    iNumberOfEncodings

    Число желаемых кодировок. Если Вы передадите 0 для этого параметра, то преобразователь будет использовать все сценарии, установленные в системе. Основной сценарий является тем с самым высоким приоритетом; ScriptOrder('itlm' ресурс), определяет приоритет остальных. При установке старшего бита для этого параметра преобразователь Unicode предполагает что iEncodings параметр содержит единственный элемент, указывающий предпочтительное кодирование. Эта функция поддерживается для версий 1.2 или позже преобразователя.

    iEncodings

    Массив текста, кодирующего спецификации для желаемых кодировок. Ваше приложение обеспечивает эту структуру для идентификации кодировок, которые будут использоваться для преобразования. Порядок, в котором Вы указываете кодировки, определяет приоритет целевых кодировок. Если Вы передаете NULL для этого параметра преобразователь будет использовать все сценарии, установленные в системе. Основной сценарий является тем с самым высоким приоритетом и ScriptOrder('itlm'ресурс), определяет приоритет остальных. Эта функция поддерживается для версий 1.2 или позже преобразователя.

    oUnicodeToTextInfo

    Указатель на преобразователь Unicode возражает для преобразования текстовых строк Unicode к строкам в одних или более кодировках не-Unicode. По возврату, указателю на объект преобразователя Unicode, содержащий кодировки, которые Вы предоставляете как iEncodings параметр и информация состояния имели отношение к преобразованию.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Вы передаете объект преобразователя Unicode, возвращенный из CreateUnicodeToTextRunInfoByEncoding к функции ConvertFromUnicodeToTextRun или ConvertFromUnicodeToScriptCodeRun идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта преобразователя Unicode.

    Если ошибка возвращается, объект преобразователя недопустим.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CreateUnicodeToTextRunInfoByScriptCode(_ iNumberOfScriptCodes: ItemCount, _ iScripts: UnsafePointer<ScriptCode>, _ oUnicodeToTextInfo: UnsafeMutablePointer<UnicodeToTextRunInfo>) -> OSStatus

    Objective C

    OSStatus CreateUnicodeToTextRunInfoByScriptCode ( ItemCount iNumberOfScriptCodes, const ScriptCode iScripts[], UnicodeToTextRunInfo *oUnicodeToTextInfo );

    Параметры

    iNumberOfScriptCodes

    Число желаемых сценариев. Если Вы передаете 0 для этого параметра, преобразователь использует все сценарии, установленные в системе. В этом случае основной сценарий является тем с самым высоким приоритетом; ScriptOrder (’itlm’ ресурс), определяет приоритет остальных. При установке старшего бита для этого параметра преобразователь Unicode предполагает что iScripts параметр содержит единственный элемент, указывающий предпочтительный сценарий. Эта функция поддерживается, начинаясь с текста, Кодирующего менеджера по Преобразованию 1.2.

    iScripts

    Массив сценария кодирует для желаемых сценариев. Ваше приложение обеспечивает эту структуру для идентификации сценариев, которые будут использоваться для преобразования. Порядок, в котором Вы указываете сценарии, определяет их приоритет. Если Вы передаете NULL для этого параметра преобразователь использует все сценарии, установленные в системе. В этом случае основной сценарий является тем с самым высоким приоритетом, и порядок приоритетов остающихся сценариев определяется ScriptOrder(itlm resource) ресурс. Эта функция поддерживается для версий 1.2 или позже преобразователя.

    oUnicodeToTextInfo

    Указатель на преобразователь Unicode возражает для преобразования текстовых строк Unicode к строкам в одних или более кодировках не-Unicode. По возврату, указателю на объект преобразователя Unicode, содержащий сценарии, которые Вы предоставляете как iScripts параметр и информация состояния имели отношение к преобразованию.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Вы передаете объект преобразователя Unicode, возвращенный из CreateUnicodeToTextRunInfoByScriptCode к функции ConvertFromUnicodeToTextRun или ConvertFromUnicodeToScriptCodeRun идентифицировать информацию, которая будет использоваться для преобразования. Эти две функции изменяют содержание объекта преобразователя Unicode.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func DisposeUnicodeToTextRunInfo(_ ioUnicodeToTextRunInfo: UnsafeMutablePointer<UnicodeToTextRunInfo>) -> OSStatus

    Objective C

    OSStatus DisposeUnicodeToTextRunInfo ( UnicodeToTextRunInfo *ioUnicodeToTextRunInfo );

    Параметры

    ioUnicodeToTextRunInfo

    Указатель на объект преобразователя Unicode. На вводе Вы указываете, что преобразователь Unicode возражает что точки против информации о преобразовании для расположения. Это должен быть объект, который Ваше приложение создало использование функции CreateUnicodeToTextRunInfo, CreateUnicodeToTextRunInfoByEncoding, или CreateUnicodeToTextRunInfoByScriptCode. Необходимо указать на любой другой тип объекта преобразователя Unicode. Ваше приложение не должно использовать эту функцию с той же структурой несколько раз.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Если Ваше приложение указывает недопустимый объект преобразователя Unicode, такой как NULL, функциональные возвраты paramErr.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Повторно инициализирует всю информацию состояния, хранившую объектами контекста в преобразованиях TextRun.

    Объявление

    Swift

    func ResetUnicodeToTextRunInfo(_ ioUnicodeToTextRunInfo: UnicodeToTextRunInfo) -> OSStatus

    Objective C

    OSStatus ResetUnicodeToTextRunInfo ( UnicodeToTextRunInfo ioUnicodeToTextRunInfo );

    Параметры

    ioUnicodeToTextRunInfo

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает строку Паскаля в текстовом кодировании Mac OS к строке Unicode.

    Объявление

    Swift

    func ConvertFromPStringToUnicode(_ iTextToUnicodeInfo: TextToUnicodeInfo, _ iPascalStr: ConstStr255Param, _ iOutputBufLen: ByteCount, _ oUnicodeLen: UnsafeMutablePointer<ByteCount>, _ oUnicodeStr: UnsafeMutablePointer<UniChar>) -> OSStatus

    Objective C

    OSStatus ConvertFromPStringToUnicode ( TextToUnicodeInfo iTextToUnicodeInfo, ConstStr255Param iPascalStr, ByteCount iOutputBufLen, ByteCount *oUnicodeLen, UniChar oUnicodeStr[] );

    Параметры

    iTextToUnicodeInfo

    Объект преобразователя Unicode типа TextToUnicodeInfo поскольку Паскаль представляет в виде строки, чтобы быть преобразованным. Можно использовать функцию CreateTextToUnicodeInfo или CreateTextToUnicodeInfoByEncoding создать объект преобразователя Unicode.

    iPascalStr

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

    iOutputBufLen

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

    oUnicodeLen

    По возврату указатель на длину в байтах преобразованной строки Unicode возвратился в oUnicodeStr параметр.

    oUnicodeStr

    Указатель на массив символа Unicode. По возврату этот массив содержит преобразованную строку Unicode.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Преобразовывает строку Unicode в Паскаль в текстовом кодировании Mac OS.

    Объявление

    Swift

    func ConvertFromUnicodeToPString(_ iUnicodeToTextInfo: UnicodeToTextInfo, _ iUnicodeLen: ByteCount, _ iUnicodeStr: UnsafePointer<UniChar>, _ oPascalStr: UnsafeMutablePointer<UInt8>) -> OSStatus

    Objective C

    OSStatus ConvertFromUnicodeToPString ( UnicodeToTextInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], Str255 oPascalStr );

    Параметры

    iUnicodeToTextInfo

    Объект преобразователя Unicode. Вы используете CreateUnicodeToTextInfo или CreateUnicodeToTextInfoByEncoding функция для получения преобразователя Unicode возражает для преобразования.

    iUnicodeLen

    Длина в байтах Unicode представляет в виде строки, чтобы быть преобразованной. Это - строка, которую Ваше приложение обеспечивает в iUnicodeStr параметр.

    iUnicodeStr

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

    oPascalStr

    Буфер. По возврату, преобразованная строка Паскаля, возвращенная функцией.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    ConvertFromUnicodeToPString функция обеспечивает простой и эффективный способ преобразовать строку Unicode в строку Паскаля в текстовом кодировании Mac OS, не подвергаясь издержкам, связанным с использованием функции ConvertFromUnicodeToText или ConvertFromUnicodeToScriptCodeRun.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func CountUnicodeMappings(_ iFilter: OptionBits, _ iFindMapping: ConstUnicodeMappingPtr, _ oActualCount: UnsafeMutablePointer<ItemCount>) -> OSStatus

    Objective C

    OSStatus CountUnicodeMappings ( OptionBits iFilter, ConstUnicodeMappingPtr iFindMapping, ItemCount *oActualCount );

    Параметры

    iFilter

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

    iFindMapping

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

    oActualCount

    По возврату найден указатель на число соответствия отображений.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func QueryUnicodeMappings(_ iFilter: OptionBits, _ iFindMapping: ConstUnicodeMappingPtr, _ iMaxCount: ItemCount, _ oActualCount: UnsafeMutablePointer<ItemCount>, _ oReturnedMappings: UnsafeMutablePointer<UnicodeMapping>) -> OSStatus

    Objective C

    OSStatus QueryUnicodeMappings ( OptionBits iFilter, ConstUnicodeMappingPtr iFindMapping, ItemCount iMaxCount, ItemCount *oActualCount, UnicodeMapping oReturnedMappings[] );

    Параметры

    iFilter

    Флаги управления фильтром, представляющие шесть значений, данных в структуре отображения Unicode, что эта функция использование для соответствия против в определении, который отображения в системе возвратиться к приложению. Перечисления флага управления фильтром, описанные в Масках Соответствия Unicode, определяют константы для флагов и их масок. Можно включать в критерии поиска любой три текста, кодирующие значения — основу, вариант, и формат — и для кодирования Unicode и для другого указанного кодирования. Для любого флага, не включенного, проигнорировано значение, функция не проверяет соответствующее значение таблиц отображения в системе.

    iFindMapping

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

    iMaxCount

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

    oActualCount

    По возврату найден указатель на число соответствия отображений. Это число может быть больше, чем число отображений, указанных iMaxCount если больше соответствующих отображений найдено, чем может вписаться oReturnedMappings массив.

    oReturnedMappings

    Указатель на массив структур типа UnicodeMapping. На вводе этот указатель относится к массиву для соответствующих отображений, возвращенных функцией. Для выделения достаточных элементов для массива можно использовать функцию CountUnicodeMappings определить число отображений возвратилось для данных значений iFilter и iFindMapping параметры. По возврату, указателю на массив, содержащий соответствующие отображения. Если существует больше соответствий, чем массив может содержать, функциональные возвраты столько из них, сколько будет соответствовать и a kTECBufferBelowMinimumSizeErr ошибочный результат. oActualCount параметр идентифицирует число соответствия отображений, фактически найденных, который может быть больше, чем возвратилось число.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Если функция возвращает a noErr закончитесь код, значение, повторно настроенное в oActualCount параметр меньше чем или равен значению, возвращенному в iMaxCount параметр и oReturnedMappings параметр содержит все соответствующие найденные отображения. Если функция возвращает a kTECArrayFullErr, функция нашла больше отображений, чем Ваш oReturnedMappings массив мог разместить.

    Обсуждение

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

    Можно использовать функцию для получения очень определенных отображений путем установки отдельных флагов управления фильтром. Можно отфильтровать на любом трех текстах, кодирующих подполя Unicode, отображающего структуру unicodeEncoding спецификация и на любом трех текстах, кодирующих подполя отображения otherEncoding спецификация. iFilter параметр состоит из ряда шести флагов управления, которые Вы устанавливаете для идентификации который из соответствующих шести подполей для включения в соответствие. Список обеспечил в oReturnedMappings параметр будет содержать только отображения, соответствующие поля структуры отображения Unicode, текстовые подполя кодировок которой Вы идентифицируете во флагах управления фильтром. Никакая фильтрация не выполняется на подполях, для которых Вы не устанавливаете соответствующий флаг управления фильтром.

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

    • iFindMapping.unicodeMapping = CreateTextEncoding(
    • kTextEncodingUnicodeV1_1,
    • kTextEncodingDefaultVariant,
    • kTextEncodingDefaultFormat);
    • iFindMapping.otherEncoding = CreateTextEncoding(
    • kTextEncodingMacRoman,
    • kTextEncodingDefaultVariant,
    • kTextEncodingDefaultFormat);
    • iFilter = kUnicodeMatchUnicodeBaseMask |
    • kUnicodeMatchUnicodeVariantMask |
    • kUnicodeMatchUnicodeFormatMask |
    • kUnicodeMatchOtherVariantMask |
    • kUnicodeMatchOtherFormatMask;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TruncateForTextToUnicode(_ iTextToUnicodeInfo: ConstTextToUnicodeInfo, _ iSourceLen: ByteCount, _ iSourceStr: ConstLogicalAddress, _ iMaxLen: ByteCount, _ oTruncatedLen: UnsafeMutablePointer<ByteCount>) -> OSStatus

    Objective C

    OSStatus TruncateForTextToUnicode ( ConstTextToUnicodeInfo iTextToUnicodeInfo, ByteCount iSourceLen, ConstLogicalAddress iSourceStr, ByteCount iMaxLen, ByteCount *oTruncatedLen );

    Параметры

    iTextToUnicodeInfo

    Объект преобразователя Unicode типа TextToUnicodeInfo для текстовой строки, которая будет разделена с каждым сегментом, должным образом усеченным. TruncateForTextToUnicode функция не изменяет содержание объекта.

    iSourceLen

    Длина в байтах байтовой строки, которая будет разделена.

    iSourceStr

    Адрес байтовой строки, которая будет разделена.

    iMaxLen

    Максимальная допустимая длина строки, чтобы быть усеченным. Это должно быть меньше чем или равно iSourceLen.

    oTruncatedLen

    Указатель на значение типа ByteCount. По возврату это значение содержит длину самой длинной части байтовой строки, которой указывают iSourceStr, это меньше чем или равно длине, указанной iMaxLen. Это идентифицирует байт, после которого можно повредить строку.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

    Поскольку TruncateForTextToUnicode функция не изменяет содержание объекта преобразователя Unicode, можно вызвать эту функцию безопасно между вызовами к функции ConvertFromTextToUnicode.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func TruncateForUnicodeToText(_ iUnicodeToTextInfo: ConstUnicodeToTextInfo, _ iSourceLen: ByteCount, _ iSourceStr: UnsafePointer<UniChar>, _ iControlFlags: OptionBits, _ iMaxLen: ByteCount, _ oTruncatedLen: UnsafeMutablePointer<ByteCount>) -> OSStatus

    Objective C

    OSStatus TruncateForUnicodeToText ( ConstUnicodeToTextInfo iUnicodeToTextInfo, ByteCount iSourceLen, const UniChar iSourceStr[], OptionBits iControlFlags, ByteCount iMaxLen, ByteCount *oTruncatedLen );

    Параметры

    iUnicodeToTextInfo

    Объект преобразователя Unicode UnicodeToTextInfo поскольку Unicode представляет в виде строки, чтобы быть разделенным. TruncateForUnicodeToText функция не изменяет содержание этой частной структуры.

    iSourceLen

    Длина в байтах Unicode представляет в виде строки, чтобы быть разделенной.

    iSourceStr

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

    iControlFlags

    Флаги управления усечением. Укажите флаг kUnicodeStringUnterminatedMask при усечении буфера текста, принадлежащего более длинному потоку, содержащему последующий буфер текста, который мог иметь символы, принадлежащие текстовому элементу, начинающемуся в конце текущего буфера. При установке этого флага обычно Вы установили бы iMaxLen параметр, равный iSourceLen.

    iMaxLen

    Максимальная допустимая длина строки, чтобы быть усеченным. Это должно быть меньше чем или равно iSourceLen.

    oTruncatedLen

    Указатель на значение типа ByteCount. По возврату это значение содержит длину самой длинной части исходной строки Unicode, на которую указывают iSourceStr параметр, который меньше чем или равен значению iMaxLen параметр. Этот возвращенный параметр идентифицирует байт, после которого можно усечь строку.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

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

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func SetFallbackUnicodeToText(_ iUnicodeToTextInfo: UnicodeToTextInfo, _ iFallback: UnicodeToTextFallbackUPP, _ iControlFlags: OptionBits, _ iInfoPtr: LogicalAddress) -> OSStatus

    Objective C

    OSStatus SetFallbackUnicodeToText ( UnicodeToTextInfo iUnicodeToTextInfo, UnicodeToTextFallbackUPP iFallback, OptionBits iControlFlags, LogicalAddress iInfoPtr );

    Параметры

    iUnicodeToTextInfo

    Преобразователь Unicode \The возражает, с которым должен быть связан обработчик нейтрализации. Вы используете функцию CreateUnicodeToTextInfo или CreateUnicodeToTextInfoByEncoding получить объект преобразователя Unicode этого типа.

    iFallback

    Универсальный указатель процедуры на определенную с помощью приложения подпрограмму нейтрализации. Для описания прототипа функции, что Ваш обработчик нейтрализации должен придерживаться и как создать Ваш собственный обработчик нейтрализации, посмотрите UnicodeToTextFallbackProcPtr. Необходимо использовать NewUnicodeToTextFallbackProc макрос для преобразования указателя на обработчик нейтрализации в a UnicodeToTextFallbackUPP.

    iControlFlags

    Флаги управления, предусматривающие, который обработчик нейтрализации Преобразователь Unicode должен вызвать — определенный с помощью приложения обработчик нейтрализации или обработчик по умолчанию — если обработчик нейтрализации требуется, и последовательность, в которой Преобразователь Unicode должен вызвать обработчики нейтрализации, если или может использоваться, когда другие сбои или недоступно. Посмотрите Селекторы Обработчика Нейтрализации.

    iInfoPtr

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Можно определить многократные обработчики нейтрализации и связать их с различными объектами преобразователя Unicode, в зависимости от требований. Посмотрите UnicodeToTextFallbackProcPtr для описания того, как создать и установить определенный с помощью приложения обработчик нейтрализации.

    Можно использовать обработчик нейтрализации когда одна из функций преобразования Unicode, ConvertFromUnicodeToText , ConvertFromUnicodeToTextRun , ConvertFromUnicodeToPString , и ConvertFromUnicodeToScriptCodeRun , не может преобразовать текст с помощью таблицы отображения, указанной объектом преобразователя Unicode, переданным функции.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    func SetFallbackUnicodeToTextRun(_ iUnicodeToTextRunInfo: UnicodeToTextRunInfo, _ iFallback: UnicodeToTextFallbackUPP, _ iControlFlags: OptionBits, _ iInfoPtr: LogicalAddress) -> OSStatus

    Objective C

    OSStatus SetFallbackUnicodeToTextRun ( UnicodeToTextRunInfo iUnicodeToTextRunInfo, UnicodeToTextFallbackUPP iFallback, OptionBits iControlFlags, LogicalAddress iInfoPtr );

    Параметры

    iUnicodeToTextRunInfo

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

    iFallback

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

    iControlFlags

    Флаги управления, предусматривающие, который обработчик нейтрализации Преобразователь Unicode должен вызвать — определенный с помощью приложения обработчик нейтрализации или обработчик по умолчанию — если обработчик нейтрализации требуется, и последовательность, в которой Преобразователь Unicode должен вызвать обработчики нейтрализации, если или может использоваться, когда другие сбои или недоступно. Посмотрите Селекторы Обработчика Нейтрализации.

    iInfoPtr

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

    Обсуждение

    Можно определить многократные обработчики нейтрализации и связать их с различными объектами преобразователя Unicode, в зависимости от требований. Посмотрите UnicodeToTextFallbackProcPtr для описания того, как создать и установить определенный с помощью приложения обработчик нейтрализации.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Создает новый универсальный указатель процедуры (UPP) к обратному вызову нейтрализации Unicode к тексту.

    Объявление

    Swift

    func NewUnicodeToTextFallbackUPP(_ userRoutine: UnicodeToTextFallbackProcPtr) -> UnicodeToTextFallbackUPP

    Objective C

    UnicodeToTextFallbackUPP NewUnicodeToTextFallbackUPP ( UnicodeToTextFallbackProcPtr userRoutine );

    Параметры

    userRoutine

    Указатель на Ваш обратный вызов нейтрализации Unicode к тексту.

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

    По возврату, UPP к обратному вызову нейтрализации Unicode к тексту.

    Обсуждение

    Посмотрите обратный вызов UnicodeToTextFallbackProcPtr для получения дополнительной информации.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Избавляется от нового универсального указателя процедуры (UPP) к обратному вызову нейтрализации Unicode к тексту.

    Объявление

    Swift

    func DisposeUnicodeToTextFallbackUPP(_ userUPP: UnicodeToTextFallbackUPP)

    Objective C

    void DisposeUnicodeToTextFallbackUPP ( UnicodeToTextFallbackUPP userUPP );

    Параметры

    userUPP

    Универсальный указатель процедуры.

    Обсуждение

    Посмотрите обратный вызов UnicodeToTextFallbackProcPtr для получения дополнительной информации.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Вызывает Ваш обратный вызов нейтрализации Unicode к тексту.

    Объявление

    Swift

    func InvokeUnicodeToTextFallbackUPP(_ iSrcUniStr: UnsafeMutablePointer<UniChar>, _ iSrcUniStrLen: ByteCount, _ oSrcConvLen: UnsafeMutablePointer<ByteCount>, _ oDestStr: TextPtr, _ iDestStrLen: ByteCount, _ oDestConvLen: UnsafeMutablePointer<ByteCount>, _ iInfoPtr: LogicalAddress, _ iUnicodeMappingPtr: ConstUnicodeMappingPtr, _ userUPP: UnicodeToTextFallbackUPP) -> OSStatus

    Objective C

    OSStatus InvokeUnicodeToTextFallbackUPP ( UniChar *iSrcUniStr, ByteCount iSrcUniStrLen, ByteCount *oSrcConvLen, TextPtr oDestStr, ByteCount iDestStrLen, ByteCount *oDestConvLen, LogicalAddress iInfoPtr, ConstUnicodeMappingPtr iUnicodeMappingPtr, UnicodeToTextFallbackUPP userUPP );

    Обсуждение

    Вы не должны должны быть использовать функцию InvokeUnicodeToTextFallbackUPP, как системные вызовы Ваш обратный вызов нейтрализации Unicode к тексту для Вас. Посмотрите обратный вызов UnicodeToTextFallbackProcPtr для получения дополнительной информации.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Получает значение, связанное с типом свойства для указанного UniChar символы.

    Объявление

    Swift

    func UCGetCharProperty(_ charPtr: UnsafePointer<UniChar>, _ textLength: UniCharCount, _ propType: UCCharPropertyType, _ propValue: UnsafeMutablePointer<UCCharPropertyValue>) -> OSStatus

    Objective C

    OSStatus UCGetCharProperty ( const UniChar *charPtr, UniCharCount textLength, UCCharPropertyType propType, UCCharPropertyValue *propValue );

    Параметры

    charPtr

    Указатель на текст Unicode, значение свойства которого Вы хотите получить.

    textLength

    Длина текста, которым указывают charPtr.

    propType

    Тип свойства для UniChar символ, значение которого Вы хотите получить. Посмотрите Типы Свойства Символа Unicode для списка констант, которые можно предоставить.

    propValue

    По возврату значение связалось с типом свойства, указанным propType параметр. Посмотрите Значения свойств Символа Unicode для списка констант, которые могут быть возвращены.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

Обратные вызовы

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

    Объявление

    Swift

    typealias UnicodeToTextFallbackProcPtr = CFunctionPointer<((UnsafeMutablePointer<UniChar>, ByteCount, UnsafeMutablePointer<ByteCount>, TextPtr, ByteCount, UnsafeMutablePointer<ByteCount>, LogicalAddress, ConstUnicodeMappingPtr) -> OSStatus)>

    Objective C

    typedef OSStatus (*UnicodeToTextFallbackProcPtr) ( UniChar * iSrcUniStr, ByteCount iSrcUniStrLen, ByteCount * oSrcConvLen, TextPtr oDestStr, ByteCount iDestStrLen, ByteCount * oDestConvLen, LogicalAddress iInfoPtr, ConstUnicodeMappingPtr iUnicodeMappingPtr );

    Параметры

    iSrcUniStr

    Указатель на единственный символ UTF-16, который будет отображен обработчиком нейтрализации.

    iSrcUniStrLen

    Длина в байтах символа UTF-16, обозначенного iSrcUniStr параметр. Обычно это - 2 байта, но это могли быть 4 байта для non-BMP символа.

    oSrcConvLen

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

    oDestStr

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

    iDestStrLen

    Максимальный размер в байтах буфера, предоставленного oDestStr параметр.

    oDestConvLen

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

    iInfoPtr

    Указатель на блок памяти, выделенной Вашим приложением, которое может использоваться Вашим обработчиком нейтрализации всегда, что Вам нравится. Это - тот же указатель, переданный как последний параметр SetFallbackUnicodeToText или SetFallbackUnicodeToTextRun. То, как Вы используете данные, переданные Вам в этом блоке памяти, определено к Вашему обработчику. Это подобно в использовании ссылочной константе (refcon).

    iUnicodeMappingPtr

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Ваш обработчик должен возвратиться noErr если это может обработать нейтрализацию, или kTECUnmappableElementErr если это не может. Это может возвратить другие ошибки для исключительных условий, такой как тогда, когда буфер вывода является слишком небольшим. Если возвращается Ваш обработчик kTECUnmappableElementErr, тогда oSrcConvLen и oDestConvLen проигнорированы, потому что или обработчик по умолчанию вызовут или последовательность нейтрализации по умолчанию, будет использоваться.

    Обсуждение

    Преобразователь Unicode вызывает Ваш обработчик нейтрализации, когда это не может преобразовать текстовую строку с помощью таблицы отображения, указанной объектом преобразователя Unicode, переданным также ConvertFromUnicodeToText или ConvertFromUnicodeToPString. Управление отмечает Вас набор для controlFlags параметр функции SetFallbackUnicodeToText или SetFallbackUnicodeToTextRun предусмотрите, какой обработчик нейтрализации Преобразователь Unicode должен вызвать и какой попробовать сначала, если оба могут использоваться.

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

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

    Вы обеспечиваете функцию-обработчик нейтрализации для использования с функцией CreateUnicodeToTextInfoByEncoding, ConvertFromUnicodeToPString, ConvertFromUnicodeToTextRun, или ConvertFromUnicodeToScriptCodeRun. Вы связываете определенный с помощью приложения обработчик нейтрализации с определенным объектом преобразователя Unicode, который Вы намереваетесь передать функции преобразования при вызове его.

    Текст, преобразованный из UTF-8, будет уже преобразован в UTF-16, прежде чем обработчик нейтрализации вызовут для обработки его. Ваш обработчик нейтрализации должен сделать всю свою обработку на тексте, закодированном в UTF-16.

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

    Для соединения функции-обработчика нейтрализации с преобразователем Unicode возражают, что Вы используете SetFallbackUnicodeToText и SetFallbackUnicodeToTextRun функции. Для этих функций необходимо передать универсальный указатель процедуры (UniversalProcPtr). Это получено от указателя до Вашей функции при помощи предопределенного макроса NewUnicodeToTextFallbackProc.

    Для версий Преобразователя Unicode до 1,2, обработчик нейтрализации может получить многократный символьный текстовый элемент, таким образом, значение длины исходной строки могло быть больше, чем 2, и обработчик нейтрализации может установить srcConvLen к значению, больше, чем 2. В версиях ранее, чем 1.2.1, srcConvLen и destConvLen переменные не инициализируются к 0; оба значения проигнорированы, если не возвращается обработчик нейтрализации noErr.

    Следующий пример показывает, как установить определенный с помощью приложения обработчик нейтрализации. Можно назвать определенный с помощью приложения обработчик нейтрализации чем-либо, что Вы выбираете. Имя, MyUnicodeToTextFallbackProc, используемый в этом примере не является значительным. Однако необходимо придерживаться параметров, типа возврата и соглашения о вызовах, как выражено в этом примере, следующем за прототипом, потому что указатель на эту функцию должен иметь тип UnicodeToTextFallbackProcPtr как определено в UnicodeConverter.h заголовочный файл.

    UnicodeConverter.h заголовочный файл также определяет UnicodeToTextFallbackUPP введите и NewUnicodeToTextFallbackProc макрос.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetPluginDispatchTablePtr = CFunctionPointer<(() -> UnsafeMutablePointer<TECPluginDispatchTable>)>

    Objective C

    typedef TECPluginDispatchTable * (*TECPluginGetPluginDispatchTablePtr) ( );

    Параметры

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

    Указатель на функциональную таблицу отгрузки для плагина.

    Обсуждение

    Вам нужен этот обратный вызов только для плагинов OS X. При создании плагина TEC в OS X, необходимо экспортировать названную функцию ConverterPluginGetPluginDispatchTable со следующим прототипом:

    extern TECPluginDispatchTable *ConverterPluginGetPluginDispatchTable (void)

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginNewEncodingConverterPtr = CFunctionPointer<((UnsafeMutablePointer<Unmanaged<TECObject>?>, UnsafeMutablePointer<TECConverterContextRec>, TextEncoding, TextEncoding) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginNewEncodingConverterPtr) ( TECObjectRef * newEncodingConverter, TECConverterContextRec * plugContext, TextEncoding inputEncoding, TextEncoding outputEncoding );

    Параметры

    newEncodingConverter

    Указатель на объект преобразователя. По возврату это указывает на недавно создаваемый текстовый объект преобразователя.

    plugContext

    Указатель на запись контекста преобразователя TEC.

    inputEncoding

    Текст, кодирующий спецификацию для исходного текста.

    outputEncoding

    Текст, кодирующий спецификацию для текста привязки.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginClearContextInfoPtr = CFunctionPointer<((TECObject!, UnsafeMutablePointer<TECConverterContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginClearContextInfoPtr) ( TECObjectRef encodingConverter, TECConverterContextRec * plugContext );

    Параметры

    encodingConverter

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

    plugContext

    Указатель на запись контекста преобразователя TEC.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginConvertTextEncodingPtr = CFunctionPointer<((TECObject!, UnsafeMutablePointer<TECConverterContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginConvertTextEncodingPtr) ( TECObjectRef encodingConverter, TECConverterContextRec * plugContext );

    Параметры

    encodingConverter

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

    plugContext

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

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginFlushConversionPtr = CFunctionPointer<((TECObject!, UnsafeMutablePointer<TECConverterContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginFlushConversionPtr) ( TECObjectRef encodingConverter, TECConverterContextRec * plugContext );

    Параметры

    encodingConverter

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

    plugContext

    Указатель на запись контекста преобразователя TEC.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет указатель на функцию, избавляющуюся от объекта преобразователя.

    Объявление

    Swift

    typealias TECPluginDisposeEncodingConverterPtr = CFunctionPointer<((TECObject!, UnsafeMutablePointer<TECConverterContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginDisposeEncodingConverterPtr) ( TECObjectRef newEncodingConverter, TECConverterContextRec * plugContext );

    Параметры

    newEncodingConverter

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

    plugContext

    Указатель на запись контекста преобразователя TEC.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет указатель на функцию, создающую объект сниффера и возвращающую ссылку на него.

    Объявление

    Swift

    typealias TECPluginNewEncodingSnifferPtr = CFunctionPointer<((UnsafeMutablePointer<Unmanaged<TECSnifferObject>?>, UnsafeMutablePointer<TECSnifferContextRec>, TextEncoding) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginNewEncodingSnifferPtr) ( TECSnifferObjectRef * encodingSniffer, TECSnifferContextRec * snifContext, TextEncoding inputEncoding );

    Параметры

    encodingSniffer

    Указатель на ссылку на объект сниффера, имеющую тип TECSnifferObjectRef. По возврату ссылка принадлежит недавно создаваемому объекту сниффера.

    snifContext

    Указатель на запись контекста сниффера TEC.

    inputEncoding

    Текст, кодирующий спецификацию, которая будет обнаружена объектом сниффера.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginClearSnifferContextInfoPtr = CFunctionPointer<((TECSnifferObject!, UnsafeMutablePointer<TECSnifferContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginClearSnifferContextInfoPtr) ( TECSnifferObjectRef encodingSniffer, TECSnifferContextRec * snifContext );

    Параметры

    encodingSniffer

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

    snifContext

    Указатель на запись контекста сниффера TEC.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginSniffTextEncodingPtr = CFunctionPointer<((TECSnifferObject!, UnsafeMutablePointer<TECSnifferContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginSniffTextEncodingPtr) ( TECSnifferObjectRef encodingSniffer, TECSnifferContextRec * snifContext );

    Параметры

    encodingSniffer

    Ссылка на объект сниффера.

    snifContext

    Указатель на запись контекста сниффера TEC.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет указатель на функцию, избавляющуюся от объекта сниффера.

    Объявление

    Swift

    typealias TECPluginDisposeEncodingSnifferPtr = CFunctionPointer<((TECSnifferObject!, UnsafeMutablePointer<TECSnifferContextRec>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginDisposeEncodingSnifferPtr) ( TECSnifferObjectRef encodingSniffer, TECSnifferContextRec * snifContext );

    Параметры

    encodingSniffer

    Ссылка на сниффера возражает, что Вы хотите расположить.

    snifContext

    Указатель на запись контекста сниффера TEC.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetCountAvailableTextEncodingsPtr = CFunctionPointer<((UnsafeMutablePointer<TextEncoding>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountAvailableTextEncodingsPtr) ( TextEncoding * availableEncodings, ItemCount maxAvailableEncodings, ItemCount * actualAvailableEncodings );

    Параметры

    availableEncodings

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

    maxAvailableEncodings

    Число текста, кодирующего спецификации availableEncodings массив может содержать.

    actualAvailableEncodings

    По возврату, числу текста, кодирующего спецификации availableEncodings массив фактически содержит.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetCountAvailableTextEncodingPairsPtr = CFunctionPointer<((UnsafeMutablePointer<TECConversionInfo>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountAvailableTextEncodingPairsPtr) ( TECConversionInfo * availableEncodings, ItemCount maxAvailableEncodings, ItemCount * actualAvailableEncodings );

    Параметры

    availableEncodings

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

    maxAvailableEncodings

    Число текста, кодирующего информационные структуры availableEncodings массив может содержать.

    actualAvailableEncodings

    По возврату, числу текста, кодирующего информационные структуры availableEncodings массив фактически содержит.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetCountDestinationTextEncodingsPtr = CFunctionPointer<((TextEncoding, UnsafeMutablePointer<TextEncoding>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountDestinationTextEncodingsPtr) ( TextEncoding inputEncoding, TextEncoding * destinationEncodings, ItemCount maxDestinationEncodings, ItemCount * actualDestinationEncodings );

    Параметры

    inputEncoding

    Текст, кодирующий спецификацию, описывающую исходный текст.

    destinationEncodings

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

    maxDestinationEncodings

    Максимальное количество текстовых кодировок, которые могут быть указаны destinationEncodings параметр.

    actualDestinationEncodings

    По возврату, фактическому числу текстовых кодировок, указанных destinationEncodings параметр.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetCountSubTextEncodingsPtr = CFunctionPointer<((TextEncoding, UnsafeMutablePointer<TextEncoding>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountSubTextEncodingsPtr) ( TextEncoding inputEncoding, TextEncoding subEncodings[], ItemCount maxSubEncodings, ItemCount * actualSubEncodings );

    Параметры

    inputEncoding

    Текст, кодирующий спецификацию.

    subEncodings

    По возврату массив содержит спецификации для подкодировок inputEncoding параметр.

    maxSubEncodings

    Число текста, кодирующего спецификации subEncodings массив может содержать.

    actualSubEncodings

    По возврату, указателю на число подкодировок в subEncodings массив.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetCountAvailableSniffersPtr = CFunctionPointer<((UnsafeMutablePointer<TextEncoding>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountAvailableSniffersPtr) ( TextEncoding * availableEncodings, ItemCount maxAvailableEncodings, ItemCount * actualAvailableEncodings );

    Параметры

    availableEncodings

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

    maxAvailableEncodings

    Число текста, кодирующего спецификации availableEncodings массив может содержать.

    actualAvailableEncodings

    По возврату, числу текста, кодирующего спецификации availableEncodings массив фактически содержит.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет указатель на функцию, получающую доступные веб-текстовые кодировки.

    Объявление

    Swift

    typealias TECPluginGetCountWebEncodingsPtr = CFunctionPointer<((UnsafeMutablePointer<TextEncoding>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountWebEncodingsPtr) ( TextEncoding * availableEncodings, ItemCount maxAvailableEncodings, ItemCount * actualAvailableEncodings );

    Параметры

    availableEncodings

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

    maxAvailableEncodings

    Число текстовых спецификаций кодировок это availableEncodings может указать.

    actualAvailableEncodings

    По возврату, числу текстовых спецификаций кодировок availableEncodings фактически содержит.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetCountMailEncodingsPtr = CFunctionPointer<((UnsafeMutablePointer<TextEncoding>, ItemCount, UnsafeMutablePointer<ItemCount>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetCountMailEncodingsPtr) ( TextEncoding * availableEncodings, ItemCount maxAvailableEncodings, ItemCount * actualAvailableEncodings );

    Параметры

    availableEncodings

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

    maxAvailableEncodings

    Максимальное количество текстовых кодировок, которые могут быть указаны availableEncodings параметр.

    actualAvailableEncodings

    По возврату, числу текста, кодирующего спецификации availableEncodings фактически содержит.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetTextEncodingInternetNamePtr = CFunctionPointer<((TextEncoding, UnsafeMutablePointer<UInt8>) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetTextEncodingInternetNamePtr) ( TextEncoding textEncoding, Str255 encodingName );

    Параметры

    textEncoding

    Текст, кодирующий спецификацию.

    encodingName

    По возврату, интернет-имени кодирования, в 7-разрядных США ASCII. Если существует несколько интернет-имен кодирования для того же текстового кодирования, encodingName параметр содержит предпочтительное имя.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias TECPluginGetTextEncodingFromInternetNamePtr = CFunctionPointer<((UnsafeMutablePointer<TextEncoding>, ConstStr255Param) -> OSStatus)>

    Objective C

    typedef OSStatus (*TECPluginGetTextEncodingFromInternetNamePtr) ( TextEncoding * textEncoding, ConstStr255Param encodingName );

    Параметры

    textEncoding

    По возврату, указателю на структуру, содержащую текст, кодирующий спецификацию для текста, кодирующего имя, указанное encodingName параметр.

    encodingName

    Интернет-имя кодирования, в 7-разрядных США ASCII.

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

    Код результата. Посмотрите менеджера по TEC Ресалта Коудса.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

Типы данных

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

    Объявление

    Swift

    typealias ConstScriptCodeRunPtr = UnsafePointer<ScriptCodeRun>

    Objective C

    typedef const ScriptCodeRun * ConstScriptCodeRunPtr;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias ConstTextEncodingRunPtr = UnsafePointer<TextEncodingRun>

    Objective C

    typedef const TextEncodingRun * ConstTextEncodingRunPtr;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias ConstTextPtr = UnsafePointer<UInt8>

    Objective C

    typedef const UInt8 * ConstTextPtr;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет постоянный текст к объекту преобразователя Unicode.

    Объявление

    Swift

    typealias ConstTextToUnicodeInfo = TextToUnicodeInfo

    Objective C

    typedef TextToUnicodeInfo ConstTextToUnicodeInfo;

    Обсуждение

    TruncateForTextToUnicode функция требует объекта преобразователя Unicode в качестве параметра. Эта функция не изменяет содержание частной структуры, к которой относится объект преобразователя Unicode, таким образом, это использует постоянный объект преобразователя Unicode, определенный ConstTextToUnicodeInfo тип данных.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias ConstUniCharArrayPtr = UnsafePointer<UniChar>

    Objective C

    typedef const UniChar * ConstUniCharArrayPtr;

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет постоянный указатель отображения Unicode.

    Объявление

    Swift

    typealias ConstUnicodeMappingPtr = UnsafePointer<UnicodeMapping>

    Objective C

    typedef const UnicodeMapping * ConstUnicodeMappingPtr;

    Обсуждение

    Много функций Преобразователя Unicode берут указатель на структуру отображения Unicode в качестве параметра. Для функций, не изменяющих содержание отображения Unicode, Преобразователь Unicode обеспечивает постоянный указатель на структуру отображения Unicode, определенную ConstUnicodeMappingPtr тип данных.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет постоянный Unicode к текстовому объекту преобразователя.

    Объявление

    Swift

    typealias ConstUnicodeToTextInfo = UnicodeToTextInfo

    Objective C

    typedef UnicodeToTextInfo ConstUnicodeToTextInfo;

    Обсуждение

    TruncateForUnicodeToText функция требует объекта преобразователя Unicode в качестве параметра. Эта функция не изменяет содержание частной структуры, к которой относится объект преобразователя Unicode, таким образом, это использует постоянный объект преобразователя Unicode, определенный ConstUnicodeToTextInfo тип данных.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Содержит информацию о коде сценария для выполненного текста.

    Объявление

    Swift

    struct ScriptCodeRun { var offset: ByteOffset var script: ScriptCode }

    Objective C

    struct ScriptCodeRun { ByteOffset offset; ScriptCode script; }; typedef struct ScriptCodeRun ScriptCodeRun; typedef ScriptCodeRun * ScriptCodeRunPtr;

    Поля

    offset

    Позиция начального символа текста работает и его код сценария в преобразованном тексте.

    script

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

    Обсуждение

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

    Код сценария выполняет использование структуры расширенный код сценария со значениями в диапазоне 0–254, которые являются текстом, кодирующим основные эквиваленты кодировкам Mac OS. Значения 0–32 соответствуют непосредственно традиционным кодам сценария. Это позволяет код сценария, выполненный для различения исландского, турецкого, Символа, Zapf Dingbats, и т.д.

    Доступность

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

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

    Объявление

    Swift

    struct TECBufferContextRec { var textInputBuffer: ConstTextPtr var textInputBufferEnd: ConstTextPtr var textOutputBuffer: TextPtr var textOutputBufferEnd: TextPtr var encodingInputBuffer: ConstTextEncodingRunPtr var encodingInputBufferEnd: ConstTextEncodingRunPtr var encodingOutputBuffer: TextEncodingRunPtr var encodingOutputBufferEnd: TextEncodingRunPtr }

    Objective C

    struct TECBufferContextRec { TextPtr textInputBuffer; TextPtr textInputBufferEnd; TextPtr textOutputBuffer; TextPtr textOutputBufferEnd; TextEncodingRunPtr encodingInputBuffer; TextEncodingRunPtr encodingInputBufferEnd; TextEncodingRunPtr encodingOutputBuffer; TextEncodingRunPtr encodingOutputBufferEnd; }; typedef struct TECBufferContextRec TECBufferContextRec;

    Обсуждение

    Эта структура используется в TECConverterContextRec структура данных, использующаяся для плагина TEC.

    Доступность

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

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

    Объявление

    Swift

    struct TECConversionInfo { var sourceEncoding: TextEncoding var destinationEncoding: TextEncoding var reserved1: UInt16 var reserved2: UInt16 }

    Objective C

    struct TECConversionInfo { TextEncoding sourceEncoding; TextEncoding destinationEncoding; UInt16 reserved1; UInt16 reserved2; }; typedef struct TECConversionInfo TECConversionInfo;

    Поля

    sourceEncoding

    Текст, кодирующий спецификацию для исходного текста.

    destinationEncoding

    Текст, кодирующий спецификацию для текста привязки.

    reserved1

    Зарезервированный.

    reserved2

    Зарезервированный.

    Обсуждение

    Когда Вы вызываете функцию TECGetDirectTextEncodingConversions, Вы передаете массив текста, кодирующего информационные структуры преобразования. Функция заполняет эти структуры информацией о каждом типе поддерживаемого преобразования.

    Доступность

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

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

    Объявление

    Swift

    struct TECConverterContextRec { var pluginRec: Ptr var sourceEncoding: TextEncoding var destEncoding: TextEncoding var reserved1: UInt32 var reserved2: UInt32 var bufferContext: TECBufferContextRec var contextRefCon: URefCon var conversionProc: ProcPtr var flushProc: ProcPtr var clearContextInfoProc: ProcPtr var options1: UInt32 var options2: UInt32 var pluginState: TECPluginStateRec }

    Objective C

    struct TECConverterContextRec { Ptr pluginRec; TextEncoding sourceEncoding; TextEncoding destEncoding; UInt32 reserved1; UInt32 reserved2; TECBufferContextRec bufferContext; UInt32 contextRefCon; ProcPtr conversionProc; ProcPtr flushProc; ProcPtr clearContextInfoProc; UInt32 options1; UInt32 options2; TECPluginStateRec pluginState; }; typedef struct TECConverterContextRec TECConverterContextRec;

    Поля

    pluginRec
    sourceEncoding

    Текст, кодирующий спецификацию для исходного текста.

    destEncoding

    Текст, кодирующий спецификацию для текста привязки.

    reserved1

    Зарезервированный.

    reserved2

    Зарезервированный.

    bufferContext
    contextRefCon

    32-разрядное значение, содержащее или относящееся к определенным для плагина данным.

    conversionProc

    Указатель на обратный вызов для Вашей процедуры преобразования.

    flushProc

    Указатель на обратный вызов для Вашей процедуры сброса.

    clearContextInfoProc

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

    options1

    32-разрядное значение, что specfies опции необходимы Вашему плагину.

    options2

    32-разрядное значение, что specfies опции необходимы Вашему плагину.

    pluginState

    Доступность

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

  • Содержит информацию о Преобразователе Unicode, текст, Кодирующий Преобразователь и Основные Типы текстов.

    Объявление

    Swift

    struct TECInfo { var format: UInt16 var tecVersion: UInt16 var tecTextConverterFeatures: UInt32 var tecUnicodeConverterFeatures: UInt32 var tecTextCommonFeatures: UInt32 var tecTextEncodingsFolderName: Str31 var tecExtensionFileName: Str31 var tecLowestTEFileVersion: UInt16 var tecHighestTEFileVersion: UInt16 }

    Objective C

    struct TECInfo { UInt16 format; UInt16 tecVersion; UInt32 tecTextConverterFeatures; UInt32 tecUnicodeConverterFeatures; UInt32 tecTextCommonFeatures; Str31 tecTextEncodingsFolderName; Str31 tecExtensionFileName; UInt16 tecLowestTEFileVersion; UInt16 tecHighestTEFileVersion; }; typedef struct TECInfo TECInfo; typedef TECInfo * TECInfoPtr;

    Поля

    format

    Текущий формат возвращенной структуры. Формат структуры обозначен kTECInfoCurrentFormat постоянный. Любые будущие изменения в формате всегда будут backwardly совместимый; любые новые поля будут добавлены до конца структуры.

    tecVersion

    Текущая версия текста, Кодирующего менеджера по Преобразованию расширение в BCD (двоично-десятичное число), с первым байтом, указывающим основную версию; например, 0x0121 для 1.2.1.

    tecTextConverterFeatures

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

    tecUnicodeConverterFeatures

    Битовые флаги, указывающие новые функции или исправления ошибок в Преобразователе Unicode. Посмотрите Флаги Преобразователя Unicode для в настоящее время определяемых битовых флагов.

    tecTextCommonFeatures

    Битовые флаги, указывающие новые функции или исправления ошибок в Основных Типах текстов (текст Общая статическая библиотека). Никакие биты в настоящее время не определяются.

    tecTextEncodingsFolderName

    Строка Паскаля с (возможно локализованный) имя текстовой папки Encodings.

    tecExtensionFileName

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

    tecLowestTEFileVersion
    tecHighestTEFileVersion

    Обсуждение

    Информационная структура преобразователя используется функцией TECGetInfo содержать возвращенную информацию о Преобразователе Unicode, текст, Кодирующий Преобразователь и Основные Типы текстов.

    Доступность

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

  • Определяет непрозрачную ссылку на объект преобразователя.

    Объявление

    Swift

    typealias TECObjectRef = TECObject

    Objective C

    typedef struct OpaqueTECObjectRef * TECObjectRef;

    Обсуждение

    При создании текстового преобразования текст, Кодирующий Преобразователь, требует ссылки на объект преобразователя, указывающий, как выполнить преобразование. Функции, такой как TECCreateConverter, это создает возврат объекта преобразователя эта ссылка, которую можно тогда передать другим функциям при преобразовании текста. Ссылка на объект преобразователя определяется TECObjectRef тип данных.

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    struct TECPluginDispatchTable { var version: TECPluginVersion var compatibleVersion: TECPluginVersion var PluginID: TECPluginSignature var PluginNewEncodingConverter: TECPluginNewEncodingConverterPtr var PluginClearContextInfo: TECPluginClearContextInfoPtr var PluginConvertTextEncoding: TECPluginConvertTextEncodingPtr var PluginFlushConversion: TECPluginFlushConversionPtr var PluginDisposeEncodingConverter: TECPluginDisposeEncodingConverterPtr var PluginNewEncodingSniffer: TECPluginNewEncodingSnifferPtr var PluginClearSnifferContextInfo: TECPluginClearSnifferContextInfoPtr var PluginSniffTextEncoding: TECPluginSniffTextEncodingPtr var PluginDisposeEncodingSniffer: TECPluginDisposeEncodingSnifferPtr var PluginGetCountAvailableTextEncodings: TECPluginGetCountAvailableTextEncodingsPtr var PluginGetCountAvailableTextEncodingPairs: TECPluginGetCountAvailableTextEncodingPairsPtr var PluginGetCountDestinationTextEncodings: TECPluginGetCountDestinationTextEncodingsPtr var PluginGetCountSubTextEncodings: TECPluginGetCountSubTextEncodingsPtr var PluginGetCountAvailableSniffers: TECPluginGetCountAvailableSniffersPtr var PluginGetCountWebTextEncodings: TECPluginGetCountWebEncodingsPtr var PluginGetCountMailTextEncodings: TECPluginGetCountMailEncodingsPtr var PluginGetTextEncodingInternetName: TECPluginGetTextEncodingInternetNamePtr var PluginGetTextEncodingFromInternetName: TECPluginGetTextEncodingFromInternetNamePtr }

    Objective C

    struct TECPluginDispatchTable { TECPluginVersion version; TECPluginVersion compatibleVersion; TECPluginSignature PluginID; TECPluginNewEncodingConverterPtr PluginNewEncodingConverter; TECPluginClearContextInfoPtr PluginClearContextInfo; TECPluginConvertTextEncodingPtr PluginConvertTextEncoding; TECPluginFlushConversionPtr PluginFlushConversion; TECPluginDisposeEncodingConverterPtr PluginDisposeEncodingConverter; TECPluginNewEncodingSnifferPtr PluginNewEncodingSniffer; TECPluginClearSnifferContextInfoPtr PluginClearSnifferContextInfo; TECPluginSniffTextEncodingPtr PluginSniffTextEncoding; TECPluginDisposeEncodingSnifferPtr PluginDisposeEncodingSniffer; TECPluginGetCountAvailableTextEncodingsPtr PluginGetCountAvailableTextEncodings; TECPluginGetCountAvailableTextEncodingPairsPtr PluginGetCountAvailableTextEncodingPairs; TECPluginGetCountDestinationTextEncodingsPtr PluginGetCountDestinationTextEncodings; TECPluginGetCountSubTextEncodingsPtr PluginGetCountSubTextEncodings; TECPluginGetCountAvailableSniffersPtr PluginGetCountAvailableSniffers; TECPluginGetCountWebEncodingsPtr PluginGetCountWebTextEncodings; TECPluginGetCountMailEncodingsPtr PluginGetCountMailTextEncodings; TECPluginGetTextEncodingInternetNamePtr PluginGetTextEncodingInternetName; TECPluginGetTextEncodingFromInternetNamePtr PluginGetTextEncodingFromInternetName; }; typedef struct TECPluginDispatchTable TECPluginDispatchTable;

    Доступность

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

  • Определяет тип данных для текста, Кодирующего подпись плагина Преобразователя.

    Объявление

    Swift

    typealias TECPluginSig = OSType

    Objective C

    typedef OSType TECPluginSig;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет тип данных для текста, Кодирующего подпись плагина Преобразователя.

    Объявление

    Swift

    typealias TECPluginSignature = OSType

    Objective C

    typedef OSType TECPluginSignature;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    struct TECPluginStateRec { var state1: UInt8 var state2: UInt8 var state3: UInt8 var state4: UInt8 var longState1: UInt32 var longState2: UInt32 var longState3: UInt32 var longState4: UInt32 }

    Objective C

    struct TECPluginStateRec { UInt8 state1; UInt8 state2; UInt8 state3; UInt8 state4; UInt32 longState1; UInt32 longState2; UInt32 longState3; UInt32 longState4; }; typedef struct TECPluginStateRec TECPluginStateRec;

    Доступность

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

  • Определяет тип данных для текста, Кодирующего версию плагина Преобразователя.

    Объявление

    Swift

    typealias TECPluginVersion = UInt32

    Objective C

    typedef UInt32 TECPluginVersion;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Содержит infomation, используемый объектом сниффера.

    Объявление

    Swift

    struct TECSnifferContextRec { var pluginRec: Ptr var encoding: TextEncoding var maxErrors: ItemCount var maxFeatures: ItemCount var textInputBuffer: ConstTextPtr var textInputBufferEnd: ConstTextPtr var numFeatures: ItemCount var numErrors: ItemCount var contextRefCon: URefCon var sniffProc: ProcPtr var clearContextInfoProc: ProcPtr var pluginState: TECPluginStateRec }

    Objective C

    struct TECSnifferContextRec { Ptr pluginRec; TextEncoding encoding; ItemCount maxErrors; ItemCount maxFeatures; TextPtr textInputBuffer; TextPtr textInputBufferEnd; ItemCount numFeatures; ItemCount numErrors; UInt32 contextRefCon; ProcPtr sniffProc; ProcPtr clearContextInfoProc; TECPluginStateRec pluginState; }; typedef struct TECSnifferContextRec TECSnifferContextRec;

    Доступность

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

  • Определяет ссылку на непрозрачный объект сниффера.

    Объявление

    Swift

    typealias TECSnifferObjectRef = TECSnifferObject

    Objective C

    typedef struct OpaqueTECSnifferObjectRef * TECSnifferObjectRef;

    Обсуждение

    При анализе текста для возможных кодировок текст, Кодирующий Преобразователь, требует ссылки на объект сниффера, указывающий, какие типы кодировок могут быть обнаружены. Вы получаете эту ссылку при вызывании функции TECCreateSniffer. Ссылка на объект сниффера определяется TECSnifferObjectRef тип данных. Структура OpaqueTECObjectRef тип данных является частным, и объект сниффера не доступен непосредственно.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет тип данных для текста, кодирующего значение.

    Объявление

    Swift

    typealias TextEncoding = UInt32

    Objective C

    typedef UInt32 TextEncoding;

    Обсуждение

    A TextEncoding значение указано текстом, кодирующим основу, текст, кодирующий вариант и формат кодировки текста. Можно получить a TextEncoding значение путем вызывания функции CreateTextEncoding. Когда Вы вызываете эту функцию, можно обеспечить TextEncodingBase, TextEncodingVariant, и TextEncodingFormat типы данных.

    A TextEncoding значение используется, например, идентифицировать кодирование текста передало текстовому преобразователю. Два TextEncoding значения необходимы — для источника и места назначения, кодирующего — при вызове текста, Кодирующего Преобразователь или Преобразователь Unicode для преобразования текста.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    struct TextEncodingRun { var offset: ByteOffset var textEncoding: TextEncoding }

    Objective C

    struct TextEncodingRun { ByteOffset offset; TextEncoding textEncoding; }; typedef struct TextEncodingRun TextEncodingRun; typedef TextEncodingRun * TextEncodingRunPtr;

    Поля

    offset

    Позиция начального символа выполнения текста в строке преобразованного текста.

    textEncoding

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

    Обсуждение

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

    Если kUnicodeTextRunMask флаг установлен, ConvertFromUnicodeToTextRun и ConvertFromUnicodeToScriptCodeRun может преобразовать текст Unicode в строку текста, содержащего многократный текст, кодирующий выполнения. Каждое выполнение содержит текст, выраженный в различном кодировании от того из предыдущих или после сегмента текста. Для каждого текстового кодирования, выполненного в строке, a TextEncodingRun структура указывает смещение начала и текстовое кодирование для того выполнения.

    Функции, преобразовывающие текст от Unicode до текста выполненный возврат преобразованный текст в массиве текста, кодирующего выполненные структуры. Текст, кодирующий выполненную структуру, определяется TextEncodingRun тип данных.

    Доступность

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

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

    Объявление

    Swift

    typealias TextEncodingVariant = UInt32

    Objective C

    typedef UInt32 TextEncodingVariant;

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет ссылку на непрозрачный объект преобразователя Unicode.

    Объявление

    Swift

    typealias TextToUnicodeInfo = COpaquePointer

    Objective C

    typedef struct OpaqueTextToUnicodeInfo * TextToUnicodeInfo;

    Обсуждение

    Объект преобразователя Unicode является частным объектом, содержащим отображение и информацию состояния. Многие функции Преобразователя Unicode, выполняющие преобразования, требуют объекта преобразователя Unicode, содержащего информацию, используемую для процесса преобразования. Существует три типа объектов преобразователя Unicode, все служащие той же цели, но используются для различных типов преобразований. Вы используете TextToUnicodeInfo введите, описанный здесь, для преобразования от текста не-Unicode до текста Unicode.

    Поскольку Ваше приложение не может непосредственно создать или изменить содержание частного объекта преобразователя Unicode, Преобразователь Unicode обеспечивает функции, чтобы создать и избавиться от него. Для создания объекта преобразователя Unicode для преобразования от текста не-Unicode до текста Unicode приложение должно сначала вызвать любого функция CreateTextToUnicodeInfo или функция CreateTextToUnicodeInfoByEncoding обеспечить отображающуюся требуемую информацию для преобразования. Можно тогда передать этот объект функции ConvertFromTextToUnicode или ConvertFromPStringToUnicode идентифицировать информацию, которая будет использоваться в выполнении фактического преобразования. После того, как Вы закончили использовать объект, необходимо выпустить память, выделенную для него путем вызывания функции DisposeTextToUnicodeInfo. TextToUnicodeInfo тип данных определяет объект преобразователя Unicode.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Представляет границу между двумя символами.

    Объявление

    Swift

    typealias UniCharArrayOffset = UInt

    Objective C

    typedef UInt32 UniCharArrayOffset;

    Обсуждение

    A UniCharArrayOffset представляет границу между двумя символами. Например, первый символ в буфере находится между смещениями 0 и 1. Таким образом, первый символ в буфере может упоминаться или как “смещение 0, ведя” или как “смещение 1, запаздывая”. Когда Вы имеете дело с позициями курсора, это различие полезно.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Содержит информацию для отображения на или от кодирования Unicode.

    Объявление

    Swift

    struct UnicodeMapping { var unicodeEncoding: TextEncoding var otherEncoding: TextEncoding var mappingVersion: UnicodeMapVersion }

    Objective C

    struct UnicodeMapping { TextEncoding unicodeEncoding; TextEncoding otherEncoding; UnicodeMapVersion mappingVersion; }; typedef struct UnicodeMapping UnicodeMapping; typedef UnicodeMapping * UnicodeMappingPtr;

    Поля

    unicodeEncoding

    Текст Unicode, кодирующий спецификацию типа TextEncoding.

    otherEncoding

    Текст, кодирующий спецификацию для текста, который будет преобразован в или от Unicode.

    mappingVersion

    Версия таблицы отображения Unicode, которая будет использоваться.

    Обсуждение

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

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

    Указать нормальное каноническое разложение согласно правилам Unicode 3.2, без исключений («Каноническое разложение 3.2»), установленный UnicodeMapping структура следующим образом:

    • mapping.unicodeEncoding (in) = Unicode 2.x-3.x, kUnicodeNoSubset, kUnicode16BitFormat
    • mapping.otherEncoding (out) = Unicode 2.x-3.x, kUnicodeCanonicalDecompVariant, kUnicode16BitFormat
    • mapping.mappingVersion = kUnicodeUseLatestMapping

    Примеры:

    • u00E0 -> u0061 + u0300
    • u0061 + u0300 -> u0061 + u0300
    • u03AC -> u03B1 + u0301 (3.2 rules)
    • uF900 -> u8C48
    • u00E0 + u0323 -> u0061 + u0323 + u0300 (correct)

    Указать каноническое разложение согласно правилам Unicode 3.2, с HFS + исключения («HFS + разложение 3.2»), установленный UnicodeMapping структура одним из следующих способов. Второй метод для совместимости со старым методом использования mappingVersion = kUnicodeUseHFSPlusMapping.

    • // Method 1
    • mapping.unicodeEncoding (in) = Unicode 2.x-3.x, kUnicodeNoSubset, kUnicode16BitFormat
    • mapping.otherEncoding (out) = Unicode 2.x-3.x, kUnicodeHFSPlusDecompVariant, kUnicode16BitFormat
    • mapping.mappingVersion = kUnicodeUseLatestMapping
    • // Method 2
    • mapping.unicodeEncoding (in) = Unicode 2.x-3.x, kUnicode16BitFormat, kUnicode16BitFormat
    • mapping.otherEncoding (out) = Unicode 2.x, kUnicodeCanonicalDecompVariant, kUnicode16BitFormat
    • mapping.mappingVersion = kUnicodeUseHFSPlusMapping

    Примеры:

    • u00E0 -> u0061 + u0300
    • u0061 + u0300 -> u0061 + u0300
    • u03AC -> u03B1 + u0301 (3.2 rules)
    • uF900 -> uF900 (decomposition excluded for HFS+)
    • u00E0 + u0323 -> u0061 + u0323 + u0300 (correct)

    Для указания нормального канонического состава согласно правилам Unicode 3.2 установите UnicodeMapping структура следующим образом:

    • mapping.unicodeEncoding (in) = Unicode 2.x-3.x, kUnicodeNoSubset, kUnicode16BitFormat
    • mapping.otherEncoding (out) = Unicode 2.x-3.x, kUnicodeCanonicalCompVariant, kUnicode16BitFormat
    • mapping.mappingVersion = kUnicodeUseLatestMapping

    Примеры:

    • u00E0 -> u00E0
    • u0061 + u0300 -> u00E0
    • u03AC -> u03AC
    • uF900 -> u8C48
    • u00E0 + u0323 -> u1EA1 u0300 (correct)

    Указать канонический состав согласно правилам Unicode 3.2, но использование HFS + исключения разложения, установленные UnicodeMapping структура следующим образом. Это - форма, чтобы использовать, если Вы хотите получить составленную форму, которую dervide от анализируемой формы использовал для HFS + имена файлов.

    • mapping.unicodeEncoding (in) = Unicode 2.x-3.x, kUnicodeNoSubset, kUnicode16BitFormat
    • mapping.otherEncoding (out) = Unicode 2.x-3.x, kUnicodeHFSPlusCompVariant, kUnicode16BitFormat
    • mapping.mappingVersion = kUnicodeUseLatestMapping

    Примеры:

    • u00E0 -> u00E0
    • u0061 + u0300 -> u00E0
    • u03AC -> u03AC
    • uF900 -> uF900
    • u00E0 + u0323 -> u1EA1 u0300 (correct)

    Доступность

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

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

    Объявление

    Swift

    typealias UnicodeToTextFallbackUPP = UnicodeToTextFallbackProcPtr

    Objective C

    typedef UnicodeToTextFallbackProcPtr UnicodeToTextFallbackUPP;

    Обсуждение

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

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

  • Определяет ссылку на непрозрачный Unicode к текстовому объекту преобразователя.

    Объявление

    Swift

    typealias UnicodeToTextInfo = COpaquePointer

    Objective C

    typedef struct OpaqueUnicodeToTextInfo * UnicodeToTextInfo;

    Обсуждение

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

    Поскольку Ваше приложение не может непосредственно создать или изменить содержание частного объекта преобразователя Unicode, Преобразователь Unicode обеспечивает функции, чтобы создать и избавиться от него. Для создания объекта преобразователя Unicode для преобразования от Unicode до текста приложение должно сначала вызвать любого функция CreateUnicodeToTextInfo или CreateUnicodeToTextInfoByEncoding.

    Можно тогда передать этот объект функции ConvertFromUnicodeToText или ConvertFromUnicodeToPString идентифицировать информацию раньше выполняло фактическое преобразование. После того, как Вы закончили использовать объект, необходимо выпустить память, выделенную для него путем вызывания функции DisposeUnicodeToTextInfo.

    Объект преобразователя Unicode с этой целью определяется UnicodeToTextInfo тип данных.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Swift

    typealias UnicodeToTextRunInfo = COpaquePointer

    Objective C

    typedef struct OpaqueUnicodeToTextRunInfo * UnicodeToTextRunInfo;

    Обсуждение

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

    Поскольку Ваше приложение не может непосредственно создать или изменить содержание частного объекта преобразователя Unicode, Преобразователь Unicode обеспечивает функции, чтобы создать и избавиться от него. Можно использовать любую из трех функций для создания объекта преобразователя Unicode для преобразования от Unicode до многократных кодировок. Можно использовать CreateUnicodeToTextRunInfo, CreateUnicodeToTextRunInfoByEncoding, или CreateUnicodeToTextRunInfoByScriptCode.

    Можно тогда передать этот объект функции ConvertFromUnicodeToTextRun или ConvertFromUnicodeToScriptCodeRun идентифицировать информацию раньше выполняло фактическое преобразование. После того, как Вы закончили использовать объект, необходимо выпустить память, выделенную для него путем вызывания функции DisposeUnicodeToTextRunInfo.

    Объект преобразователя Unicode с этой целью определяется UnicodeToTextRunInfo тип данных.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

Константы

Селекторы функции

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

    Объявление

    Swift

    var kUnicodeUseFallbacksBit: Int { get } var kUnicodeKeepInfoBit: Int { get } var kUnicodeDirectionalityBits: Int { get } var kUnicodeVerticalFormBit: Int { get } var kUnicodeLooseMappingsBit: Int { get } var kUnicodeStringUnterminatedBit: Int { get } var kUnicodeTextRunBit: Int { get } var kUnicodeKeepSameEncodingBit: Int { get } var kUnicodeForceASCIIRangeBit: Int { get } var kUnicodeNoHalfwidthCharsBit: Int { get } var kUnicodeTextRunHeuristicsBit: Int { get } var kUnicodeMapLineFeedToReturnBit: Int { get }

    Objective C

    enum { kUnicodeUseFallbacksBit = 0, kUnicodeKeepInfoBit = 1, kUnicodeDirectionalityBits = 2, kUnicodeVerticalFormBit = 4, kUnicodeLooseMappingsBit = 5, kUnicodeStringUnterminatedBit = 6, kUnicodeTextRunBit = 7, kUnicodeKeepSameEncodingBit = 8, kUnicodeForceASCIIRangeBit = 9, kUnicodeNoHalfwidthCharsBit = 10, kUnicodeTextRunHeuristicsBit = 11, kUnicodeMapLineFeedToReturnBit = 12 };

    Константы

    • kUnicodeUseFallbacksBit

      kUnicodeUseFallbacksBit

      Включает использование отображений нейтрализации.

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

    • kUnicodeKeepInfoBit

      kUnicodeKeepInfoBit

      Устанавливает флаг управления сохранять-информации.

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

    • kUnicodeDirectionalityBits

      kUnicodeDirectionalityBits

      Направленность наборов.

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

    • kUnicodeVerticalFormBit

      kUnicodeVerticalFormBit

      Устанавливает вертикальный флаг управления формой.

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

    • kUnicodeLooseMappingsBit

      kUnicodeLooseMappingsBit

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

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

    • kUnicodeStringUnterminatedBit

      kUnicodeStringUnterminatedBit

      Устанавливает незавершенный строкой флаг управления.

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

    • kUnicodeTextRunBit

      kUnicodeTextRunBit

      Устанавливает управляемый текстом флаг управления.

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

    • kUnicodeKeepSameEncodingBit

      kUnicodeKeepSameEncodingBit

      Устанавливает флаг управления, «сохраняют то же кодирование».

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

    • kUnicodeForceASCIIRangeBit

      kUnicodeForceASCIIRangeBit

      Устанавливает силу флаг управления диапазоном ASCII.

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

    • kUnicodeNoHalfwidthCharsBit

      kUnicodeNoHalfwidthCharsBit

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

    • kUnicodeTextRunHeuristicsBit

      kUnicodeTextRunHeuristicsBit

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

    • kUnicodeMapLineFeedToReturnBit

      kUnicodeMapLineFeedToReturnBit

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

  • Набор или текст для флагов преобразования.

    Объявление

    Swift

    var kUnicodeUseFallbacksMask: Int { get } var kUnicodeKeepInfoMask: Int { get } var kUnicodeDirectionalityMask: Int { get } var kUnicodeVerticalFormMask: Int { get } var kUnicodeLooseMappingsMask: Int { get } var kUnicodeStringUnterminatedMask: Int { get } var kUnicodeTextRunMask: Int { get } var kUnicodeKeepSameEncodingMask: Int { get } var kUnicodeForceASCIIRangeMask: Int { get } var kUnicodeNoHalfwidthCharsMask: Int { get } var kUnicodeTextRunHeuristicsMask: Int { get } var kUnicodeMapLineFeedToReturnMask: Int { get }

    Objective C

    enum { kUnicodeUseFallbacksMask = 1L << kUnicodeUseFallbacksBit, kUnicodeKeepInfoMask = 1L << kUnicodeKeepInfoBit, kUnicodeDirectionalityMask = 3L << kUnicodeDirectionalityBits, kUnicodeVerticalFormMask = 1L << kUnicodeVerticalFormBit, kUnicodeLooseMappingsMask = 1L << kUnicodeLooseMappingsBit, kUnicodeStringUnterminatedMask = 1L << kUnicodeStringUnterminatedBit, kUnicodeTextRunMask = 1L << kUnicodeTextRunBit, kUnicodeKeepSameEncodingMask = 1L << kUnicodeKeepSameEncodingBit, kUnicodeForceASCIIRangeMask = 1L << kUnicodeForceASCIIRangeBit, kUnicodeNoHalfwidthCharsMask = 1L << kUnicodeNoHalfwidthCharsBit, kUnicodeTextRunHeuristicsMask = 1L << kUnicodeTextRunHeuristicsBit, kUnicodeMapLineFeedToReturnMask = 1L << kUnicodeMapLineFeedToReturnBit };

    Константы

    • kUnicodeUseFallbacksMask

      kUnicodeUseFallbacksMask

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

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

    • kUnicodeKeepInfoMask

      kUnicodeKeepInfoMask

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

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

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

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

    • kUnicodeDirectionalityMask

      kUnicodeDirectionalityMask

      Маска для установки направленности управляет флагом

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

    • kUnicodeVerticalFormMask

      kUnicodeVerticalFormMask

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

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

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

    • kUnicodeLooseMappingsMask

      kUnicodeLooseMappingsMask

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

      При очистке этого флага преобразователь будет использовать только строгую эквивалентную часть.

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

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

    • kUnicodeStringUnterminatedMask

      kUnicodeStringUnterminatedMask

      Маска для установки незавершенного строкой флага управления. Определяет, как Преобразователь Unicode обрабатывает границы текстового элемента и разрешение направления в конце входного буфера.

      При очистке этого бита преобразователь обрабатывает конец буфера как конец текста.

      При установке этого бита преобразователь предполагает, что следующий вызов, Вы делаете использование текущего контекста, предоставит другой буфер текста, который должен быть обработан как продолжение текущего текста. Например, если последний знак во входном буфере 'A', ConvertFromUnicodeToText преобразование остановок в 'A' и возвраты kTECIncompleteElementErr, потому что следующий буфер мог начаться с объединяющегося диакритического знака, который должен быть обработан как часть того же текстового элемента. Если последний знак во входном буфере является управляющим символом, ConvertFromUnicodeToText не возвращается kTECIncompleteElementErr потому что управляющий символ не мог быть частью многократного символьного текстового элемента.

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

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

    • kUnicodeTextRunMask

      kUnicodeTextRunMask

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

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

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

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

    • kUnicodeKeepSameEncodingMask

      kUnicodeKeepSameEncodingMask

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

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

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

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

    • kUnicodeForceASCIIRangeMask

      kUnicodeForceASCIIRangeMask

      Маска для установки силы ASCII располагается флаг управления. Если кодирование обычно обрабатывает 1-байтовые кодовые точки 0x000x7F как ISO 646 национальный вариант, отличающийся от ASCII, устанавливая этот флаг силы 0x000x7F быть обработанным как ASCII. Например, японские кодировки, такие как Shift-JIS обычно обрабатывают 0x000x7F как римлянин JIS, с 0x5C как YEN SIGN вместо REVERSE SOLIDUS, но при преобразовании пути к файлу DOS можно хотеть установить этот флаг так, чтобы 0x5C отображается как REVERSE SOLIDUS.

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

    • kUnicodeNoHalfwidthCharsMask

      kUnicodeNoHalfwidthCharsMask

      Не устанавливает флаг управления полуширинными символами.

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

    • kUnicodeTextRunHeuristicsMask

      kUnicodeTextRunHeuristicsMask

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

    • kUnicodeMapLineFeedToReturnMask

      kUnicodeMapLineFeedToReturnMask

      Указывает отображение o символ LF (LineFeed), используемый в Unix для представления новых строк CR (CarriageReturn) используемый в кодировках Mac. Эта опция имеет эффект только, когда используется с константой kUnicodeLooseMappingsMask. Можно передать обе константы как iControlFlags параметры к функциям ConvertFromUnicodeToText, ConvertFromUnicodeToTextRun, и ConvertFromUnicodeToScriptCodeRun.

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

    Обсуждение

    Вы используете эти константы, чтобы указать, как выполняется преобразование текста от одного кодирования до другого. Вы используете эти маски в качестве controlFlags параметр в ConvertFromTextToUnicode, ConvertFromUnicodeToText, ConvertFromUnicodeToScriptCodeRun, ConvertFromUnicodeToTextRun, и TruncateForUnicodeToText функции. Различное подмножество масок управления применяется к каждой из этих функций. Используя константы битовой маски, можно выполнить поразрядное OR работа для установки подходящих флагов для параметров определенной функции. Например, когда Вы вызываете функцию, Вы могли бы передать следующий controlFlags установка параметра:

    controlflags=kUnicodeUseFallbacksMask | kUnicodeLooseMappingsMask;

  • Укажите текстовое направление.

    Объявление

    Swift

    var kUnicodeDefaultDirection: Int { get } var kUnicodeLeftToRight: Int { get } var kUnicodeRightToLeft: Int { get }

    Objective C

    enum { kUnicodeDefaultDirection = 0, kUnicodeLeftToRight = 1, kUnicodeRightToLeft = 2 };

    Константы

    • kUnicodeDefaultDirection

      kUnicodeDefaultDirection

      Используйте направление по умолчанию.

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

    • kUnicodeLeftToRight

      kUnicodeLeftToRight

      Указывает оставленный правильному направлению.

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

    • kUnicodeRightToLeft

      kUnicodeRightToLeft

      Указывает справа налево направление.

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

  • Набор или текст для битов направленности.

    Объявление

    Swift

    var kUnicodeDefaultDirectionMask: Int { get } var kUnicodeLeftToRightMask: Int { get } var kUnicodeRightToLeftMask: Int { get }

    Objective C

    enum { kUnicodeDefaultDirectionMask = kUnicodeDefaultDirection << kUnicodeDirectionalityBits, kUnicodeLeftToRightMask = kUnicodeLeftToRight << kUnicodeDirectionalityBits, kUnicodeRightToLeftMask = kUnicodeRightToLeft << kUnicodeDirectionalityBits };

    Константы

    • kUnicodeDefaultDirectionMask

      kUnicodeDefaultDirectionMask

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

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

    • kUnicodeLeftToRightMask

      kUnicodeLeftToRightMask

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

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

    • kUnicodeRightToLeftMask

      kUnicodeRightToLeftMask

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

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

  • Укажите функции исправлений ошибок в Преобразователе Unicode.

    Объявление

    Swift

    var kTECKeepInfoFixBit: Int { get } var kTECFallbackTextLengthFixBit: Int { get } var kTECTextRunBitClearFixBit: Int { get } var kTECTextToUnicodeScanFixBit: Int { get } var kTECAddForceASCIIChangesBit: Int { get } var kTECPreferredEncodingFixBit: Int { get } var kTECAddTextRunHeuristicsBit: Int { get } var kTECAddFallbackInterruptBit: Int { get }

    Objective C

    enum { kTECKeepInfoFixBit = 0, kTECFallbackTextLengthFixBit = 1, kTECTextRunBitClearFixBit = 2, kTECTextToUnicodeScanFixBit = 3, kTECAddForceASCIIChangesBit = 4, kTECPreferredEncodingFixBit = 5, kTECAddTextRunHeuristicsBit = 6, kTECAddFallbackInterruptBit = 7 };

    Константы

    • kTECKeepInfoFixBit

      kTECKeepInfoFixBit

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

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

    • kTECFallbackTextLengthFixBit

      kTECFallbackTextLengthFixBit

      Это установлено, если Преобразователь Unicode имеет исправление ошибки для использования исходной длины (srcConvLen) и целевая длина (destConvLen) возвращенный предоставленным вызывающую сторону обработчиком нейтрализации для любого состояния это возвращается кроме kTECUnmappableElementErr. Ранее это соблюдало только эти значения если noErr был возвращен.

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

    • kTECTextRunBitClearFixBit

      kTECTextRunBitClearFixBit

      Это установлено если ConvertFromUnicodeToTextRun и ConvertFromUnicodeToScriptCodeRun функционируйте правильно если kUnicodeTextRunBit ясно.

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

    • kTECTextToUnicodeScanFixBit

      kTECTextToUnicodeScanFixBit

      Это установлено если ConvertFromTextToUnicode улучшен так, отображения могут зависеть от контекста и сохраненного состояния. Последствия этого (1) уродливые входные результаты в kTextMalformedInputErr; (2) ConvertFromTextToUnicode принимает флаги управления kUnicodeLooseMappingsMask, kUnicodeKeepInfoMask, и kUnicodeStringUnterminatedMask; (3) устранение избыточного направления переопределяет при преобразовании арабского Mac OS и иврита к Unicode; и (4) улучшенное отображение 0x30-0x39 цифр на арабском языке Mac OS, когда используются свободные отображения.

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

    • kTECAddForceASCIIChangesBit

      kTECAddForceASCIIChangesBit

      Это установлено если новые флаговые биты управления kUnicodeForceASCIIRangeBit и kUnicodeNoHalfwidthCharsBit поддерживаются для использования с функциями ConvertFromTextToUnicode, ConvertFromUnicodeToText, и т.д.

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

    • kTECPreferredEncodingFixBit

      kTECPreferredEncodingFixBit

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

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

    • kTECAddTextRunHeuristicsBit

      kTECAddTextRunHeuristicsBit

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

    • kTECAddFallbackInterruptBit

      kTECAddFallbackInterruptBit

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

    Обсуждение

    Это битовые флаги для указания новых функций исправлений ошибок в Преобразователе Unicode. Они используются TECInfo тип данных.

  • Набор или тест для флагов преобразователя Unicode.

    Объявление

    Objective C

    enum { kTECKeepInfoFixMask = 1L << kTECKeepInfoFixBit, kTECFallbackTextLengthFixMask = 1L << kTECFallbackTextLengthFixBit, kTECTextRunBitClearFixMask = 1L << kTECTextRunBitClearFixBit, kTECTextToUnicodeScanFixMask = 1L << kTECTextToUnicodeScanFixBit, kTECAddForceASCIIChangesMask = 1L << kTECAddForceASCIIChangesBit, kTECPreferredEncodingFixMask = 1L << kTECPreferredEncodingFixBit, kTECAddTextRunHeuristicsMask = 1L << kTECAddTextRunHeuristicsBit, kTECAddFallbackInterruptMask = 1L << kTECAddFallbackInterruptBit };

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

    Объявление

    Objective C

    enum { kUnicodeFallbackSequencingBits = 0 };

  • Набор или текст для флага упорядочивания Unicode.

    Объявление

    Swift

    var kUnicodeFallbackSequencingMask: Int { get } var kUnicodeFallbackInterruptSafeMask: Int { get }

    Objective C

    enum { kUnicodeFallbackSequencingMask = 3L << kUnicodeFallbackSequencingBits, kUnicodeFallbackInterruptSafeMask = 1L << 2 };

    Константы

    • kUnicodeFallbackSequencingMask

      kUnicodeFallbackSequencingMask

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

    • kUnicodeFallbackInterruptSafeMask

      kUnicodeFallbackInterruptSafeMask

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

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

  • Укажите соответствие критериев отображений Unicode.

    Объявление

    Swift

    var kUnicodeMatchUnicodeBaseBit: Int { get } var kUnicodeMatchUnicodeVariantBit: Int { get } var kUnicodeMatchUnicodeFormatBit: Int { get } var kUnicodeMatchOtherBaseBit: Int { get } var kUnicodeMatchOtherVariantBit: Int { get } var kUnicodeMatchOtherFormatBit: Int { get }

    Objective C

    enum { kUnicodeMatchUnicodeBaseBit = 0, kUnicodeMatchUnicodeVariantBit = 1, kUnicodeMatchUnicodeFormatBit = 2, kUnicodeMatchOtherBaseBit = 3, kUnicodeMatchOtherVariantBit = 4, kUnicodeMatchOtherFormatBit = 5 };

    Константы

    • kUnicodeMatchUnicodeBaseBit

      kUnicodeMatchUnicodeBaseBit

      Исключает отображения, не соответствующие текст, кодирующий основу unicodeEncoding поле структуры UnicodeMapping.

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

    • kUnicodeMatchUnicodeVariantBit

      kUnicodeMatchUnicodeVariantBit

      Исключает отображения, не соответствующие текст, кодирующий вариант unicodeEncoding поле указанной структуры отображения Unicode.

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

    • kUnicodeMatchUnicodeFormatBit

      kUnicodeMatchUnicodeFormatBit

      Исключает отображения, не соответствующие формат кодировки текста unicodeEncoding поле указанной структуры отображения Unicode.

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

    • kUnicodeMatchOtherBaseBit

      kUnicodeMatchOtherBaseBit

      Исключает отображения, не соответствующие текст, кодирующий основу otherEncoding поле структуры UnicodeMapping.

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

    • kUnicodeMatchOtherVariantBit

      kUnicodeMatchOtherVariantBit

      Исключает отображения, не соответствующие текст, кодирующий вариант otherEncoding поле указанной структуры отображения Unicode.

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

    • kUnicodeMatchOtherFormatBit

      kUnicodeMatchOtherFormatBit

      Исключает отображения, не соответствующие формат кодировки текста otherEncoding поле указанной структуры отображения Unicode.

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

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

    Объявление

    Swift

    var kUnicodeMatchUnicodeBaseMask: Int { get } var kUnicodeMatchUnicodeVariantMask: Int { get } var kUnicodeMatchUnicodeFormatMask: Int { get } var kUnicodeMatchOtherBaseMask: Int { get } var kUnicodeMatchOtherVariantMask: Int { get } var kUnicodeMatchOtherFormatMask: Int { get }

    Objective C

    enum { kUnicodeMatchUnicodeBaseMask = 1L << kUnicodeMatchUnicodeBaseBit, kUnicodeMatchUnicodeVariantMask = 1L << kUnicodeMatchUnicodeVariantBit, kUnicodeMatchUnicodeFormatMask = 1L << kUnicodeMatchUnicodeFormatBit, kUnicodeMatchOtherBaseMask = 1L << kUnicodeMatchOtherBaseBit, kUnicodeMatchOtherVariantMask = 1L << kUnicodeMatchOtherVariantBit, kUnicodeMatchOtherFormatMask = 1L << kUnicodeMatchOtherFormatBit };

    Константы

    • kUnicodeMatchUnicodeBaseMask

      kUnicodeMatchUnicodeBaseMask

      Если установлено, исключает отображения, не соответствующие текст, кодирующий основу unicodeEncoding поле структуры UnicodeMapping. Если не набор, функция игнорирует текст, кодирующий основу того поля.

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

    • kUnicodeMatchUnicodeVariantMask

      kUnicodeMatchUnicodeVariantMask

      Если установлено, исключает отображения, не соответствующие текст, кодирующий вариант unicodeEncoding поле указанной структуры отображения Unicode. Если не набор, функция игнорирует текст, кодирующий вариант того поля.

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

    • kUnicodeMatchUnicodeFormatMask

      kUnicodeMatchUnicodeFormatMask

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

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

    • kUnicodeMatchOtherBaseMask

      kUnicodeMatchOtherBaseMask

      Если установлено, исключает отображения, не соответствующие текст, кодирующий основу otherEncoding поле структуры UnicodeMapping. Если не набор, функция игнорирует текст, кодирующий основу того поля.

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

    • kUnicodeMatchOtherVariantMask

      kUnicodeMatchOtherVariantMask

      Если установлено, исключает отображения, не соответствующие текст, кодирующий вариант otherEncoding поле указанной структуры отображения Unicode. Если не набор, функция игнорирует текст, кодирующий вариант того поля.

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

    • kUnicodeMatchOtherFormatMask

      kUnicodeMatchOtherFormatMask

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

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

  • Укажите обработчик нейтрализации для Преобразователя Unicode для использования.

    Объявление

    Swift

    var kUnicodeFallbackDefaultOnly: Int { get } var kUnicodeFallbackCustomOnly: Int { get } var kUnicodeFallbackDefaultFirst: Int { get } var kUnicodeFallbackCustomFirst: Int { get }

    Objective C

    enum { kUnicodeFallbackDefaultOnly = 0, kUnicodeFallbackCustomOnly = 1, kUnicodeFallbackDefaultFirst = 2, kUnicodeFallbackCustomFirst = 3 };

    Константы

    • kUnicodeFallbackDefaultOnly

      kUnicodeFallbackDefaultOnly

      Используйте обработчик нейтрализации по умолчанию только.

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

    • kUnicodeFallbackCustomOnly

      kUnicodeFallbackCustomOnly

      Используйте пользовательский обработчик нейтрализации только.

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

    • kUnicodeFallbackDefaultFirst

      kUnicodeFallbackDefaultFirst

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

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

    • kUnicodeFallbackCustomFirst

      kUnicodeFallbackCustomFirst

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

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

    Обсуждение

    Используемый для указания, который должен использовать обработчик нейтрализации Преобразователь Unicode. При использовании и пользовательских и обработчиков по умолчанию можно установить порядок, в котором их вызывают. Вы используете эти константы для установки controlFlags параметр SetFallbackUnicodeToText и SetFallbackUnicodeToTextRun функции.

Кодировки и варианты

  • Укажите кодировки основного текста.

    Объявление

    Swift

    typealias TextEncodingBase = UInt32

    Objective C

    typedef UInt32 TextEncodingBase; enum { kTextEncodingMacRoman = 0, kTextEncodingMacJapanese = 1, kTextEncodingMacChineseTrad = 2, kTextEncodingMacKorean = 3, kTextEncodingMacArabic = 4, kTextEncodingMacHebrew = 5, kTextEncodingMacGreek = 6, kTextEncodingMacCyrillic = 7, kTextEncodingMacDevanagari = 9, kTextEncodingMacGurmukhi = 10, kTextEncodingMacGujarati = 11, kTextEncodingMacOriya = 12, kTextEncodingMacBengali = 13, kTextEncodingMacTamil = 14, kTextEncodingMacTelugu = 15, kTextEncodingMacKannada = 16, kTextEncodingMacMalayalam = 17, kTextEncodingMacSinhalese = 18, kTextEncodingMacBurmese = 19, kTextEncodingMacKhmer = 20, kTextEncodingMacThai = 21, kTextEncodingMacLaotian = 22, kTextEncodingMacGeorgian = 23, kTextEncodingMacArmenian = 24, kTextEncodingMacChineseSimp = 25, kTextEncodingMacTibetan = 26, kTextEncodingMacMongolian = 27, kTextEncodingMacEthiopic = 28, kTextEncodingMacCentralEurRoman = 29, kTextEncodingMacVietnamese = 30, kTextEncodingMacExtArabic = 31, kTextEncodingMacSymbol = 33, kTextEncodingMacDingbats = 34, kTextEncodingMacTurkish = 35, kTextEncodingMacCroatian = 36, kTextEncodingMacIcelandic = 37, kTextEncodingMacRomanian = 38, kTextEncodingMacCeltic = 39, kTextEncodingMacGaelic = 40, kTextEncodingMacKeyboardGlyphs = 41 };

    Константы

    • kTextEncodingMacRoman

      kTextEncodingMacRoman

      Кодирование для римлянина Mac OS.

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

    • kTextEncodingMacJapanese

      kTextEncodingMacJapanese

      Кодирование для японца Mac OS.

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

    • kTextEncodingMacChineseTrad

      kTextEncodingMacChineseTrad

      Кодирование для Mac OS традиционные китайцы.

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

    • kTextEncodingMacKorean

      kTextEncodingMacKorean

      Кодирование для корейца Mac OS.

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

    • kTextEncodingMacArabic

      kTextEncodingMacArabic

      Кодирование для арабского языка Mac OS.

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

    • kTextEncodingMacHebrew

      kTextEncodingMacHebrew

      Кодирование для еврея Mac OS.

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

    • kTextEncodingMacGreek

      kTextEncodingMacGreek

      Кодирование для грека Mac OS.

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

    • kTextEncodingMacCyrillic

      kTextEncodingMacCyrillic

      Кодирование для Кириллицы Mac OS.

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

    • kTextEncodingMacDevanagari

      kTextEncodingMacDevanagari

      Кодирование для Mac OS Devanagari.

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

    • kTextEncodingMacGurmukhi

      kTextEncodingMacGurmukhi

      Кодирование для Mac OS Gurmukhi.

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

    • kTextEncodingMacGujarati

      kTextEncodingMacGujarati

      Кодирование для Mac OS Gujurati.

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

    • kTextEncodingMacOriya

      kTextEncodingMacOriya

      Кодирование для ория Mac OS.

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

    • kTextEncodingMacBengali

      kTextEncodingMacBengali

      Кодирование для бенгальца Mac OS.

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

    • kTextEncodingMacTamil

      kTextEncodingMacTamil

      Кодирование для тамила Mac OS.

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

    • kTextEncodingMacTelugu

      kTextEncodingMacTelugu

      Кодирование для языка телугу Mac OS.

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

    • kTextEncodingMacKannada

      kTextEncodingMacKannada

      Кодирование для каннады Mac OS.

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

    • kTextEncodingMacMalayalam

      kTextEncodingMacMalayalam

      Кодирование для Малайялама Mac OS.

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

    • kTextEncodingMacSinhalese

      kTextEncodingMacSinhalese

      Кодирование для сингальца Mac OS.

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

    • kTextEncodingMacBurmese

      kTextEncodingMacBurmese

      Кодирование для бирманца Mac OS.

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

    • kTextEncodingMacKhmer

      kTextEncodingMacKhmer

      Кодирование для кхмера Mac OS.

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

    • kTextEncodingMacThai

      kTextEncodingMacThai

      Кодирование для тайца Mac OS.

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

    • kTextEncodingMacLaotian

      kTextEncodingMacLaotian

      Кодирование для лаосца Mac OS.

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

    • kTextEncodingMacGeorgian

      kTextEncodingMacGeorgian

      Кодирование для грузина Mac OS.

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

    • kTextEncodingMacArmenian

      kTextEncodingMacArmenian

      Кодирование для армянина Mac OS.

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

    • kTextEncodingMacChineseSimp

      kTextEncodingMacChineseSimp

      Кодирование для Mac OS простые китайцы.

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

    • kTextEncodingMacTibetan

      kTextEncodingMacTibetan

      Кодирование для тибетца Mac OS.

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

    • kTextEncodingMacMongolian

      kTextEncodingMacMongolian

      Кодирование для монгола Mac OS.

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

    • kTextEncodingMacEthiopic

      kTextEncodingMacEthiopic

      Кодирование для древнеэфиопского языка Mac OS.

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

    • kTextEncodingMacCentralEurRoman

      kTextEncodingMacCentralEurRoman

      Кодирование для центральноевропейского римлянина Mac OS.

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

    • kTextEncodingMacVietnamese

      kTextEncodingMacVietnamese

      Кодирование для вьетнамца Mac OS.

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

    • kTextEncodingMacExtArabic

      kTextEncodingMacExtArabic

      Кодирование для Mac OS ExtArabic.

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

    • kTextEncodingMacSymbol

      kTextEncodingMacSymbol

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacDingbats

      kTextEncodingMacDingbats

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacTurkish

      kTextEncodingMacTurkish

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacCroatian

      kTextEncodingMacCroatian

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacIcelandic

      kTextEncodingMacIcelandic

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacRomanian

      kTextEncodingMacRomanian

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacCeltic

      kTextEncodingMacCeltic

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacGaelic

      kTextEncodingMacGaelic

      Этот Mac OS, кодирующий сценарий использования, кодирует 0, smRoman.

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

    • kTextEncodingMacKeyboardGlyphs

      kTextEncodingMacKeyboardGlyphs

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

    Обсуждение

    Вы используете основной текст, кодирующий тип данных для указания, какое текстовое кодирование или текстовая схема кодирования Вы раньше выражали данный текст. Текст, кодирующий основное значение, является основной спецификацией источника или целевого кодирования. Значения 0 до 32 соответствуют непосредственно кодам сценария Mac OS. Значения 33 - 254 для других кодировок Mac OS, не имеющих их собственных кодов сценария, таких как кодирование Символа реализованными шрифтом Символа. Можно также указать метазначение как кодирование основного текста, такой как kTextEncodingMacHFS и kTextEncodingUnicodeDefault. Метазначение отображается на действительном значении.

    Функция GetTextEncodingBase возвращает текст, кодирующий основу текста, кодирующего спецификацию.

    Кодирование основного текста определяется TextEncodingBase тип данных.

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

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

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

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

    Объявление

    Objective C

    enum { kTextEncodingMacTradChinese = kTextEncodingMacChineseTrad, kTextEncodingMacRSymbol = 8, kTextEncodingMacSimpChinese = kTextEncodingMacChineseSimp, kTextEncodingMacGeez = kTextEncodingMacEthiopic, kTextEncodingMacEastEurRoman = kTextEncodingMacCentralEurRoman, kTextEncodingMacUninterp = 32 };

  • Укажите текстовые кодировки, используемые компьютерами IBM.

    Объявление

    Swift

    var kTextEncodingEBCDIC_US: Int { get } var kTextEncodingEBCDIC_CP037: Int { get }

    Objective C

    enum { kTextEncodingEBCDIC_US = 0x0C01, kTextEncodingEBCDIC_CP037 = 0x0C02 };

    Константы

    • kTextEncodingEBCDIC_US

      kTextEncodingEBCDIC_US

      Основные EBCDIC-США, кодирующие.

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

    • kTextEncodingEBCDIC_CP037

      kTextEncodingEBCDIC_CP037

      Кодовая страница 037, расширенные EBCDIC-США Latin1.

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

    Обсуждение

    EBCDIC (Расширенный Код для обмена информацией Двоично-десятичного числа) используется компьютерами IBM для представления символов как чисел.

  • Укажите варианты Больших 5 кодирования.

    Объявление

    Swift

    var kBig5_BasicVariant: Int { get } var kBig5_StandardVariant: Int { get } var kBig5_ETenVariant: Int { get }

    Objective C

    enum { kBig5_BasicVariant = 0, kBig5_StandardVariant = 1, kBig5_ETenVariant = 2 };

    Константы

    • kBig5_BasicVariant

      kBig5_BasicVariant

      Основной вариант кодирования.

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

    • kBig5_StandardVariant

      kBig5_StandardVariant

      Стандартный вариант; 0xC6A1-0xC7FC: кана, Кириллические, вложенные численные данные.

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

    • kBig5_ETenVariant

      kBig5_ETenVariant

      Добавляют кана, Кириллица, радикалы, и т.д с высокими байтами C6-C8, F9.

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

    Обсуждение

    Большие 5 кодирования было разработано пятью компаниями как стандарт набора символов в Tawain.

  • Укажите различные кодировки Mac OS, использующие коды сценария кроме 0

    Объявление

    Swift

    var kTextEncodingMacFarsi: Int { get } var kTextEncodingMacUkrainian: Int { get } var kTextEncodingMacInuit: Int { get } var kTextEncodingMacVT100: Int { get }

    Objective C

    enum { kTextEncodingMacFarsi = 0x8C, kTextEncodingMacUkrainian = 0x98, kTextEncodingMacInuit = 0xEC, kTextEncodingMacVT100 = 0xFC };

    Константы

    • kTextEncodingMacFarsi

      kTextEncodingMacFarsi

      Сценарий использования кодирует 4, smArabic. Это подобно арабскому языку Mac, но использует цифры фарси.]

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

    • kTextEncodingMacUkrainian

      kTextEncodingMacUkrainian

      Сценарий использования кодирует 7, smCyrillic.]

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

    • kTextEncodingMacInuit

      kTextEncodingMacInuit

      Сценарий использования кодирует 28, smEthiopic.]

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

    • kTextEncodingMacVT100

      kTextEncodingMacVT100

      Сценарий использования кодирует 32, smUninterp; Шрифт VT100/102 от общей панели инструментов; латинский 1 символ плюс получение поля.]

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

  • Укажите варианты Макарабика.

    Объявление

    Swift

    var kMacArabicStandardVariant: Int { get } var kMacArabicTrueTypeVariant: Int { get } var kMacArabicThuluthVariant: Int { get } var kMacArabicAlBayanVariant: Int { get }

    Objective C

    enum { kMacArabicStandardVariant = 0, kMacArabicTrueTypeVariant = 1, kMacArabicThuluthVariant = 2, kMacArabicAlBayanVariant = 3 };

    Константы

    • kMacArabicStandardVariant

      kMacArabicStandardVariant

      Арабский вариант Mac OS поддерживается Каирским шрифтом (системный шрифт для арабского языка) и является кодированием, поддерживаемым утилитами обработки текста.

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

    • kMacArabicTrueTypeVariant

      kMacArabicTrueTypeVariant

      Арабский вариант Mac OS использовал для большинства арабских шрифтов TrueType: Багдад, Geeza, Kufi, Nadeem.

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

    • kMacArabicThuluthVariant

      kMacArabicThuluthVariant

      Арабский вариант Mac OS использовал для арабских шрифтов только для PostScript: Thuluth и полужирный Thuluth.

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

    • kMacArabicAlBayanVariant

      kMacArabicAlBayanVariant

      Арабский вариант Mac OS использовал для арабского шрифта TrueType Al Bayan.

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

  • Укажите варианты Маккроэйшна.

    Объявление

    Swift

    var kMacCroatianDefaultVariant: Int { get } var kMacCroatianCurrencySignVariant: Int { get } var kMacCroatianEuroSignVariant: Int { get }

    Objective C

    enum { kMacCroatianDefaultVariant = 0, kMacCroatianCurrencySignVariant = 1, kMacCroatianEuroSignVariant = 2 };

    Константы

    • kMacCroatianDefaultVariant

      kMacCroatianDefaultVariant

      Это - значение meta, отображающееся на одну из следующих констант, в зависимости от версии Mac OS.

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

    • kMacCroatianCurrencySignVariant

      kMacCroatianCurrencySignVariant

      В версиях Mac OS ранее, чем 8,5, 0xDB является валютным знаком.

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

    • kMacCroatianEuroSignVariant

      kMacCroatianEuroSignVariant

      В версии 8.5 Mac OS и позже, 0xDB является Европейским знаком.

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

  • Укажите варианты Маккириллика.

    Объявление

    Swift

    var kMacCyrillicDefaultVariant: Int { get } var kMacCyrillicCurrSignStdVariant: Int { get } var kMacCyrillicCurrSignUkrVariant: Int { get } var kMacCyrillicEuroSignVariant: Int { get }

    Objective C

    enum { kMacCyrillicDefaultVariant = 0, kMacCyrillicCurrSignStdVariant = 1, kMacCyrillicCurrSignUkrVariant = 2, kMacCyrillicEuroSignVariant = 3 };

    Константы

    • kMacCyrillicDefaultVariant

      kMacCyrillicDefaultVariant

      Это - значение meta, отображающееся на одну из следующих констант, в зависимости от версии Mac OS.

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

    • kMacCyrillicCurrSignStdVariant

      kMacCyrillicCurrSignStdVariant

      В версиях Mac OS до 9,0 (RU, BG), 0xFF = валютный знак, 0xA2/0xB6 = CENT / РАЗЛИЧНЫЙ PARTIAL

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

    • kMacCyrillicCurrSignUkrVariant

      kMacCyrillicCurrSignUkrVariant

      В версии 9.0 Mac OS и позже (UA, LangKit), 0xFF = валютный знак, 0xA2/0xB6 = GHE с подъемом.

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

    • kMacCyrillicEuroSignVariant

      kMacCyrillicEuroSignVariant

      В Mac OS 9.0 и позже, 0xFF является Европейским знаком, 0xA2/0xB6 = GHE с подъемом.

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

  • Укажите варианты Макфарси.

    Объявление

    Swift

    var kMacFarsiStandardVariant: Int { get } var kMacFarsiTrueTypeVariant: Int { get }

    Objective C

    enum { kMacFarsiStandardVariant = 0, kMacFarsiTrueTypeVariant = 1 };

    Константы

    • kMacFarsiStandardVariant

      kMacFarsiStandardVariant

      Этот вариант фарси Mac OS поддерживается Тегеранским шрифтом (системный шрифт для фарси) и является кодированием, поддерживаемым утилитами обработки текста.

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

    • kMacFarsiTrueTypeVariant

      kMacFarsiTrueTypeVariant

      Этот вариант фарси Mac OS используется для большей части фарси шрифты TrueType: Ashfahan, Эмир, Камрэн, Мешхед, NadeemFarsi.

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

  • Укажите варианты Макхебрю.

    Объявление

    Swift

    var kMacHebrewStandardVariant: Int { get } var kMacHebrewFigureSpaceVariant: Int { get }

    Objective C

    enum { kMacHebrewStandardVariant = 0, kMacHebrewFigureSpaceVariant = 1 };

    Константы

    • kMacHebrewStandardVariant

      kMacHebrewStandardVariant

      Стандартный еврейский вариант Mac OS.

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

    • kMacHebrewFigureSpaceVariant

      kMacHebrewFigureSpaceVariant

      Еврейский вариант Mac OS, в котором 0xD4 представляет пробел, равный по ширине цифрам, не оставленный единственную кавычку как в стандартном варианте.

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

  • Укажите варианты Макиселэндика.

    Объявление

    Swift

    var kMacIcelandicStdDefaultVariant: Int { get } var kMacIcelandicTTDefaultVariant: Int { get } var kMacIcelandicStdCurrSignVariant: Int { get } var kMacIcelandicTTCurrSignVariant: Int { get } var kMacIcelandicStdEuroSignVariant: Int { get } var kMacIcelandicTTEuroSignVariant: Int { get }

    Objective C

    enum { kMacIcelandicStdDefaultVariant = 0, kMacIcelandicTTDefaultVariant = 1, kMacIcelandicStdCurrSignVariant = 2, kMacIcelandicTTCurrSignVariant = 3, kMacIcelandicStdEuroSignVariant = 4, kMacIcelandicTTEuroSignVariant = 5 };

    Константы

    • kMacIcelandicStdDefaultVariant

      kMacIcelandicStdDefaultVariant

      Это - значение meta, отображающееся на kMacIcelandicStdCurrSignVariant или kMacIcelandicStdEuroSignVariant, В зависимости от версии Mac OS.

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

    • kMacIcelandicTTDefaultVariant

      kMacIcelandicTTDefaultVariant

      Это - значение meta, отображающееся на kMacIcelandicTTCurrSignVariant или kMacIcelandicTTEuroSignVariant, В зависимости от версии Mac OS.

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

    • kMacIcelandicStdCurrSignVariant

      kMacIcelandicStdCurrSignVariant

      В версиях Mac OS до 8,5, 0xDB является валютным знаком; 0xBB/0xBC являются fem./masc. порядковыми индикаторами.

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

    • kMacIcelandicTTCurrSignVariant

      kMacIcelandicTTCurrSignVariant

      В версиях Mac OS до 8,5, 0xDB является валютным знаком; 0xBB/0xBC являются fi/fl лигатурами

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

    • kMacIcelandicStdEuroSignVariant

      kMacIcelandicStdEuroSignVariant

      В версии 8.5 Mac OS и позже, 0xDB является Европейским знаком; 0xBB/0xBC являются fem./masc. порядковыми индикаторами.

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

    • kMacIcelandicTTEuroSignVariant

      kMacIcelandicTTEuroSignVariant

      В версиях Mac OS ранее, чем 8,5, 0xDB является Европейским знаком; 0xBB/0xBC являются fi/fl лигатурами.

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

  • Укажите варианты Макджэпэнезе.

    Объявление

    Swift

    var kMacJapaneseStandardVariant: Int { get } var kMacJapaneseStdNoVerticalsVariant: Int { get } var kMacJapaneseBasicVariant: Int { get } var kMacJapanesePostScriptScrnVariant: Int { get } var kMacJapanesePostScriptPrintVariant: Int { get } var kMacJapaneseVertAtKuPlusTenVariant: Int { get }

    Objective C

    enum { kMacJapaneseStandardVariant = 0, kMacJapaneseStdNoVerticalsVariant = 1, kMacJapaneseBasicVariant = 2, kMacJapanesePostScriptScrnVariant = 3, kMacJapanesePostScriptPrintVariant = 4, kMacJapaneseVertAtKuPlusTenVariant = 5 };

    Константы

    • kMacJapaneseStandardVariant

      kMacJapaneseStandardVariant

      Стандартный японский вариант Mac OS. Shift-JIS с римскими модификациями JIS, дополнительными 1-байтовыми символами, 2-байтовыми расширениями Apple и некоторым вертикальным представлением формируется в диапазоне 0xEB40 — 0xEDFE (“ku плюс 84 дюйма).

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

    • kMacJapaneseStdNoVerticalsVariant

      kMacJapaneseStdNoVerticalsVariant

      Искусственный японский вариант Mac OS для вызывающих сторон, кто не хочет использовать отдельно закодированные вертикальные формы (например, разработчики, использующие QuickDraw GX).

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

    • kMacJapaneseBasicVariant

      kMacJapaneseBasicVariant

      Искусственный японский вариант Mac OS без расширений двойного байта Apple.

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

    • kMacJapanesePostScriptScrnVariant

      kMacJapanesePostScriptScrnVariant

      Японский вариант Mac OS для экрана побитово отображает версию Сая Mincho и шрифты готического шрифта Чу.

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

    • kMacJapanesePostScriptPrintVariant

      kMacJapanesePostScriptPrintVariant

      Японский вариант Mac OS для версий печати PostScript Сая Mincho и шрифты PostScript готического шрифта Чу. Эта версия включает полуширинные символы двойного байта в дополнение к однобайтовым полуширинным символам.

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

    • kMacJapaneseVertAtKuPlusTenVariant

      kMacJapaneseVertAtKuPlusTenVariant

      Японский вариант Mac OS для почтенного Mincho и готических шрифтов Maru, используемых в японской локализованной версии Системы 7.1. Это не включает стандартные расширения Apple и кодирует вертикальные формы в различном расположении.

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

  • Укажите варианты Макрочеловека.

    Объявление

    Swift

    var kMacRomanStandardVariant: Int { get } var kMacIcelandicStandardVariant: Int { get } var kMacIcelandicTrueTypeVariant: Int { get } var kJapaneseStandardVariant: Int { get } var kJapaneseStdNoVerticalsVariant: Int { get } var kJapaneseBasicVariant: Int { get } var kJapanesePostScriptScrnVariant: Int { get } var kJapanesePostScriptPrintVariant: Int { get } var kJapaneseVertAtKuPlusTenVariant: Int { get } var kHebrewStandardVariant: Int { get } var kHebrewFigureSpaceVariant: Int { get } var kUnicodeMaxDecomposedVariant: Int { get } var kUnicodeNoComposedVariant: Int { get }

    Objective C

    enum { kMacRomanStandardVariant = 0, kMacIcelandicStandardVariant = 0, kMacIcelandicTrueTypeVariant = 1, kJapaneseStandardVariant = 0, kJapaneseStdNoVerticalsVariant = 1, kJapaneseBasicVariant = 2, kJapanesePostScriptScrnVariant = 3, kJapanesePostScriptPrintVariant = 4, kJapaneseVertAtKuPlusTenVariant = 5, kHebrewStandardVariant = 0, kHebrewFigureSpaceVariant = 1, kUnicodeMaxDecomposedVariant = 2, kUnicodeNoComposedVariant = 3, kJapaneseNoOneByteKanaOption = 0x20, kJapaneseUseAsciiBackslashOption = 0x40 };

    Константы

    • kMacRomanStandardVariant

      kMacRomanStandardVariant

      Стандартный вариант римлянина Mac OS для Mac OS 8.5 и позже; 0xDB является Европейским знаком.

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

    • kMacIcelandicStandardVariant

      kMacIcelandicStandardVariant

      Стандартный исландский язык Mac OS кодирование поддерживаемого растровыми версиями Чикаго, Женевы, Монако и Нью-Йорка в исландской системе. Это - также вариант, поддерживаемый утилитами обработки текста.

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

    • kMacIcelandicTrueTypeVariant

      kMacIcelandicTrueTypeVariant

      Исландский вариант Mac OS, используемый для растровых версий Курьера, Helvetica, Palatino, и Времена в исландской системе, и для версий TrueType Чикаго, Женевы, Монако, Нью-Йорка, Курьера, Helvetica, Palatino, и Времена.

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

    • kJapaneseStandardVariant

      kJapaneseStandardVariant

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

    • kJapaneseStdNoVerticalsVariant

      kJapaneseStdNoVerticalsVariant

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

    • kJapaneseBasicVariant

      kJapaneseBasicVariant

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

    • kJapanesePostScriptScrnVariant

      kJapanesePostScriptScrnVariant

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

    • kJapanesePostScriptPrintVariant

      kJapanesePostScriptPrintVariant

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

    • kJapaneseVertAtKuPlusTenVariant

      kJapaneseVertAtKuPlusTenVariant

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

    • kHebrewStandardVariant

      kHebrewStandardVariant

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

    • kHebrewFigureSpaceVariant

      kHebrewFigureSpaceVariant

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

    • kUnicodeMaxDecomposedVariant

      kUnicodeMaxDecomposedVariant

      Замененный kUnicodeCanonicalDecompVariant.

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

    • kUnicodeNoComposedVariant

      kUnicodeNoComposedVariant

      Замененный kUnicodeCanonicalCompVariant.

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

    • kJapaneseNoOneByteKanaOption

      kJapaneseNoOneByteKanaOption

      Замененный опцией Unicode Converter kUnicodeNoHalfwidthCharsBit.

      Доступный в OS X v10.0 через OS X v10.4.

      Не доступный 64-разрядным приложениям.

    • kJapaneseUseAsciiBackslashOption

      kJapaneseUseAsciiBackslashOption

      Замененный опцией Unicode Converter kUnicodeForceASCIIRangeBit.

      Доступный в OS X v10.0 через OS X v10.4.

      Не доступный 64-разрядным приложениям.

  • Укажите варианты Макрочеловека, связанные с валютой.

    Объявление

    Swift

    var kMacRomanDefaultVariant: Int { get } var kMacRomanCurrencySignVariant: Int { get } var kMacRomanEuroSignVariant: Int { get }

    Objective C

    enum { kMacRomanDefaultVariant = 0, kMacRomanCurrencySignVariant = 1, kMacRomanEuroSignVariant = 2 };

    Константы

    • kMacRomanDefaultVariant

      kMacRomanDefaultVariant

      Это - значение meta, отображающееся на одну из следующих констант, в зависимости от версии Mac OS.

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

    • kMacRomanCurrencySignVariant

      kMacRomanCurrencySignVariant

      В версиях Mac OS ранее, чем 8,5 0xDB валютный знак; все еще используемый для некоторых более старых шрифтов даже в Mac OS 8.5.

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

    • kMacRomanEuroSignVariant

      kMacRomanEuroSignVariant

      В версии 8.5 Mac OS и позже, 0xDB является Европейским знаком.

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

  • Укажите варианты Макромэниэна.

    Объявление

    Swift

    var kMacRomanianDefaultVariant: Int { get } var kMacRomanianCurrencySignVariant: Int { get } var kMacRomanianEuroSignVariant: Int { get }

    Objective C

    enum { kMacRomanianDefaultVariant = 0, kMacRomanianCurrencySignVariant = 1, kMacRomanianEuroSignVariant = 2 };

    Константы

    • kMacRomanianDefaultVariant

      kMacRomanianDefaultVariant

      Это - значение meta, отображающееся на одну из следующих констант, в зависимости от версии Mac OS.

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

    • kMacRomanianCurrencySignVariant

      kMacRomanianCurrencySignVariant

      В версиях Mac OS ранее, чем 8,5, 0xDB является валютным знаком.

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

    • kMacRomanianEuroSignVariant

      kMacRomanianEuroSignVariant

      В версии 8.5 Mac OS и позже, 0xDB является Европейским знаком.

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

  • Укажите варианты Макромэнлэтин1.

    Объявление

    Swift

    var kMacRomanLatin1DefaultVariant: Int { get } var kMacRomanLatin1StandardVariant: Int { get } var kMacRomanLatin1TurkishVariant: Int { get } var kMacRomanLatin1CroatianVariant: Int { get } var kMacRomanLatin1IcelandicVariant: Int { get } var kMacRomanLatin1RomanianVariant: Int { get }

    Objective C

    enum { kMacRomanLatin1DefaultVariant = 0, kMacRomanLatin1StandardVariant = 2, kMacRomanLatin1TurkishVariant = 6, kMacRomanLatin1CroatianVariant = 8, kMacRomanLatin1IcelandicVariant = 11, kMacRomanLatin1RomanianVariant = 14 };

    Константы

    • kMacRomanLatin1DefaultVariant

      kMacRomanLatin1DefaultVariant

      Это - значение meta, отображающееся на одну из следующих констант, в зависимости от версии Mac OS.

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

    • kMacRomanLatin1StandardVariant

      kMacRomanLatin1StandardVariant

      Переставленный Макрочеловек, Европейский вариант знака.

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

    • kMacRomanLatin1TurkishVariant

      kMacRomanLatin1TurkishVariant

      Переставленный Мактеркиш.

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

    • kMacRomanLatin1CroatianVariant

      kMacRomanLatin1CroatianVariant

      Переставленный Маккроутиэн, Европейский вариант знака.

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

    • kMacRomanLatin1IcelandicVariant

      kMacRomanLatin1IcelandicVariant

      Переставленный Макиселэндик, стандартный Европейский вариант знака.

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

    • kMacRomanLatin1RomanianVariant

      kMacRomanLatin1RomanianVariant

      Переставленный Макромэниэн, Европейский вариант знака.

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

  • Укажите варианты Маквт100.

    Объявление

    Swift

    var kMacVT100DefaultVariant: Int { get } var kMacVT100CurrencySignVariant: Int { get } var kMacVT100EuroSignVariant: Int { get }

    Objective C

    enum { kMacVT100DefaultVariant = 0, kMacVT100CurrencySignVariant = 1, kMacVT100EuroSignVariant = 2 };

    Константы

    • kMacVT100DefaultVariant

      kMacVT100DefaultVariant

      Это - значение meta, отображающееся на одну из следующих констант, в зависимости от версии Mac OS.

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

    • kMacVT100CurrencySignVariant

      kMacVT100CurrencySignVariant

      В версиях Mac OS ранее, чем 8,5, 0xDB является валютным знаком.

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

    • kMacVT100EuroSignVariant

      kMacVT100EuroSignVariant

      В версии 8.5 Mac OS и позже, 0xDB является Европейским знаком.

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

  • Укажите варианты Unicode.

    Объявление

    Swift

    var kUnicodeNoSubset: Int { get } var kUnicodeCanonicalDecompVariant: Int { get } var kUnicodeCanonicalCompVariant: Int { get } var kUnicodeHFSPlusDecompVariant: Int { get } var kUnicodeHFSPlusCompVariant: Int { get }

    Objective C

    enum { kUnicodeNoSubset = 0, kUnicodeCanonicalDecompVariant = 2, kUnicodeCanonicalCompVariant = 3, kUnicodeHFSPlusDecompVariant = 8, kUnicodeHFSPlusCompVariant = 9 };

    Константы

    • kUnicodeNoSubset

      kUnicodeNoSubset

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

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

    • kUnicodeCanonicalDecompVariant

      kUnicodeCanonicalDecompVariant

      Вариант Unicode с помощью максимального разложения с символами в каноническом порядке. Этот вариант не включает большинство символов, имеющих каноническое разложение, такое как отдельные символы для латинских букв с диакритическим знаком или отдельные символы для корейских слогов Хангула (однако, это ограничение ослабляется для символов символа в диапазоне U+2000 к U+2FFF). В менеджере по TEC 1.3, Преобразователь Unicode поддерживает этот вариант для преобразования в и от кодировок Mac OS.

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

    • kUnicodeCanonicalCompVariant

      kUnicodeCanonicalCompVariant

      Это - нормальный канонический состав согласно правилам Unicode 3.2.

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

    • kUnicodeHFSPlusDecompVariant

      kUnicodeHFSPlusDecompVariant

      Указывает каноническое разложение согласно правилам Unicode 3.2, с HFS + исключения («HFS + разложение 3.2»). Т.е. это не разлагается в 2000-2FFF, F900-FAFF, 2F800-2FAFF. Можно использовать тыс опции при преобразовании имен файлов HFS.

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

    • kUnicodeHFSPlusCompVariant

      kUnicodeHFSPlusCompVariant

      Указывает канонический состав согласно правилам Unicode 3.2, но использование HFS + исключения разложения. Можно использовать тыс опции при преобразовании имен файлов HFS. Необходимо использовать эту форму, когда Вы хотите получить составленную форму, которая может быть преобразована в и от анализируемой формы, указанной kUnicodeHFSPlusDecompVariant. Это - рекомендуемый способ запросить разложения с HFS + исключения вместо использования mappingVersion = kUnicodeUseHFSPlusMapping.

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

  • Укажите текстовые кодировки Кода Unix Extendec.

    Объявление

    Swift

    var kTextEncodingEUC_JP: Int { get } var kTextEncodingEUC_CN: Int { get } var kTextEncodingEUC_TW: Int { get } var kTextEncodingEUC_KR: Int { get }

    Objective C

    enum { kTextEncodingEUC_JP = 0x0920, kTextEncodingEUC_CN = 0x0930, kTextEncodingEUC_TW = 0x0931, kTextEncodingEUC_KR = 0x0940 };

    Константы

    • kTextEncodingEUC_JP

      kTextEncodingEUC_JP

      ISO 646,1 байтов katakana, JIS 208, JIS 212.

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

    • kTextEncodingEUC_CN

      kTextEncodingEUC_CN

      ISO 646, ГБАЙТ 2312-80.

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

    • kTextEncodingEUC_TW

      kTextEncodingEUC_TW

      ISO 646, CNS 11643-1992 плоскости 1-16.

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

    • kTextEncodingEUC_KR

      kTextEncodingEUC_KR

      ISO 646, KS C 5601-1987.

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

  • Указывает Mac OS текстовое кодирование HFS.

    Объявление

    Swift

    var kTextEncodingMacHFS: Int { get }

    Objective C

    enum { kTextEncodingMacHFS = 0xFF };

    Константы

    • kTextEncodingMacHFS

      kTextEncodingMacHFS

      Это - метазначение для специального кодирования Mac OS.

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

  • Укажите текстовые кодировки для ISO 2002.

    Объявление

    Swift

    var kTextEncodingISO_2022_JP: Int { get } var kTextEncodingISO_2022_JP_2: Int { get } var kTextEncodingISO_2022_JP_1: Int { get } var kTextEncodingISO_2022_JP_3: Int { get } var kTextEncodingISO_2022_CN: Int { get } var kTextEncodingISO_2022_CN_EXT: Int { get } var kTextEncodingISO_2022_KR: Int { get }

    Objective C

    enum { kTextEncodingISO_2022_JP = 0x0820, kTextEncodingISO_2022_JP_2 = 0x0821, kTextEncodingISO_2022_JP_1 = 0x0822, kTextEncodingISO_2022_JP_3 = 0x0823, kTextEncodingISO_2022_CN = 0x0830, kTextEncodingISO_2022_CN_EXT = 0x0831, kTextEncodingISO_2022_KR = 0x0840 };

    Константы

    • kTextEncodingISO_2022_JP

      kTextEncodingISO_2022_JP

      Посмотрите RFC 1468.

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

    • kTextEncodingISO_2022_JP_2

      kTextEncodingISO_2022_JP_2

      Посмотрите RFC 1554.

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

    • kTextEncodingISO_2022_JP_1

      kTextEncodingISO_2022_JP_1

      Посмотрите RFC 2237.

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

    • kTextEncodingISO_2022_JP_3

      kTextEncodingISO_2022_JP_3

      JIS X0213

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

    • kTextEncodingISO_2022_CN

      kTextEncodingISO_2022_CN

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

    • kTextEncodingISO_2022_CN_EXT

      kTextEncodingISO_2022_CN_EXT

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

    • kTextEncodingISO_2022_KR

      kTextEncodingISO_2022_KR

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

  • Укажите текстовые кодировки для ISO, 8-разрядного и 7-разрядного.

    Объявление

    Swift

    var kTextEncodingISOLatin1: Int { get } var kTextEncodingISOLatin2: Int { get } var kTextEncodingISOLatin3: Int { get } var kTextEncodingISOLatin4: Int { get } var kTextEncodingISOLatinCyrillic: Int { get } var kTextEncodingISOLatinArabic: Int { get } var kTextEncodingISOLatinGreek: Int { get } var kTextEncodingISOLatinHebrew: Int { get } var kTextEncodingISOLatin5: Int { get } var kTextEncodingISOLatin6: Int { get } var kTextEncodingISOLatin7: Int { get } var kTextEncodingISOLatin8: Int { get } var kTextEncodingISOLatin9: Int { get }

    Objective C

    enum { kTextEncodingISOLatin1 = 0x0201, kTextEncodingISOLatin2 = 0x0202, kTextEncodingISOLatin3 = 0x0203, kTextEncodingISOLatin4 = 0x0204, kTextEncodingISOLatinCyrillic = 0x0205, kTextEncodingISOLatinArabic = 0x0206, kTextEncodingISOLatinGreek = 0x0207, kTextEncodingISOLatinHebrew = 0x0208, kTextEncodingISOLatin5 = 0x0209, kTextEncodingISOLatin6 = 0x020A, kTextEncodingISOLatin7 = 0x020D, kTextEncodingISOLatin8 = 0x020E, kTextEncodingISOLatin9 = 0x020F };

    Константы

    • kTextEncodingISOLatin1

      kTextEncodingISOLatin1

      ISO 8859-1.

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

    • kTextEncodingISOLatin2

      kTextEncodingISOLatin2

      ISO 8859-2.

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

    • kTextEncodingISOLatin3

      kTextEncodingISOLatin3

      ISO 8859-3.

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

    • kTextEncodingISOLatin4

      kTextEncodingISOLatin4

      ISO 8859-4.

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

    • kTextEncodingISOLatinCyrillic

      kTextEncodingISOLatinCyrillic

      ISO 8859-5.

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

    • kTextEncodingISOLatinArabic

      kTextEncodingISOLatinArabic

      ISO 8859-6; эквивалентный ASMO 708 и DOS CP 708.

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

    • kTextEncodingISOLatinGreek

      kTextEncodingISOLatinGreek

      ISO 8859-7.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISOLatinHebrew

      kTextEncodingISOLatinHebrew

      ISO 8859-8.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISOLatin5

      kTextEncodingISOLatin5

      ISO 8859-9.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISOLatin6

      kTextEncodingISOLatin6

      ISO 8859-10.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISOLatin7

      kTextEncodingISOLatin7

      ISO 8859-13; балтийская оправа

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISOLatin8

      kTextEncodingISOLatin8

      ISO 8859-14; кельтский

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISOLatin9

      kTextEncodingISOLatin9

      ISO 8859-15, 8859-1; измененный за Евро и буквы CP1252

      Доступный в OS X v10.0 и позже.

  • Указывает код сценария, который должен быть обработан как специальный код сценария Mac OS.

    Объявление

    Swift

    var kTextEncodingMacUnicode: Int { get }

    Objective C

    enum { kTextEncodingMacUnicode = 0x7E };

    Константы

    • kTextEncodingMacUnicode

      kTextEncodingMacUnicode

      Начинаясь с Mac OS 8.5, набор кодов сценария Mac OS был расширен для некоторых компонентов Mac OS для включения Unicode. Некоторые из этих компонентов имеют только 7 битов в наличии для кода сценария, таким образом, kTextEncodingUnicodeDefault не может использоваться для указания Unicode. Вместо этого kTextEncodingMacUnicode используется в качестве метазначения, чтобы указать, что Unicode обрабатывает код сценария специальный код сценария Mac OS. Текст, Кодирующий Преобразователь, обрабатывает это значение, подобное способу, которым это обрабатывает константу kTextEncodingUnicodeDefault.

      Доступный в OS X v10.0 и позже.

  • Укажите разные текстовые кодировки.

    Объявление

    Swift

    var kTextEncodingShiftJIS: Int { get } var kTextEncodingKOI8_R: Int { get } var kTextEncodingBig5: Int { get } var kTextEncodingMacRomanLatin1: Int { get } var kTextEncodingHZ_GB_2312: Int { get } var kTextEncodingBig5_HKSCS_1999: Int { get }

    Objective C

    enum { kTextEncodingShiftJIS = 0x0A01, kTextEncodingKOI8_R = 0x0A02, kTextEncodingBig5 = 0x0A03, kTextEncodingMacRomanLatin1 = 0x0A04, kTextEncodingHZ_GB_2312 = 0x0A05, kTextEncodingBig5_HKSCS_1999 = 0x0A06 };

    Константы

    • kTextEncodingShiftJIS

      kTextEncodingShiftJIS

      Простой Shift-JIS.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingKOI8_R

      kTextEncodingKOI8_R

      Российский интернет-стандарт.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingBig5

      kTextEncodingBig5

      Большие 5 кодирования.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingMacRomanLatin1

      kTextEncodingMacRomanLatin1

      Римлянин Mac OS переставил для выравнивания с 8859-1.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingHZ_GB_2312

      kTextEncodingHZ_GB_2312

      Посмотрите RFC 1842; для китайской почты и новостей.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingBig5_HKSCS_1999

      kTextEncodingBig5_HKSCS_1999

      Доступный в OS X v10.1 и позже.

  • Укажите текстовые кодировки для MS-DOS и Windows.

    Объявление

    Swift

    var kTextEncodingDOSLatinUS: Int { get } var kTextEncodingDOSGreek: Int { get } var kTextEncodingDOSBalticRim: Int { get } var kTextEncodingDOSLatin1: Int { get } var kTextEncodingDOSGreek1: Int { get } var kTextEncodingDOSLatin2: Int { get } var kTextEncodingDOSCyrillic: Int { get } var kTextEncodingDOSTurkish: Int { get } var kTextEncodingDOSPortuguese: Int { get } var kTextEncodingDOSIcelandic: Int { get } var kTextEncodingDOSHebrew: Int { get } var kTextEncodingDOSCanadianFrench: Int { get } var kTextEncodingDOSArabic: Int { get } var kTextEncodingDOSNordic: Int { get } var kTextEncodingDOSRussian: Int { get } var kTextEncodingDOSGreek2: Int { get } var kTextEncodingDOSThai: Int { get } var kTextEncodingDOSJapanese: Int { get } var kTextEncodingDOSChineseSimplif: Int { get } var kTextEncodingDOSKorean: Int { get } var kTextEncodingDOSChineseTrad: Int { get } var kTextEncodingWindowsLatin1: Int { get } var kTextEncodingWindowsANSI: Int { get } var kTextEncodingWindowsLatin2: Int { get } var kTextEncodingWindowsCyrillic: Int { get } var kTextEncodingWindowsGreek: Int { get } var kTextEncodingWindowsLatin5: Int { get } var kTextEncodingWindowsHebrew: Int { get } var kTextEncodingWindowsArabic: Int { get } var kTextEncodingWindowsBalticRim: Int { get } var kTextEncodingWindowsVietnamese: Int { get } var kTextEncodingWindowsKoreanJohab: Int { get }

    Objective C

    enum { kTextEncodingDOSLatinUS = 0x0400, kTextEncodingDOSGreek = 0x0405, kTextEncodingDOSBalticRim = 0x0406, kTextEncodingDOSLatin1 = 0x0410, kTextEncodingDOSGreek1 = 0x0411, kTextEncodingDOSLatin2 = 0x0412, kTextEncodingDOSCyrillic = 0x0413, kTextEncodingDOSTurkish = 0x0414, kTextEncodingDOSPortuguese = 0x0415, kTextEncodingDOSIcelandic = 0x0416, kTextEncodingDOSHebrew = 0x0417, kTextEncodingDOSCanadianFrench = 0x0418, kTextEncodingDOSArabic = 0x0419, kTextEncodingDOSNordic = 0x041A, kTextEncodingDOSRussian = 0x041B, kTextEncodingDOSGreek2 = 0x041C, kTextEncodingDOSThai = 0x041D, kTextEncodingDOSJapanese = 0x0420, kTextEncodingDOSChineseSimplif = 0x0421, kTextEncodingDOSKorean = 0x0422, kTextEncodingDOSChineseTrad = 0x0423, kTextEncodingWindowsLatin1 = 0x0500, kTextEncodingWindowsANSI = 0x0500, kTextEncodingWindowsLatin2 = 0x0501, kTextEncodingWindowsCyrillic = 0x0502, kTextEncodingWindowsGreek = 0x0503, kTextEncodingWindowsLatin5 = 0x0504, kTextEncodingWindowsHebrew = 0x0505, kTextEncodingWindowsArabic = 0x0506, kTextEncodingWindowsBalticRim = 0x0507, kTextEncodingWindowsVietnamese = 0x0508, kTextEncodingWindowsKoreanJohab = 0x0510 };

    Константы

    • kTextEncodingDOSLatinUS

      kTextEncodingDOSLatinUS

      Кодовая страница 437.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSGreek

      kTextEncodingDOSGreek

      Кодовая страница 737, раньше 437G.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSBalticRim

      kTextEncodingDOSBalticRim

      Кодовая страница 775.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSLatin1

      kTextEncodingDOSLatin1

      Кодовая страница 860. «многоязычный».

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSGreek1

      kTextEncodingDOSGreek1

      Кодовая страница 851.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSLatin2

      kTextEncodingDOSLatin2

      Кодовая страница 852, славянская.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSCyrillic

      kTextEncodingDOSCyrillic

      Кодовая страница 855, Кириллица IBM.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSTurkish

      kTextEncodingDOSTurkish

      Кодовая страница 857, турецкий язык IBM.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSPortuguese

      kTextEncodingDOSPortuguese

      Кодовая страница 860.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSIcelandic

      kTextEncodingDOSIcelandic

      Кодовая страница 861.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSHebrew

      kTextEncodingDOSHebrew

      Кодовая страница 862.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSCanadianFrench

      kTextEncodingDOSCanadianFrench

      Кодовая страница 863.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSArabic

      kTextEncodingDOSArabic

      Кодовая страница 864.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSNordic

      kTextEncodingDOSNordic

      Страница 865 Cde.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSRussian

      kTextEncodingDOSRussian

      Кодовая страница 866.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSGreek2

      kTextEncodingDOSGreek2

      Кодовая страница 869, IBM современный Зеленый.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSThai

      kTextEncodingDOSThai

      Кодовая страница 874, также для Windows.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSJapanese

      kTextEncodingDOSJapanese

      Кодовая страница 932, также для Windows

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSChineseSimplif

      kTextEncodingDOSChineseSimplif

      Кодовая страница 936, также для Windows.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSKorean

      kTextEncodingDOSKorean

      Кодовая страница 949, также для Windows; объединенный Хангул.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingDOSChineseTrad

      kTextEncodingDOSChineseTrad

      Кодовая страница 950, также для Windows.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsLatin1

      kTextEncodingWindowsLatin1

      Кодовая страница 1252.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsANSI

      kTextEncodingWindowsANSI

      Кодовая страница 1252 (альтернативное название).

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsLatin2

      kTextEncodingWindowsLatin2

      Кодовая страница 1250, Центральная Европа.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsCyrillic

      kTextEncodingWindowsCyrillic

      Кодовая страница 1251, славянская Кириллица.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsGreek

      kTextEncodingWindowsGreek

      Кодовая страница 1253.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsLatin5

      kTextEncodingWindowsLatin5

      Кодовая страница 1254, турецкий язык.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsHebrew

      kTextEncodingWindowsHebrew

      Кодовая страница 1255.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsArabic

      kTextEncodingWindowsArabic

      Кодовая страница 1256.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsBalticRim

      kTextEncodingWindowsBalticRim

      Кодовая страница 1257.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsVietnamese

      kTextEncodingWindowsVietnamese

      Кодовая страница 1258.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingWindowsKoreanJohab

      kTextEncodingWindowsKoreanJohab

      Кодовая страница 1361, для Окна NT.

      Доступный в OS X v10.0 и позже.

  • Укажите текстовые кодировки для различных национальных стандартов.

    Объявление

    Swift

    var kTextEncodingUS_ASCII: Int { get } var kTextEncodingJIS_X0201_76: Int { get } var kTextEncodingJIS_X0208_83: Int { get } var kTextEncodingJIS_X0208_90: Int { get } var kTextEncodingJIS_X0212_90: Int { get } var kTextEncodingJIS_C6226_78: Int { get } var kTextEncodingShiftJIS_X0213_00: Int { get } var kTextEncodingGB_2312_80: Int { get } var kTextEncodingGBK_95: Int { get } var kTextEncodingGB_18030_2000: Int { get } var kTextEncodingKSC_5601_87: Int { get } var kTextEncodingKSC_5601_92_Johab: Int { get } var kTextEncodingCNS_11643_92_P1: Int { get } var kTextEncodingCNS_11643_92_P2: Int { get } var kTextEncodingCNS_11643_92_P3: Int { get }

    Objective C

    enum { kTextEncodingUS_ASCII = 0x0600, kTextEncodingJIS_X0201_76 = 0x0620, kTextEncodingJIS_X0208_83 = 0x0621, kTextEncodingJIS_X0208_90 = 0x0622, kTextEncodingJIS_X0212_90 = 0x0623, kTextEncodingJIS_C6226_78 = 0x0624, kTextEncodingShiftJIS_X0213_00 = 0x0628, kTextEncodingGB_2312_80 = 0x0630, kTextEncodingGBK_95 = 0x0631, kTextEncodingGB_18030_2000 = 0x0632, kTextEncodingKSC_5601_87 = 0x0640, kTextEncodingKSC_5601_92_Johab = 0x0641, kTextEncodingCNS_11643_92_P1 = 0x0651, kTextEncodingCNS_11643_92_P2 = 0x0652, kTextEncodingCNS_11643_92_P3 = 0x0653 };

    Константы

    • kTextEncodingUS_ASCII

      kTextEncodingUS_ASCII

      Доступный в OS X v10.0 и позже.

    • kTextEncodingJIS_X0201_76

      kTextEncodingJIS_X0201_76

      Римлянин JIS и 1 байт katakana (полуширина).

      Доступный в OS X v10.0 и позже.

    • kTextEncodingJIS_X0208_83

      kTextEncodingJIS_X0208_83

      Доступный в OS X v10.0 и позже.

    • kTextEncodingJIS_X0208_90

      kTextEncodingJIS_X0208_90

      Доступный в OS X v10.0 и позже.

    • kTextEncodingJIS_X0212_90

      kTextEncodingJIS_X0212_90

      Доступный в OS X v10.0 и позже.

    • kTextEncodingJIS_C6226_78

      kTextEncodingJIS_C6226_78

      Доступный в OS X v10.0 и позже.

    • kTextEncodingShiftJIS_X0213_00

      kTextEncodingShiftJIS_X0213_00

      Кодирование формата Shift-JIS плоскостей JIS X0213 1 и 2

      Доступный в OS X v10.1 и позже.

    • kTextEncodingGB_2312_80

      kTextEncodingGB_2312_80

      Доступный в OS X v10.0 и позже.

    • kTextEncodingGBK_95

      kTextEncodingGBK_95

      Приложение к GB13000-93, для Windows 95; EUC-CN расширился.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingGB_18030_2000

      kTextEncodingGB_18030_2000

      Доступный в OS X v10.1 и позже.

    • kTextEncodingKSC_5601_87

      kTextEncodingKSC_5601_87

      Это совпадает с KSC 5601-92 без приложения Johab.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingKSC_5601_92_Johab

      kTextEncodingKSC_5601_92_Johab

      KSC 5601-92 приложения Johab.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingCNS_11643_92_P1

      kTextEncodingCNS_11643_92_P1

      CNS 11643-1992 плоскости 1.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingCNS_11643_92_P2

      kTextEncodingCNS_11643_92_P2

      CNS 11643-1992 плоскости 2.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingCNS_11643_92_P3

      kTextEncodingCNS_11643_92_P3

      CNS 11643-1992 плоскости 3 (11643-1986 плоскостей 14).

      Доступный в OS X v10.0 и позже.

  • Укажите текстовые кодировки для платформы NextStep.

    Объявление

    Objective C

    enum { kTextEncodingNextStepLatin = 0x0B01, kTextEncodingNextStepJapanese = 0x0B02 };

  • Укажите особые случаи текстовых кодировок.

    Объявление

    Swift

    var kTextEncodingMultiRun: Int { get } var kTextEncodingUnknown: Int { get }

    Objective C

    enum { kTextEncodingMultiRun = 0x0FFF, kTextEncodingUnknown = 0xFFFF };

    Константы

    • kTextEncodingMultiRun

      kTextEncodingMultiRun

      Это - специальное значение для многократного закодированного текста, внешней информации о выполнении.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingUnknown

      kTextEncodingUnknown

      Доступный в OS X v10.0 и позже.

  • Укажите формат кодировки текста.

    Объявление

    Swift

    typealias TextEncodingFormat = UInt32

    Objective C

    typedef UInt32 TextEncodingFormat; enum { kTextEncodingDefaultFormat = 0, kUnicode16BitFormat = 0, kUnicodeUTF7Format = 1, kUnicodeUTF8Format = 2, kUnicode32BitFormat = 3 };

    Константы

    • kTextEncodingDefaultFormat

      kTextEncodingDefaultFormat

      Стандартный формат по умолчанию для любого основного кодирования.

      Доступный в OS X v10.0 и позже.

    • kUnicode16BitFormat

      kUnicode16BitFormat

      16-разрядный формат кодировки символов, указанный стандартом Unicode, эквивалентным UCS 2, форматирует для ISO 10646. Это включает поддержку метода UTF-16 включения non-BMP символы в потоке 16-разрядных значений.

      Доступный в OS X v10.0 и позже.

    • kUnicodeUTF7Format

      kUnicodeUTF7Format

      Формат преобразования Unicode, в котором кодировки символов представлены последовательностью 7-разрядных значений. Этот формат не может быть обработан Преобразователем Unicode, только текстом, Кодирующим Преобразователь.

      Доступный в OS X v10.0 и позже.

    • kUnicodeUTF8Format

      kUnicodeUTF8Format

      Формат преобразования Unicode, в котором символы представлены последовательностью 8-разрядных значений.

      Доступный в OS X v10.0 и позже.

    • kUnicode32BitFormat

      kUnicode32BitFormat

      UCS 4 32-разрядный формат определяется для ISO 10646. Этот формат в настоящее время не поддерживается.

      Доступный в OS X v10.0 и позже.

    Обсуждение

    Формат кодировки текста указывает способ отформатировать или алгоритмически преобразовать определенное основное кодирование. Например, формат UTF-7 является стандартом Unicode, отформатированным для передачи через каналы, которые могут обработать только 7-разрядные значения. Другие форматы кодировки текста для Unicode включают UTF-8 и 16-разрядные или 32-разрядные форматы. Эти трансформации не просматриваются как различные основные кодировки. Скорее они - различные форматы для представления того же основного кодирования.

    Подобный тексту, кодирующему различные значения, значения формата кодировки текста являются определенными для определенного текста, кодирующего основное значение или для маленького набора текста, кодирующего основные значения. Формат кодировки текста определяется TextEncodingFormat тип данных.

    Функция GetTextEncodingFormat возвращает формат кодировки текста текста, кодирующего спецификацию.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.0 и позже.

  • Укажите часть имени кодирования, которое Вы хотите получить.

    Объявление

    Swift

    typealias TextEncodingNameSelector = UInt32

    Objective C

    typedef UInt32 TextEncodingNameSelector; enum { kTextEncodingFullName = 0, kTextEncodingBaseName = 1, kTextEncodingVariantName = 2, kTextEncodingFormatName = 3 };

    Константы

    • kTextEncodingFullName

      kTextEncodingFullName

      Запрашивает полное имя текстового кодирования.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingBaseName

      kTextEncodingBaseName

      Запрашивает имя основного кодирования.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingVariantName

      kTextEncodingVariantName

      Запрашивает имя варианта кодирования, при наличии.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingFormatName

      kTextEncodingFormatName

      Запрашивает имя формата кодирования, при наличии.

      Доступный в OS X v10.0 и позже.

    Обсуждение

    Вы используете селектор для GetTextEncodingName функция для указания, какую часть имени кодирования Вы хотите определить. Текст, кодирующий селектор имени, определяется TextEncodingNameSelector тип данных.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.0 и позже.

  • Укажите незначительные варианты основного кодирования или группу основных кодировок.

    Объявление

    Swift

    var kTextEncodingDefaultVariant: Int { get }

    Objective C

    enum { kTextEncodingDefaultVariant = 0 };

    Константы

    • kTextEncodingDefaultVariant

      kTextEncodingDefaultVariant

      Стандартный вариант по умолчанию для любого основного кодирования.

      Доступный в OS X v10.0 и позже.

    Обсуждение

    Это перечисление определяет константы для варианта по умолчанию любого кодирования основного текста и для вариантов японцев Mac OS, арабского Mac OS, фарси Mac OS, иврита Mac OS и кодировок основы Unicode.

    Текст, кодирующий вариант, указывает один возможно среди нескольких незначительных вариантов определенного основного кодирования или группы основных кодировок. Текст, кодирующий варианты, часто используется для поддержки особых случаев, таких как следующее:

    • Различия среди шрифтов, все предназначающихся для поддержки того же кодирования. Например, различные шрифты, связанные с кодировками Макджэпэнезе и Макарабика, поддерживают немного отличающиеся варианты кодирования. Эти шрифты обычно сосуществовали бы в той же системе без пользователя, являющегося знающим о любых различиях.

    • Искусственные варианты, создаваемые исключением некоторых символов в кодировании. Например, Макджэпэнезе, кодирующий, включает отдельно закодированные вертикальные формы для некоторых символов. В некоторых контекстах (такой как с QuickDraw GX), может быть желательно исключить их.

    • Различные отображения определенного символа или группа символов для различных использований.

    Для данного текста, кодирующего основной или маленький набор связанного текста, кодирующего основные значения, может быть перечисление TextEncodingVariant значения, который всегда начинается 0, вариант по умолчанию. Кроме того, для возможно большего набора связанного текста, кодирующего основные значения, могут быть битовые маски, которые могут использоваться независимо для обозначения дополнительных искусственных вариантов. Например, существует перечисление шести вариантов для японского кодирования Mac OS. Кроме того, существуют битовые маски, которые могут также использоваться в качестве части варианта для любого японского кодирования, чтобы исключить 1-байтовую кану или управлять отображением обратного солидуса (наклонная черта влево) символ.

    Языки, которые являются несходными, но используют подобные наборы символов, обычно не определяются как варианты того же кодирования основы (например, Макиселэндик и Мактеркиш оба используют небольшую модификацию набора символов Макрочеловека, но их считают отдельными основными кодировками).

    При создании нового текстового кодирования можно указать явный вариант основного кодирования, или можно указать вариант по умолчанию той основы. Текст, кодирующий вариант, определяется TextEncodingVariant тип данных. Функция GetTextEncodingVariant возвращает текст, кодирующий вариант текста, кодирующего спецификацию.

  • Укажите Unicode и IOS текстовые кодировки UCS.

    Объявление

    Swift

    var kTextEncodingUnicodeDefault: Int { get } var kTextEncodingUnicodeV1_1: Int { get } var kTextEncodingISO10646_1993: Int { get } var kTextEncodingUnicodeV2_0: Int { get } var kTextEncodingUnicodeV2_1: Int { get } var kTextEncodingUnicodeV3_0: Int { get } var kTextEncodingUnicodeV3_1: Int { get } var kTextEncodingUnicodeV3_2: Int { get }

    Objective C

    enum { kTextEncodingUnicodeDefault = 0x0100, kTextEncodingUnicodeV1_1 = 0x0101, kTextEncodingISO10646_1993 = 0x0101, kTextEncodingUnicodeV2_0 = 0x0103, kTextEncodingUnicodeV2_1 = 0x0103, kTextEncodingUnicodeV3_0 = 0x0104, kTextEncodingUnicodeV3_1 = 0x0105, kTextEncodingUnicodeV3_2 = 0x0106 };

    Константы

    • kTextEncodingUnicodeDefault

      kTextEncodingUnicodeDefault

      Это - значение meta, берущее одно из следующих значений, в зависимости от системы.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingUnicodeV1_1

      kTextEncodingUnicodeV1_1

      Это - кодирование Unicode.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingISO10646_1993

      kTextEncodingISO10646_1993

      Этот ISO кодирование UCS имеет кодовые точки, идентичные Unicode 1.1.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingUnicodeV2_0

      kTextEncodingUnicodeV2_0

      Это - новое расположение для корейского Хангула.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingUnicodeV2_1

      kTextEncodingUnicodeV2_1

      Для текста, Кодирующего Преобразователь, Unicode 2.0 эквивалентен Unicode 2.1.

      Доступный в OS X v10.0 и позже.

    • kTextEncodingUnicodeV3_0

      kTextEncodingUnicodeV3_0

      Доступный в OS X v10.0 и позже.

    • kTextEncodingUnicodeV3_1

      kTextEncodingUnicodeV3_1

      Добавляют символы, требующие суррогатных пар в UTF-16

      Доступный в OS X v10.1 и позже.

    • kTextEncodingUnicodeV3_2

      kTextEncodingUnicodeV3_2

      Доступный в OS X v10.1 и позже.

  • Представляйте варианты Unicode, еще не поддерживающиеся или полностью определяющиеся.

    Объявление

    Objective C

    enum { kUnicodeNoCompatibilityVariant = 1, kUnicodeNoCorporateVariant = 4 };

Различные константы

  • Укажите двунаправленные символьные свойства.

    Объявление

    Swift

    var kUCBidiCatNotApplicable: Int { get } var kUCBidiCatLeftRight: Int { get } var kUCBidiCatRightLeft: Int { get } var kUCBidiCatEuroNumber: Int { get } var kUCBidiCatEuroNumberSeparator: Int { get } var kUCBidiCatEuroNumberTerminator: Int { get } var kUCBidiCatArabicNumber: Int { get } var kUCBidiCatCommonNumberSeparator: Int { get } var kUCBidiCatBlockSeparator: Int { get } var kUCBidiCatSegmentSeparator: Int { get } var kUCBidiCatWhitespace: Int { get } var kUCBidiCatOtherNeutral: Int { get } var kUCBidiCatRightLeftArabic: Int { get } var kUCBidiCatLeftRightEmbedding: Int { get } var kUCBidiCatRightLeftEmbedding: Int { get } var kUCBidiCatLeftRightOverride: Int { get } var kUCBidiCatRightLeftOverride: Int { get } var kUCBidiCatPopDirectionalFormat: Int { get } var kUCBidiCatNonSpacingMark: Int { get } var kUCBidiCatBoundaryNeutral: Int { get }

    Objective C

    enum { kUCBidiCatNotApplicable = 0, kUCBidiCatLeftRight = 1, kUCBidiCatRightLeft = 2, kUCBidiCatEuroNumber = 3, kUCBidiCatEuroNumberSeparator = 4, kUCBidiCatEuroNumberTerminator = 5, kUCBidiCatArabicNumber = 6, kUCBidiCatCommonNumberSeparator = 7, kUCBidiCatBlockSeparator = 8, kUCBidiCatSegmentSeparator = 9, kUCBidiCatWhitespace = 10, kUCBidiCatOtherNeutral = 11, kUCBidiCatRightLeftArabic = 12, kUCBidiCatLeftRightEmbedding = 13, kUCBidiCatRightLeftEmbedding = 14, kUCBidiCatLeftRightOverride = 15, kUCBidiCatRightLeftOverride = 16, kUCBidiCatPopDirectionalFormat = 17, kUCBidiCatNonSpacingMark = 18, kUCBidiCatBoundaryNeutral = 19 };

    Константы

    • kUCBidiCatNotApplicable

      kUCBidiCatNotApplicable

      Неприсвоенный.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatLeftRight

      kUCBidiCatLeftRight

      Сильные типы: L слева направо.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatRightLeft

      kUCBidiCatRightLeft

      Сильные типы: R справа налево.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatEuroNumber

      kUCBidiCatEuroNumber

      Слабые типы: число EN European.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatEuroNumberSeparator

      kUCBidiCatEuroNumberSeparator

      Слабые типы: европейский разделитель числа ES.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatEuroNumberTerminator

      kUCBidiCatEuroNumberTerminator

      Слабые типы: европейский разделитель числа ET.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatArabicNumber

      kUCBidiCatArabicNumber

      Слабые типы: арабская цифра AN.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatCommonNumberSeparator

      kUCBidiCatCommonNumberSeparator

      Слабые типы: CS общий разделитель числа.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatBlockSeparator

      kUCBidiCatBlockSeparator

      Разделители: B разделитель абзацев (был блочный разделитель).

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatSegmentSeparator

      kUCBidiCatSegmentSeparator

      Разделители: разделитель сегмента S.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatWhitespace

      kUCBidiCatWhitespace

      Neutrals: пробел WS.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatOtherNeutral

      kUCBidiCatOtherNeutral

      Neutrals: ON другой neutrals (неприсвоенные коды могли использовать это).

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatRightLeftArabic

      kUCBidiCatRightLeftArabic

      Unicode 3.0; AL справа налево арабский язык (была арабская буква).

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatLeftRightEmbedding

      kUCBidiCatLeftRightEmbedding

      Unicode 3.0; встраивание тритона к праву LRE.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatRightLeftEmbedding

      kUCBidiCatRightLeftEmbedding

      Unicode 3.0; RLE, справа налево встраивающий.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatLeftRightOverride

      kUCBidiCatLeftRightOverride

      Unicode 3.0; LRO слева направо переопределяют.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatRightLeftOverride

      kUCBidiCatRightLeftOverride

      Unicode 3.0; RLO справа налево переопределяет.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatPopDirectionalFormat

      kUCBidiCatPopDirectionalFormat

      Unicode 3.0; PDF выталкивает направленный Формат.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatNonSpacingMark

      kUCBidiCatNonSpacingMark

      Unicode 3.0; NSM метка без интервалов.

      Доступный в OS X v10.0 и позже.

    • kUCBidiCatBoundaryNeutral

      kUCBidiCatBoundaryNeutral

      Unicode 3.0; нейтральная граница BN.

      Доступный в OS X v10.0 и позже.

    Обсуждение

    Этими значениями требуют kUCCharPropTypeBidiCategory.

  • Укажите sommon и специальные значения кодов Unicode.

    Объявление

    Swift

    var kUnicodeByteOrderMark: Int { get } var kUnicodeObjectReplacement: Int { get } var kUnicodeReplacementChar: Int { get } var kUnicodeSwappedByteOrderMark: Int { get } var kUnicodeNotAChar: Int { get }

    Objective C

    enum { kUnicodeByteOrderMark = 0xFEFF, kUnicodeObjectReplacement = 0xFFFC, kUnicodeReplacementChar = 0xFFFD, kUnicodeSwappedByteOrderMark = 0xFFFE, kUnicodeNotAChar = 0xFFFF };

    Константы

    • kUnicodeByteOrderMark

      kUnicodeByteOrderMark

      Доступный в OS X v10.0 и позже.

    • kUnicodeObjectReplacement

      kUnicodeObjectReplacement

      Заполнитель для нетекстового объекта.

      Доступный в OS X v10.0 и позже.

    • kUnicodeReplacementChar

      kUnicodeReplacementChar

      Замена Unicode для вводимого символа, который не может быть преобразован.

      Доступный в OS X v10.0 и позже.

    • kUnicodeSwappedByteOrderMark

      kUnicodeSwappedByteOrderMark

      Не символ Unicode; подкачанная байтом версия FEFF.

      Доступный в OS X v10.0 и позже.

    • kUnicodeNotAChar

      kUnicodeNotAChar

      Не символ Unicode; может использоваться в качестве разделителя.

      Доступный в OS X v10.0 и позже.

  • Укажите версию для таблицы отгрузки плагина TEC.

    Объявление

    Swift

    var kTECPluginDispatchTableVersion1: Int { get } var kTECPluginDispatchTableVersion1_1: Int { get } var kTECPluginDispatchTableVersion1_2: Int { get } var kTECPluginDispatchTableCurrentVersion: Int { get }

    Objective C

    enum { kTECPluginDispatchTableVersion1 = 0x00010000, kTECPluginDispatchTableVersion1_1 = 0x00010001, kTECPluginDispatchTableVersion1_2 = 0x00010002, kTECPluginDispatchTableCurrentVersion = kTECPluginDispatchTableVersion1_2 };

    Константы

    • kTECPluginDispatchTableVersion1

      kTECPluginDispatchTableVersion1

      Указывает версии 1.0 до 1.0.3.

      Доступный в OS X v10.0 и позже.

    • kTECPluginDispatchTableVersion1_1

      kTECPluginDispatchTableVersion1_1

      Указывает версию 1.1.

      Доступный в OS X v10.0 и позже.

    • kTECPluginDispatchTableVersion1_2

      kTECPluginDispatchTableVersion1_2

      Указывает версию 1.2.

      Доступный в OS X v10.0 и позже.

    • kTECPluginDispatchTableCurrentVersion

      kTECPluginDispatchTableCurrentVersion

      Значение meta, указывающее текущую версию.

      Доступный в OS X v10.0 и позже.

  • Укажите подпись плагина TEC.

    Объявление

    Objective C

    enum { kTECSignature = 'encv', kTECUnicodePluginSignature = 'puni', kTECJapanesePluginSignature = 'pjpn', kTECChinesePluginSignature = 'pzho', kTECKoreanPluginSignature = 'pkor' };

  • Укажите типы свойства для Unicode charater.

    Объявление

    Swift

    typealias UCCharPropertyType = Int32

    Objective C

    typedef SInt32 UCCharPropertyType; enum { kUCCharPropTypeGenlCategory = 1, kUCCharPropTypeCombiningClass = 2, kUCCharPropTypeBidiCategory = 3 };

    Константы

    • kUCCharPropTypeGenlCategory

      kUCCharPropTypeGenlCategory

      Перечислимая величина запросов.

      Доступный в OS X v10.0 и позже.

    • kUCCharPropTypeCombiningClass

      kUCCharPropTypeCombiningClass

      Числовое значение запросов от 0 до 255.

      Доступный в OS X v10.0 и позже.

    • kUCCharPropTypeBidiCategory

      kUCCharPropTypeBidiCategory

      Перечислимая величина запросов.

      Доступный в OS X v10.0 и позже.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.0 и позже.

  • Укажите значение propery для символа Unicode.

    Объявление

    Swift

    typealias UCCharPropertyValue = UInt32

    Objective C

    typedef UInt32 UCCharPropertyValue; enum { kUCGenlCatOtherNotAssigned = 0, kUCGenlCatOtherControl = 1, kUCGenlCatOtherFormat = 2, kUCGenlCatOtherSurrogate = 3, kUCGenlCatOtherPrivateUse = 4, kUCGenlCatMarkNonSpacing = 5, kUCGenlCatMarkSpacingCombining = 6, kUCGenlCatMarkEnclosing = 7, kUCGenlCatNumberDecimalDigit = 8, kUCGenlCatNumberLetter = 9, kUCGenlCatNumberOther = 10, kUCGenlCatSeparatorSpace = 11, kUCGenlCatSeparatorLine = 12, kUCGenlCatSeparatorParagraph = 13, kUCGenlCatLetterUppercase = 14, kUCGenlCatLetterLowercase = 15, kUCGenlCatLetterTitlecase = 16, kUCGenlCatLetterModifier = 17, kUCGenlCatLetterOther = 18, kUCGenlCatPunctConnector = 20, kUCGenlCatPunctDash = 21, kUCGenlCatPunctOpen = 22, kUCGenlCatPunctClose = 23, kUCGenlCatPunctInitialQuote = 24, kUCGenlCatPunctFinalQuote = 25, kUCGenlCatPunctOther = 26, kUCGenlCatSymbolMath = 28, kUCGenlCatSymbolCurrency = 29, kUCGenlCatSymbolModifier = 30, kUCGenlCatSymbolOther = 31 };

    Константы

    • kUCGenlCatOtherNotAssigned

      kUCGenlCatOtherNotAssigned

      Cn другой; не присвоенный.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatOtherControl

      kUCGenlCatOtherControl

      Cc другой; управление.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatOtherFormat

      kUCGenlCatOtherFormat

      Cf другой; формат.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatOtherSurrogate

      kUCGenlCatOtherSurrogate

      Cs другой; заместитель.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatOtherPrivateUse

      kUCGenlCatOtherPrivateUse

      Ко другой; личное пользование.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatMarkNonSpacing

      kUCGenlCatMarkNonSpacing

      Метка Mn; без интервалов.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatMarkSpacingCombining

      kUCGenlCatMarkSpacingCombining

      Метка мГц; интервал объединения.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatMarkEnclosing

      kUCGenlCatMarkEnclosing

      Я метка; включение.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatNumberDecimalDigit

      kUCGenlCatNumberDecimalDigit

      Без обозначения даты число; десятичная цифра.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatNumberLetter

      kUCGenlCatNumberLetter

      Номер Nl; буква.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatNumberOther

      kUCGenlCatNumberOther

      Никакое число;прочее.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSeparatorSpace

      kUCGenlCatSeparatorSpace

      Разделитель Zs; пространство.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSeparatorLine

      kUCGenlCatSeparatorLine

      Разделитель Zl; Строка.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSeparatorParagraph

      kUCGenlCatSeparatorParagraph

      Разделитель Zp; абзац.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatLetterUppercase

      kUCGenlCatLetterUppercase

      Буква лютеция; верхний регистр.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatLetterLowercase

      kUCGenlCatLetterLowercase

      Буква Ll; нижний регистр.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatLetterTitlecase

      kUCGenlCatLetterTitlecase

      Лейтенант Леттер; titlecase.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatLetterModifier

      kUCGenlCatLetterModifier

      Буква Lm; модификатор.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatLetterOther

      kUCGenlCatLetterOther

      Ло Леттер;прочее.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctConnector

      kUCGenlCatPunctConnector

      Пунктуация PC; коннектор.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctDash

      kUCGenlCatPunctDash

      Пунктуация фунта; тире.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctOpen

      kUCGenlCatPunctOpen

      Пунктуация ps; открытый.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctClose

      kUCGenlCatPunctClose

      Пунктуация Pe; близко.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctInitialQuote

      kUCGenlCatPunctInitialQuote

      Пунктуация пи; начальная кавычка.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctFinalQuote

      kUCGenlCatPunctFinalQuote

      Пунктуация Pf; заключительная кавычка.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatPunctOther

      kUCGenlCatPunctOther

      Пунктуация По;прочее.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSymbolMath

      kUCGenlCatSymbolMath

      Символ см; математика.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSymbolCurrency

      kUCGenlCatSymbolCurrency

      Символ кв/см; валюта.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSymbolModifier

      kUCGenlCatSymbolModifier

      Символ Sk; модификатор.

      Доступный в OS X v10.0 и позже.

    • kUCGenlCatSymbolOther

      kUCGenlCatSymbolOther

      Так символ;прочее.

      Доступный в OS X v10.0 и позже.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.0 и позже.

  • Укажите версию отображения Unicode.

    Объявление

    Swift

    typealias UnicodeMapVersion = Int32

    Objective C

    typedef SInt32 UnicodeMapVersion; enum { kUnicodeUseLatestMapping = -1, kUnicodeUseHFSPlusMapping = 4 };

    Константы

    • kUnicodeUseLatestMapping

      kUnicodeUseLatestMapping

      Вместо того, чтобы явно указать отображающуюся версию таблицы отображения Unicode, которая будет использоваться для преобразования текстовой строки, можно использовать эту константу, чтобы указать что последняя версия использоваться.

      Доступный в OS X v10.0 и позже.

    • kUnicodeUseHFSPlusMapping

      kUnicodeUseHFSPlusMapping

      Указывает отображающуюся версию, используемую HFS Плюс преобразовать имена файлов между кодировками Mac OS и Unicode. Только один постоянный определяется до сих пор для определенной версии отображения.

      Доступный в OS X v10.0 и позже.

    Обсуждение

    При выполнении преобразований Вы указываете версию таблицы отображения Unicode, которая будет использоваться для преобразования. Вы обеспечиваете номер версии в отображающемся поле версии структуры UnicodeMapping это передается функции. Версия отображения Unicode определяется UnicodeMapVersion тип данных.

    Оператор импорта

    Objective C

    @import CoreServices;

    Swift

    import CoreServices

    Доступность

    Доступный в OS X v10.0 и позже.

  • Укажите данные, о которых Вы не заботитесь о получении.

    Объявление

    Swift

    var kTextScriptDontCare: Int { get } var kTextLanguageDontCare: Int { get } var kTextRegionDontCare: Int { get }

    Objective C

    enum { kTextScriptDontCare = -128, kTextLanguageDontCare = -128, kTextRegionDontCare = -128 };

    Константы

    • kTextScriptDontCare

      kTextScriptDontCare

      Указывает, что код не предоставлен для деривации.

      Доступный в OS X v10.0 и позже.

    • kTextLanguageDontCare

      kTextLanguageDontCare

      Указывает, что код языка не предоставлен для деривации.

      Доступный в OS X v10.0 и позже.

    • kTextRegionDontCare

      kTextRegionDontCare

      Код области не предоставлен для деривации.

      Доступный в OS X v10.0 и позже.

    Обсуждение

    Для обратной совместимости с более ранними выпусками Mac OS текст, Кодирующий менеджера по Преобразованию, обеспечивает функции UpgradeScriptInfoToTextEncoding и RevertTextEncodingToScriptInfo то, что можно использовать для получения менеджера по Сценарию значения на текстовое кодирование или наоборот.

    При использовании этих функций можно указать менеджера по Сценарию код языка, код сценария и/или значения шрифта для получения текстового кодирования. Эти три константы определяются, чтобы позволить Вам идентифицировать любую часть деривации, о которой Вы не заботитесь. При возвращении от текстового кодирования до менеджера по Сценарию значений Преобразователь Unicode возвращает эти константы для соответствующего значения, которое он не получает: kTextLanguageDontCare, kTextScriptDontCare, и kTextRegionDontCare.

Коды результата

Наиболее распространенные коды результата, возвращенные текстом, Кодирующим менеджера по Преобразованию, упоминаются ниже.

  • Кодирование или отображение не поддерживаются для этой функции текущим набором таблиц или плагинов.

    Значение

    - 8738

    Описание

    Кодирование или отображение не поддерживаются для этой функции текущим набором таблиц или плагинов.

    Доступный в OS X v10.0 и позже.

  • Ввод текста содержит последовательность, которая не законна в указанном кодировании, такова как DBCS высокий байт, сопровождаемый недопустимым младшим байтом (Shift-JIS на 0x8120 дюймов).

    Значение

    - 8739

    Описание

    Ввод текста содержит последовательность, которая не законна в указанном кодировании, такова как DBCS высокий байт, сопровождаемый недопустимым младшим байтом (Shift-JIS на 0x8120 дюймов).

    Доступный в OS X v10.0 и позже.

  • Ввод текста содержит кодовую точку, которая не определена в указанном кодировании. Функция не полностью преобразовывала входную строку. Можно возобновить преобразование из точки вне незаконного символа или принять некоторые другие меры.

    Значение

    - 8740

    Описание

    Ввод текста содержит кодовую точку, которая не определена в указанном кодировании. Функция не полностью преобразовывала входную строку. Можно возобновить преобразование из точки вне незаконного символа или принять некоторые другие меры.

    Доступный в OS X v10.0 и позже.

  • Указанное кодирование частично поддерживается, но отсутствует определенная таблица, требуемая для этой функции.

    Значение

    - 8745

    Описание

    Указанное кодирование частично поддерживается, но отсутствует определенная таблица, требуемая для этой функции.

    Доступный в OS X v10.0 и позже.

  • Определенная таблица, требуемая для этой функции, имеет ошибку контрольной суммы, указывая, что это стало поврежденным.

    Значение

    - 8746

    Описание

    Определенная таблица, требуемая для этой функции, имеет ошибку контрольной суммы, указывая, что это стало поврежденным.

    Доступный в OS X v10.0 и позже.

  • Формат таблицы или недопустим, или он не может быть обработан текущей версией кода. Функция не преобразовывала строку

    Значение

    - 8747

    Описание

    Формат таблицы или недопустим, или он не может быть обработан текущей версией кода. Функция не преобразовывала строку

    Доступный в OS X v10.0 и позже.

  • Объект преобразователя недопустим. Возвращенный текстом, Кодирующим Преобразователь, функционирует только.

    Значение

    - 8748

    Описание

    Объект преобразователя недопустим. Возвращенный текстом, Кодирующим Преобразователь, функционирует только.

    Доступный в OS X v10.0 и позже.

  • Преобразователь поддерживает обоих входные и выходные кодировки, но не может преобразовать между ними ни одного прямо или косвенно. Возвращенный текстом, Кодирующим Преобразователь, функционирует только.

    Значение

    - 8749

    Описание

    Преобразователь поддерживает обоих входные и выходные кодировки, но не может преобразовать между ними ни одного прямо или косвенно. Возвращенный текстом, Кодирующим Преобразователь, функционирует только.

    Доступный в OS X v10.0 и позже.

  • Буфер синтезируемого текста является слишком маленьким для размещения результата обработки первого входного текстового элемента. Никакая часть входной строки не была обработана.

    Значение

    - 8750

    Описание

    Буфер синтезируемого текста является слишком маленьким для размещения результата обработки первого входного текстового элемента. Никакая часть входной строки не была обработана.

    Доступный в OS X v10.0 и позже.

  • Значение

    - 8751

    Описание

    Предоставленный TextEncodingRun, ScriptCodeRun или массив UnicodeMapping являются слишком небольшими, и ввод не был полностью преобразован. Вызовите функцию снова с другим буфером вывода — или с тем же буфером вывода после копирования его содержания — для преобразования остатка от строки

    Доступный в OS X v10.0 и позже.

  • Входные текстовые концы посреди многобайтового символа и преобразования остановились. Добавьте непреобразованный ввод от этого вызова до начала последующего входного текста и вызовите функцию снова.

    Значение

    - 8753

    Описание

    Входные текстовые концы посреди многобайтового символа и преобразования остановились. Добавьте непреобразованный ввод от этого вызова до начала последующего входного текста и вызовите функцию снова.

    Доступный в OS X v10.0 и позже.

  • Входной текстовый элемент не может быть отображен на указанном выходном кодировании (и) с помощью указанных опций. Для Преобразователя Unicode может произойти эта ошибка, только если не установлен флаг управления kUnicodeUseFallbacksBit.

    Значение

    - 8754

    Описание

    Входной текстовый элемент не может быть отображен на указанном выходном кодировании (и) с помощью указанных опций. Для Преобразователя Unicode может произойти эта ошибка, только если не установлен флаг управления kUnicodeUseFallbacksBit.

    Доступный в OS X v10.0 и позже.

  • Входной текст заканчивается текстовым элементом, который мог бы быть неполным, или содержит текстовый элемент, который является слишком длинным для внутренних буферов.

    Значение

    - 8755

    Описание

    Входной текст заканчивается текстовым элементом, который мог бы быть неполным, или содержит текстовый элемент, который является слишком длинным для внутренних буферов.

    Доступный в OS X v10.0 и позже.

  • Ошибка, такая как переполнение стека направления, произошла в обработке направленности.

    Значение

    - 8756

    Описание

    Ошибка, такая как переполнение стека направления, произошла в обработке направленности.

    Доступный в OS X v10.0 и позже.

  • Глобальные переменные были уже освобождены, преждевременное завершение. Функция не преобразовывала строку.

    Значение

    - 8770

    Описание

    Глобальные переменные были уже освобождены, преждевременное завершение. Функция не преобразовывала строку.

    Доступный в OS X v10.0 и позже.

  • Элемент (например, имя) не доступен для указанной области (и кодирование, при необходимости).

    Значение

    - 8771

    Описание

    Элемент (например, имя) не доступен для указанной области (и кодирование, при необходимости).

    Доступный в OS X v10.0 и позже.

  • Функция полностью преобразовала входную строку в указанную цель с помощью одной или более нейтрализаций. Для Преобразователя Unicode этот код состояния может только произойти если kUnicodeUseFallbacksBit флаг управления установлен.

    Значение

    - 8783

    Описание

    Функция полностью преобразовала входную строку в указанную цель с помощью одной или более нейтрализаций. Для Преобразователя Unicode этот код состояния может только произойти если kUnicodeUseFallbacksBit флаг управления установлен.

    Доступный в OS X v10.0 и позже.

  • Приложение избавилось от объекта преобразователя путем вызова TECDisposeConverter, но существует все еще текст, содержавшийся во внутренних буферах. Возвращенный текстом, Кодирующим Преобразователь, функционирует только.

    Значение

    - 8784

    Описание

    Приложение избавилось от объекта преобразователя путем вызова TECDisposeConverter, но существует все еще текст, содержавшийся во внутренних буферах. Возвращенный текстом, Кодирующим Преобразователь, функционирует только.

    Доступный в OS X v10.0 и позже.

  • Преобразователь успешно преобразовал часть входного текста, но буфер вывода не был достаточно большим для размещения всего входного текста после преобразования. Преобразуйте оставшийся текст, начинающийся с позиции, где остановилось преобразование.

    Значение

    - 8785

    Описание

    Преобразователь успешно преобразовал часть входного текста, но буфер вывода не был достаточно большим для размещения всего входного текста после преобразования. Преобразуйте оставшийся текст, начинающийся с позиции, где остановилось преобразование.

    Доступный в OS X v10.0 и позже.