Текст, кодирующий менеджера по преобразованию ссылка
Менеджер Text Encoding Conversion (TEC) предоставляет две услуги — текст, Кодирующий Преобразователь и Преобразователь Unicode — который Ваше приложение может использовать для обработки текста, кодирующего преобразование на Mac OS. Вы найдете текст, Кодирующий менеджера по Преобразованию полезный при разработке Интернет-приложений, таких как веб-браузеры или почтовые программы, приложения, передающие текст через различные платформы или приложения, базируемые в Unicode.
-
Создает и возвращает текст, кодирующий спецификацию.
Объявление
Swift
func CreateTextEncoding(_
encodingBase
: TextEncodingBase, _encodingVariant
: TextEncodingVariant, _encodingFormat
: TextEncodingFormat) -> TextEncodingObjective C
TextEncoding CreateTextEncoding ( TextEncodingBase encodingBase, TextEncodingVariant encodingVariant, TextEncodingFormat encodingFormat );
Параметры
encodingBase
Кодирование основного текста.
encodingVariant
Вариант кодирования основного текста. Указать вариант по умолчанию для кодирования основы, поданного
encodingBase
параметр, можно использоватьkTextEncodingDefaultVariant
постоянный.encodingFormat
Формат для кодирования основного текста. Для указания формата по умолчанию для основного кодирования можно использовать
kTextEncodingDefaultFormat
постоянный. Если Вы хотите получить aTextEncoding
оцените это ссылки UTF-16 или UTF-8, передачаkUnicode16BitFormat
илиkUnicodeUTF8Format
.Возвращаемое значение
Текст, кодирующий спецификацию, которую функция создает из значений, Вы передаете его.
Обсуждение
При создании текста, кодирующего спецификацию три значения, которые Вы указываете, упаковываются в целое без знака, которое можно тогда передать значением функциям тот текст использования кодировки. Посмотрите тип данных
TextEncodingRun
.Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает основное кодирование указанного текстового кодирования.
Объявление
Swift
func GetTextEncodingBase(_
encoding
: TextEncoding) -> TextEncodingBaseObjective C
TextEncodingBase GetTextEncodingBase ( TextEncoding encoding );
Параметры
encoding
Текст, кодирующий спецификацию, основа которой, кодирующая Вас, хочет получить.
Возвращаемое значение
Часть кодирования основы указанного текстового кодирования.
Обсуждение
Посмотрите тип данных
TextEncodingRun
Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает значение формата указанного текстового кодирования.
Объявление
Swift
func GetTextEncodingFormat(_
encoding
: TextEncoding) -> TextEncodingFormatObjective 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) -> OSStatusObjective 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) -> TextEncodingVariantObjective C
TextEncodingVariant GetTextEncodingVariant ( TextEncoding encoding );
Параметры
encoding
Текст, кодирующий спецификацию.
Возвращаемое значение
Текст, кодирующий различную часть указанного текстового кодирования.
Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает текст, кодирующий спецификацию, в которой любые метазначения были разрешены к действительным значениям. В настоящее время это влияет только на значения кодирования основы, упакованные в текст, кодирующий спецификацию.
Объявление
Swift
func ResolveDefaultTextEncoding(_
encoding
: TextEncoding) -> TextEncodingObjective 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>) -> OSStatusObjective C
OSStatus RevertTextEncodingToScriptInfo ( TextEncoding iEncoding, ScriptCode *oTextScriptID, LangCode *oTextLanguageID, Str255 oTextFontname );
Параметры
iEncoding
Текст, кодирующий спецификацию, которая будет преобразована.
oTextScriptID
Указатель на значение типа
ScriptCode
. По возврату, код сценария Mac OS, соответствующий тексту, кодирующему спецификацию, которую Вы идентифицировали вiEncoding
параметр. Если Вы не передаете указатель для этого параметра, функция возвращает aparamErr
код результата.oTextLanguageID
Указатель на значение типа
LangCode
. На вводе, если Вы не хотите, чтобы функция возвратила код языка, указываютNULL
как значение этого параметра. По возврату, надлежащему коду языка, если язык может быть однозначно получен на основании текста, кодирующего спецификацию, например, японский язык, и Вы не устанавливали параметр наNULL
.Если Вы не указываете
NULL
на вводе и языке неоднозначно — т.е. функция не может точно получить его на основании текста, кодирующего спецификацию — функция возвращает значениеkTextLanguageDontCare
.oTextFontname
Строка Паскаля. На вводе, если Вы не хотите, чтобы функция возвратила имя шрифта, указывают
NULL
как значение этого параметра. По возврату, имени надлежащего шрифта, если шрифт может быть однозначно получен на основании текста, кодирующего спецификацию, например, Символ, и Вы не устанавливали параметр наNULL
.Если Вы не указываете
NULL
на вводе и шрифте неоднозначно — т.е. функция не может точно получить его на основании текста, кодирующего спецификацию — функция возвращает строку нулевой длины.Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Функциональные возвраты
paramErr
если текст, кодирующий входное значение параметра спецификации, недопустим. Функция возвращает akTECTableFormatErr
закончитесь код, если внутренние таблицы отображения, используемые для перевода, недопустимы. Для списка других возможных кодов результата см. «Типы данных».Обсуждение
Если у Вас есть приложения, использующие менеджера по Сценарию 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>) -> OSStatusObjective C
OSStatus UpgradeScriptInfoToTextEncoding ( ScriptCode iTextScriptID, LangCode iTextLanguageID, RegionCode iRegionID, ConstStr255Param iTextFontname, TextEncoding *oEncoding );
Параметры
iTextScriptID
Допустимый менеджер по Сценарию код сценария. Менеджер по Сценарию Mac OS определяет константы для кодов сценария с помощью этого формата:
sm
Xxx. Для обозначения системного сценария укажите метазначениеsmSystemScript
. Называть текущий сценарий на основе шрифта указанным в графическом порту (grafPort
), укажите метазначениеsmCurrentScript
. Чтобы указать, что Вы не хотите обеспечивать код сценария для этого параметра, укажите константуkTextScriptDontCare
.iTextLanguageID
Допустимый менеджер по Сценарию код языка. Менеджер по Сценарию Mac OS определяет константы для кодов языка с помощью этого формата:
lang
Xxx. Чтобы указать, что Вы не хотите обеспечивать код языка для этого параметра, укажите константуkTextLanguageDontCare
.iRegionID
Допустимый менеджер по Сценарию код области. Менеджер по Сценарию Mac OS определяет константы для кодов области с помощью этого формата:
ver
Xxx. Чтобы указать, что Вы не хотите обеспечивать код области для этого параметра, укажите константуkTextRegionDontCare
.iTextFontname
Имя шрифта связалось с определенным текстом, кодирующим спецификацию, такую как Символ или Zapf Dingbats или имя любого шрифта, в настоящее время устанавливающегося в системе. Чтобы указать, что Вы не хотите обеспечивать имя шрифта, укажите значение
NULL
.oEncoding
Указатель на значение типа
TextEncoding
. По возврату это значение содержит текст, кодирующий спецификацию, которую функция создала из других значений, которые Вы обеспечили.Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Эта функция возвраты
paramErr
если два или больше из входного конфликта значений параметров в некотором роде — например, код языка Mac OS не принадлежит сценарию, код сценария которого Вы указали, или если входные значения параметров недопустимы. Функция возвращает akTECTableFormatErr
закончитесь код, если внутренние таблицы отображения, используемые для перевода, недопустимы.Обсуждение
UpgradeScriptInfoToTextEncoding
функция позволяет Вам получать текст, кодирующий спецификацию от кодов сценария, кодов языка, кодов области и имен шрифтов. Взаимно-однозначное соответствие существует между многими кодами сценария менеджера по Сценарию и определенным текстом Mac OS, кодирующим основное значение. Однако, потому что текстовые кодировки являются надмножеством кодов сценария, некоторыми комбинациями кода сценария, кода языка, кода области, и имя шрифта могло бы привести к различному тексту, кодирующему основное значение, чем имел бы место, если бы перевод основывался на одном только коде сценария.Когда Вы вызываете
UpgradeScriptInfoToTextEncoding
функция, можно указать любую комбинацию ее параметров, но необходимо указать по крайней мере один.Если Вы не указываете явное значение для сценария, языка или параметра кода области, необходимо передать, «не заботятся» постоянный надлежащий тому параметру. Если Вы не указываете явное значение для
iTextFontName
, необходимо передатьNULL
.UpgradeScriptInfoToTextEncoding
использование столько информации, сколько Вы предоставляете для определения эквивалентного текстового кодирования или самого близкого приближения. При обеспечении больше чем одного параметра все параметры проверяются по друг другу, чтобы гарантировать, что они допустимы в комбинации.Имя шрифта, такой как
'Symbol'
или'Zapf Dingbats,'
может указать определенный текст, кодирующий основу. Другие имена шрифтов могут указать особые разновидности, связанные с определенным текстом, кодирующим основу. Иначе, имя шрифта используется для получения кода сценария, и этот код сценария будет проверен по любому сценарию, кодируют Вас предоставление (в этом случае, шрифт должен быть установлен; если это не, функция возвращает aparamErr
закончитесь код). Если Вы не предоставляете или код языка, или код области и сценарий кодируют Вас предоставление или то, полученное, соответствует системный сценарий, то локализация системы используется для определения надлежащей области и кода языка. Это используется для того, чтобы получить текст, кодирующий основные значения, зависящие от области и языка, такой какkTextEncodingMacTurkish
.Для получения дополнительной информации посмотрите
RevertTextEncodingToScriptInfo
текст функции и Кодировки Основного текста.Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Количества и возвраты число текстовых кодировок в настоящее время конфигурируются в тексте, Кодирующем Преобразователь.
Объявление
Swift
func TECCountAvailableTextEncodings(_
numberEncodings
: UnsafeMutablePointer<ItemCount>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective 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) -> OSStatusObjective 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!) -> OSStatusObjective 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!) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective 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!) -> OSStatusObjective C
OSStatus TECClearSnifferContextInfo ( TECSnifferObjectRef encodingSniffer );
Параметры
encodingSniffer
Указатель на сниффера возражает, что Вы хотите сбросить.
Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса.
Обсуждение
Снифферы поддерживают информацию состояния о входном буфере кодирования и числе ошибок и функций, найденных для каждого кодирования; эта информация позволяет вызывающей стороне прогрессивно осуществлять сниффинг входного буфера в последовательных блоках. Прежде, чем осуществить сниффинг буфера, содержащего абсолютно новую информацию, которую необходимо очистить любую информацию состояния путем вызова
TECClearSnifferContextInfo
.Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Избавляется от объекта сниффера.
Объявление
Swift
func TECDisposeSniffer(_
encodingSniffer
: TECSnifferObject!) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective C
OSStatus CreateTextToUnicodeInfo ( ConstUnicodeMappingPtr iUnicodeMapping, TextToUnicodeInfo *oTextToUnicodeInfo );
Параметры
iUnicodeMapping
Указатель на структуру типа
UnicodeMapping
. Ваше приложение обеспечивает эту структуру для идентификации отображения для использования для преобразования. Необходимо предоставить значение типаTextEncoding
вunicodeEncoding
поле этой структуры. ATextEncoding
тройное, составленное из основы кодирования, варианта кодирования и формата. Можно получить aUnicodeMapping
значение путем вызывания функции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>) -> OSStatusObjective 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>) -> OSStatusObjective C
OSStatus DisposeTextToUnicodeInfo ( TextToUnicodeInfo *ioTextToUnicodeInfo );
Параметры
ioTextToUnicodeInfo
Указатель на объект преобразователя Unicode типа
TextToUnicodeInfo
, используемый для преобразования текста к Unicode. На вводе Вы указываете объект расположить. Это должен быть объект, который Ваше приложение создало использование функцииCreateTextToUnicodeInfo
илиCreateTextToUnicodeInfoByEncoding
. Вы не должны указывать ни на какой другой тип объекта преобразователя Unicode. Ваше приложение не должно использовать эту функцию с той же структурой несколько раз.Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Если Ваше приложение указывает недопустимый объект преобразователя Unicode, такой как
NULL
, функция возвращает aparamErr
код результата.Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Повторно инициализирует всю информацию состояния, хранившую объектами контекста.
Объявление
Swift
func ResetTextToUnicodeInfo(_
ioTextToUnicodeInfo
: TextToUnicodeInfo) -> OSStatusObjective 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) -> OSStatusObjective 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) -> OSStatusObjective 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>) -> OSStatusObjective C
OSStatus CreateUnicodeToTextInfo ( ConstUnicodeMappingPtr iUnicodeMapping, UnicodeToTextInfo *oUnicodeToTextInfo );
Параметры
iUnicodeMapping
Указатель на структуру типа
UnicodeMapping
. Ваше приложение обеспечивает эту структуру для идентификации отображения, которое будет использоваться для преобразования.unicodeEncoding
поле этой структуры может указать формат UnicodekUnicode16BitFormat
или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>) -> OSStatusObjective 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>) -> OSStatusObjective C
OSStatus DisposeUnicodeToTextInfo ( UnicodeToTextInfo *ioUnicodeToTextInfo );
Параметры
ioUnicodeToTextInfo
Указатель на преобразователь Unicode возражает для преобразования от Unicode до кодирования не-Unicode. Вы указываете, что преобразователь Unicode возражает, что Ваше приложение создало использование функции
CreateUnicodeToTextInfo
илиCreateUnicodeToTextInfoByEncoding
. Вы не должны указывать ни на какой другой тип объекта преобразователя Unicode. Ваше приложение не должно пытаться избавиться от того же объекта преобразователя Unicode несколько раз.Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Функциональные возвраты
noErr
если это избавляется от объекта преобразователя Unicode успешно. Если Ваше приложение указывает недопустимый объект преобразователя Unicode, такой какNULL
, функция возвращает aparamErr
код результата.Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
Повторно инициализирует всю информацию состояния, хранившую объектом преобразователя Unicode.
Объявление
Swift
func ResetUnicodeToTextInfo(_
ioUnicodeToTextInfo
: UnicodeToTextInfo) -> OSStatusObjective C
OSStatus ResetUnicodeToTextInfo ( UnicodeToTextInfo ioUnicodeToTextInfo );
Параметры
ioUnicodeToTextInfo
Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса.
Оператор импорта
Objective C
@import CoreServices;
Swift
import CoreServices
Доступность
Доступный в OS X v10.0 и позже.
-
ConvertFromUnicodeToTextRun (_: _: _: _: _: _: _: _: _: _: _: _: _: _: _:) ConvertFromUnicodeToTextRun
Преобразовывает строку от 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>) -> OSStatusObjective 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
, илиCreateUnicodeToTextRunInfoByScriptCod
e, когда Вы создали объект преобразователя 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 и позже.
-
ConvertFromUnicodeToScriptCodeRun (_: _: _: _: _: _: _: _: _: _: _: _: _: _: _:) ConvertFromUnicodeToScriptCodeRun
Преобразовывает строку от 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>) -> OSStatusObjective 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>) -> OSStatusObjective C
OSStatus CreateUnicodeToTextRunInfo ( ItemCount iNumberOfMappings, const UnicodeMapping iUnicodeMappings[], UnicodeToTextRunInfo *oUnicodeToTextInfo );
Параметры
iNumberOfMappings
Число отображений, указанных Вашим приложением для преобразования от Unicode до любых других типов кодировки, включая другие формы Unicode. Если Вы передадите 0 для этого параметра, то преобразователь будет использовать все сценарии, установленные в системе. Основной сценарий является тем с самым высоким приоритетом;
ScriptOrder
('itlm'
ресурс), определяет приоритет остальных. При установке старшего бита для этого параметра преобразователь Unicode предполагает чтоiEncodings
параметр содержит единственный элемент, указывающий предпочтительное кодирование. Эта функция поддерживается для версий 1.2 или позже преобразователя.iUnicodeMappings
Указатель на массив структур типа
UnicodeMapping
. Ваше приложение обеспечивает эту структуру для идентификации отображений, которые будут использоваться для преобразования. Порядок, в котором Вы указываете отображения, определяет приоритет целевых кодировок. Для этой функции структура отображения Unicode может указать формат UnicodekUnicode16BitFormat
или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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective 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>) -> OSStatusObjective C
OSStatus QueryUnicodeMappings ( OptionBits iFilter, ConstUnicodeMappingPtr iFindMapping, ItemCount iMaxCount, ItemCount *oActualCount, UnicodeMapping oReturnedMappings[] );
Параметры
iFilter
Флаги управления фильтром, представляющие шесть значений, данных в структуре отображения Unicode, что эта функция использование для соответствия против в определении, который отображения в системе возвратиться к приложению. Перечисления флага управления фильтром, описанные в Масках Соответствия Unicode, определяют константы для флагов и их масок. Можно включать в критерии поиска любой три текста, кодирующие значения — основу, вариант, и формат — и для кодирования Unicode и для другого указанного кодирования. Для любого флага, не включенного, проигнорировано значение, функция не проверяет соответствующее значение таблиц отображения в системе.
iFindMapping
Структура типа
UnicodeMapping
содержа текстовые кодировки, значения которых должны быть соответствующими.iMaxCount
Максимальное количество отображений, которые могут быть возвращены. Вы обеспечиваете это значение для идентификации числа элементов в массиве, на который указывают
oReturnedMappings
параметр, что выделяется Ваше приложение. Если функция идентифицирует больше соответствующих отображений, чем массив может содержать, это возвращает столько же из них сколько адаптация. Функция также возвращает akTECArrayFullErr
в этом случае.oActualCount
По возврату найден указатель на число соответствия отображений. Это число может быть больше, чем число отображений, указанных
iMaxCount
если больше соответствующих отображений найдено, чем может вписатьсяoReturnedMappings
массив.oReturnedMappings
Указатель на массив структур типа
UnicodeMapping
. На вводе этот указатель относится к массиву для соответствующих отображений, возвращенных функцией. Для выделения достаточных элементов для массива можно использовать функциюCountUnicodeMappings
определить число отображений возвратилось для данных значенийiFilter
иiFindMapping
параметры. По возврату, указателю на массив, содержащий соответствующие отображения. Если существует больше соответствий, чем массив может содержать, функциональные возвраты столько из них, сколько будет соответствовать и akTECBufferBelowMinimumSizeErr
ошибочный результат.oActualCount
параметр идентифицирует число соответствия отображений, фактически найденных, который может быть больше, чем возвратилось число.Возвращаемое значение
Код результата. Посмотрите менеджера по TEC Ресалта Коудса. Если функция возвращает a
noErr
закончитесь код, значение, повторно настроенное вoActualCount
параметр меньше чем или равен значению, возвращенному вiMaxCount
параметр иoReturnedMappings
параметр содержит все соответствующие найденные отображения. Если функция возвращает akTECArrayFullErr
, функция нашла больше отображений, чем Ваш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>) -> OSStatusObjective 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>) -> OSStatusObjective 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) -> OSStatusObjective C
OSStatus SetFallbackUnicodeToText ( UnicodeToTextInfo iUnicodeToTextInfo, UnicodeToTextFallbackUPP iFallback, OptionBits iControlFlags, LogicalAddress iInfoPtr );
Параметры
iUnicodeToTextInfo
Преобразователь Unicode \The возражает, с которым должен быть связан обработчик нейтрализации. Вы используете функцию
CreateUnicodeToTextInfo
илиCreateUnicodeToTextInfoByEncoding
получить объект преобразователя Unicode этого типа.iFallback
Универсальный указатель процедуры на определенную с помощью приложения подпрограмму нейтрализации. Для описания прототипа функции, что Ваш обработчик нейтрализации должен придерживаться и как создать Ваш собственный обработчик нейтрализации, посмотрите
UnicodeToTextFallbackProcPtr
. Необходимо использоватьNewUnicodeToTextFallbackProc
макрос для преобразования указателя на обработчик нейтрализации в aUnicodeToTextFallbackUPP
.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) -> OSStatusObjective 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) -> UnicodeToTextFallbackUPPObjective 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) -> OSStatusObjective 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>) -> OSStatusObjective 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
значение указано текстом, кодирующим основу, текст, кодирующий вариант и формат кодировки текста. Можно получить aTextEncoding
значение путем вызывания функции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 в строку текста, содержащего многократный текст, кодирующий выполнения. Каждое выполнение содержит текст, выраженный в различном кодировании от того из предыдущих или после сегмента текста. Для каждого текстового кодирования, выполненного в строке, aTextEncodingRun
структура указывает смещение начала и текстовое кодирование для того выполнения.Функции, преобразовывающие текст от Unicode до текста выполненный возврат преобразованный текст в массиве текста, кодирующего выполненные структуры. Текст, кодирующий выполненную структуру, определяется
TextEncodingRun
тип данных.Доступность
Доступный в OS X v10.0 и позже.
-
Определяет тип данных для текста, кодирующего вариант.
Объявление
Swift
typealias TextEncodingVariant = UInt32
Objective C
typedef UInt32 TextEncodingVariant;
Обсуждение
Следующие перечисления определяют текст, кодирующий различные константы: Кодирование Вариантов для Больших 5, Кодирование Вариантов для Макарабика, Кодирование Вариантов для Маккроутиэна, Кодирование Вариантов для Маккириллика, Кодирование Вариантов для Макфарси, Кодирование Вариантов для Макхебрю, Кодирование Вариантов для Макиселэндика, Кодирование Вариантов для Макджэпэнезе, Кодирование Вариантов для Макрочеловека, Связанного с Валютой, Кодирование Вариантов для Макромэниэна, Кодирование Вариантов для Макромэнлэтин1, Кодирование Вариантов для Макрочеловека и Кодирования Вариантов для Маквт100.
Оператор импорта
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-байтовые кодовые точки
0x00
–0x7F
как ISO 646 национальный вариант, отличающийся от ASCII, устанавливая этот флаг силы0x00
–0x7F
быть обработанным как ASCII. Например, японские кодировки, такие как Shift-JIS обычно обрабатывают0x00
–0x7F
как римлянин 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 };
Константы
-
Укажите соответствие критериев отображений 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.
Объявление
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 и позже.
-
-
Укажите варианты Макфарси.
Объявление
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 и позже.
-
-
Укажите варианты Макхебрю.
Объявление
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 };
Константы
-
Укажите текстовые кодировки для 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 };
-
Укажите особые случаи текстовых кодировок.
Объявление
Objective C
enum { kTextEncodingMultiRun = 0x0FFF, kTextEncodingUnknown = 0xFFFF };
Константы
-
Укажите формат кодировки текста.
Объявление
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 и позже.