Ссылка CFMutableString
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
Swift
import CoreFoundation
Objective C
@import CoreFoundation;
CFMutableString управляет динамическими строками. Основной интерфейс для управления строками предоставлен CFString. CFMutableString добавляет функции для изменения содержания строки.
CFMutableString “бесплатный соединенный мостом” с его дубликатом Основы Какао, NSMutableString
. Это означает, что Базовый тип Основы является взаимозаменяемым в вызовах функции или вызовах метода с соединенным мостом объектом Основы. Поэтому в методе, где Вы видите NSMutableString *
параметр, можно передать в a CFMutableStringRef
, и в функции, где Вы видите a CFMutableStringRef
параметр, можно передать в экземпляре NSMutableString. Это также применяется к конкретным подклассам NSMutableString. Посмотрите Бесплатные Соединенные мостом Типы для получения дополнительной информации о бесплатном образовании моста.
-
Добавляет символы строки к тем из объекта CFMutableString.
Объявление
Swift
func CFStringAppend(_
theString
: CFMutableString!, _appendedString
: CFString!)Objective C
void CFStringAppend ( CFMutableStringRef theString, CFStringRef appendedString );
Параметры
theString
Строка та, к который
appendedString
добавляется. ЕслиtheString
не объект CFMutableString, утверждение повышено.appendedString
Строка для добавления.
Обсуждение
Эта функция перераспределяет запоминающее устройство
theString
размещать новую длину.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Добавляет буфер символов Unicode к символьному содержанию объекта CFMutableString.
Объявление
Swift
func CFStringAppendCharacters(_
theString
: CFMutableString!, _chars
: UnsafePointer<UniChar>, _numChars
: CFIndex)Objective C
void CFStringAppendCharacters ( CFMutableStringRef theString, const UniChar *chars, CFIndex numChars );
Параметры
theString
Строка та, к который символы в
chars
добавляются.chars
Указатель на буфер символов Unicode.
numChars
Число символов Unicode в
chars
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Добавляет струну до к символьному содержанию объекта CFMutableString.
Объявление
Swift
func CFStringAppendCString(_
theString
: CFMutableString!, _cStr
: UnsafePointer<Int8>, _encoding
: CFStringEncoding)Objective C
void CFStringAppendCString ( CFMutableStringRef theString, const char *cStr, CFStringEncoding encoding );
Параметры
theString
Строка та, к который символы от
cStr
добавляются. Если это значение не является объектом CFMutableString, утверждение повышено.cStr
Указатель на буфер струны до.
encoding
Кодирование символов в
cStr
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Добавляет отформатированную строку к символьному содержанию объекта CFMutableString.
Объявление
Objective C
void CFStringAppendFormat ( CFMutableStringRef theString, CFDictionaryRef formatOptions, CFStringRef format, ... );
Параметры
theString
Строка та, к который отформатированные символы от
format
добавляются. Если это значение не является объектом CFMutableString, утверждение повышено.formatOptions
Словарь, содержащий параметры форматирования для строки (такие как тысяча символа разделителя, зависящего от локали). В настоящее время эти опции являются нереализованной функцией.
format
Отформатированная строка с
printf
- спецификаторы стиля....
Список переменных значений, которые будут вставлены в
format
.Обсуждение
Отформатированная строка один с
printf
- разработайте спецификаторы формата, встроенные в текст такой как%d
(десятичное число),%f
(дважды), и%@
(Базовый объект Основы). Последующими параметрами, в порядке, заменяют спецификаторы в символьных данных, добавленных кtheString
. Можно также переупорядочить параметры в строке при помощи модификаторов формы «n$» со спецификаторами формата (например,%2$d
).Для получения дополнительной информации о поддерживаемых спецификаторах посмотрите соответствующий раздел в Строковом Руководстве по программированию для Базовой Основы.
Оператор импорта
Objective C
@import CoreFoundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Добавляет отформатированную строку к символьному содержанию объекта CFMutableString.
Объявление
Swift
func CFStringAppendFormatAndArguments(_
theString
: CFMutableString!, _formatOptions
: CFDictionary!, _format
: CFString!, _arguments
: CVaListPointer)Objective C
void CFStringAppendFormatAndArguments ( CFMutableStringRef theString, CFDictionaryRef formatOptions, CFStringRef format, va_list arguments );
Параметры
theString
Строка та, к который отформатированные символы от
format
добавляются. Если это значение не является объектом CFMutableString, утверждение повышено.formatOptions
Словарь, содержащий параметры форматирования для строки (такие как тысяча символа разделителя, зависящего от локали). В настоящее время эти опции являются нереализованной функцией.
format
Отформатированная строка с
printf
- спецификаторы стиля.arguments
Список значений, которые будут вставлены в
format
.Обсуждение
Отформатированная строка один с
printf
- разработайте спецификаторы формата, встроенные в текст такой как%d
(десятичное число),%f
(дважды), и%@
(Базовый объект Основы). Последующими параметрами, в порядке, заменяют спецификаторы в символьных данных, добавленных кtheString
. Можно также переупорядочить параметры в строке при помощи модификаторов формы «n$» со спецификаторами формата (например,%2$d
).Для получения дополнительной информации о поддерживаемых спецификаторах посмотрите соответствующий раздел в Строковом Руководстве по программированию для Базовой Основы.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Добавляет строку Паскаля к символьному содержанию объекта CFMutableString.
Объявление
Swift
func CFStringAppendPascalString(_
theString
: CFMutableString!, _pStr
: ConstStr255Param, _encoding
: CFStringEncoding)Objective C
void CFStringAppendPascalString ( CFMutableStringRef theString, ConstStr255Param pStr, CFStringEncoding encoding );
Параметры
theString
Строка та, к который символы в
pStr
добавляются. Если это значение не является объектом CFMutableString, утверждение повышено.pStr
Строковый буфер Паскаля.
encoding
Строковое кодирование символов в
pStr
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Изменяет первый символ в каждом слове строки к верхнему регистру (если это - строчный алфавитный символ).
Объявление
Swift
func CFStringCapitalize(_
theString
: CFMutableString!, _locale
: CFLocale!)Objective C
void CFStringCapitalize ( CFMutableStringRef theString, CFLocaleRef locale );
Параметры
theString
Строка, которая будет капитализироваться. Если это значение не является объектом CFMutableString, утверждение повышено.
locale
Локаль, указывающая определенный язык или область. До OS X v10.3, этот параметр был невведенным указателем и не использовал.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Создает пустой объект CFMutableString.
Объявление
Swift
func CFStringCreateMutable(_
alloc
: CFAllocator!, _maxLength
: CFIndex) -> CFMutableString!Objective C
CFMutableStringRef CFStringCreateMutable ( CFAllocatorRef alloc, CFIndex maxLength );
Параметры
alloc
Средство выделения для использования для выделения памяти для новой строки. Передача
NULL
илиkCFAllocatorDefault
использовать текущее средство выделения по умолчанию.maxLength
Максимальное количество символов Unicode, которые могут быть сохранены возвращаемой строкой. Передача
0
если не должно быть никакого символьного предела. Обратите внимание на то, что первоначально строка все еще имеет длину0
; этот параметр просто указывает, каков максимальный размер. CFMutableString мог бы попытаться оптимизировать свою внутреннюю память уделением внимания этому значению.Возвращаемое значение
Новый пустой CFMutableString возражает или
NULL
если была проблема, создающая объект. Владение соблюдает Создать Правило.Обсуждение
Эта функция создает пустое (т.е. содержание меньше) объект CFMutableString. Можно добавить символьные данные к этому объекту с любым из
CFStringAppend...
функции, и после того можно вставить, удалить, заменить, дополнить и обрезать символы с надлежащими функциями CFString. ЕслиmaxLength
параметр больше, чем0
, любая попытка добавить символы вне этого предела приводит к ошибке периода выполнения.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Создает непостоянную копию строки.
Объявление
Swift
func CFStringCreateMutableCopy(_
alloc
: CFAllocator!, _maxLength
: CFIndex, _theString
: CFString!) -> CFMutableString!Objective C
CFMutableStringRef CFStringCreateMutableCopy ( CFAllocatorRef alloc, CFIndex maxLength, CFStringRef theString );
Параметры
alloc
Средство выделения для использования для выделения памяти для новой строки. Передача
NULL
илиkCFAllocatorDefault
использовать текущее средство выделения по умолчанию.maxLength
Максимальное количество символов Unicode, которые могут быть сохранены возвращенным объектом. Передача
0
если не должно быть никакого символьного предела. Обратите внимание на то, что первоначально возвращенный объект все еще имеет ту же длину как аргумент строки; этот параметр просто указывает, каков максимальный размер. CFString мог бы попытаться оптимизировать свою внутреннюю память уделением внимания этому значению.theString
Строка для копирования.
Возвращаемое значение
Строка, имеющая то же содержание как
theString
. ВозвратыNULL
если была проблема, копируя объект. Владение соблюдает Создать Правило.Обсуждение
Возвращенная непостоянная строка идентична исходной строке за исключением (возможно), атрибута переменчивости. Можно добавить символьные данные к возвращаемой строке с любым из
CFStringAppend...
функции, и можно вставить, удалить, заменить, дополнить и обрезать символы с надлежащими функциями CFString. ЕслиmaxLength
параметр больше, чем0
, любая попытка добавить символы вне этого предела приводит к ошибке периода выполнения.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
CFStringCreateMutableWithExternalCharactersNoCopy (_: _: _: _: _:) CFStringCreateMutableWithExternalCharactersNoCopy
Создает объект CFMutableString, буфером символа Unicode которого управляют внешне.
Объявление
Swift
func CFStringCreateMutableWithExternalCharactersNoCopy(_
alloc
: CFAllocator!, _chars
: UnsafeMutablePointer<UniChar>, _numChars
: CFIndex, _capacity
: CFIndex, _externalCharactersAllocator
: CFAllocator!) -> CFMutableString!Objective C
CFMutableStringRef CFStringCreateMutableWithExternalCharactersNoCopy ( CFAllocatorRef alloc, UniChar *chars, CFIndex numChars, CFIndex capacity, CFAllocatorRef externalCharactersAllocator );
Параметры
alloc
Средство выделения для использования для выделения памяти для строки. Передача
NULL
илиkCFAllocatorDefault
использовать текущее средство выделения по умолчанию.chars
Символ Unicode буферизует для нового CFMutableString. Перед вызовом создайте этот буфер на штабеле или «куче» и дополнительно инициализируйте его с данными символа Unicode. По возврату создаваемый объект CFString сохраняет свою собственную копию указателя на этот буфер. Можно передать в
NULL
если нет никакого предоставленного начального буфера.numChars
Число символов первоначально в буфере Unicode, которым указывают
chars
.capacity
Мощность внешнего буфера (
chars
); т.е. максимальное количество символов Unicode, которые могут быть сохранены. Это значение должно быть0
если не предоставлен никакой начальный буфер.externalCharactersAllocator
Средство выделения для использования для перераспределения внешнего буфера, когда редактирование имеет место и для освобождения буфера, когда освобождена строка. Если средство выделения по умолчанию подходит в этих целях, передаче
NULL
. Если Вы не хотите, чтобы новая строка перераспределила или освободила память для буфера (т.е. Вы принимаете на себя ответственность за эти вещи сами), передачаkCFAllocatorNull
.Возвращаемое значение
Новая непостоянная строка, или
NULL
если была проблема, создающая объект. Владение соблюдает Создать Правило.Обсуждение
Эта функция разрешает Вам создавать объект CFMutableString, запоминающее устройство которого является внешним буфером символа Unicode — т.е. буфер, которым Вы управляете (или может управлять), полностью. Эта функция позволяет Вам использовать в своих интересах функции CFString, особенно функции CFMutableString, добавляющие и изменяющие символьные данные. Но одновременно можно непосредственно добавить, удалить, изменить и исследовать символы в буфере. Можно даже заменить буфер полностью. Если, однако, Вы непосредственно изменяете или заменяете символьный буфер, необходимо сообщить объекту CFString этого изменения с
CFStringSetExternalCharactersNoCopy
функция.Если Вы видоизменяете символьное содержание с функциями CFString, и буфер должен быть увеличен, вызовы объектов CFString обратные вызовы выделения, указанные для средства выделения
externalCharactersAllocator
.Эта функция должна использоваться при особых обстоятельствах, где Вы хотите создать обертку CFString вокруг существующего, потенциально большого
UniChar
буферизуйте Вас собственный. Используя эти причины функции объект CFString воздержаться от части его внутренней оптимизации, таким образом, этого нужно избежать во всеобщем употреблении. Т.е. если Вы хотите создать объект CFString из маленькогоUniChar
буфер, и Вы не должны продолжать владеть буфером, используете одну из других функций создания (например,CFStringCreateWithCharacters
) вместо этого.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Удаляет диапазон символов в строке.
Объявление
Swift
func CFStringDelete(_
theString
: CFMutableString!, _range
: CFRange)Objective C
void CFStringDelete ( CFMutableStringRef theString, CFRange range );
Параметры
theString
Строка, из которой должны быть удалены символы.
range
Диапазон символов в
theString
удалить.Обсуждение
Символы после удаленного диапазона корректируются для «заполнения» разрыва.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Замены все случаи подстроки в данном диапазоне.
Объявление
Swift
func CFStringFindAndReplace(_
theString
: CFMutableString!, _stringToFind
: CFString!, _replacementString
: CFString!, _rangeToSearch
: CFRange, _compareOptions
: CFStringCompareFlags) -> CFIndexObjective C
CFIndex CFStringFindAndReplace ( CFMutableStringRef theString, CFStringRef stringToFind, CFStringRef replacementString, CFRange rangeToSearch, CFStringCompareFlags compareOptions );
Параметры
theString
Строка для изменения.
stringToFind
Подстрока для поиска в
theString
.replacementString
Замещающая строка для
stringToFind
.rangeToSearch
Диапазон, в котором можно искать в
theString
.compareOptions
Флаги, выбирающие различные типы сравнений, такие как локализованное сравнение, нечувствительное к регистру сравнение и нелитеральное сравнение. Если Вы хотите поведение сравнения по умолчанию, передачу
0
. ПосмотритеCFStringCompareFlags
для доступных флагов.Возвращаемое значение
Число экземпляров
stringToFind
это было заменено.Обсуждение
Возможные значения
compareOptions
комбинацииkCFCompareCaseInsensitive
,kCFCompareBackwards
,kCFCompareNonliteral
, иkCFCompareAnchored
константы.kCFCompareBackwards
опция может использоваться для замены подстроки, запускающейся с конца, который мог привести к различным результатам. Например, если параметрtheString
«AAAAA»,stringToFind
«AA», иreplacementString
«B», тогда результатом обычно является «BBA». Однако, еслиkCFCompareBackwards
постоянный используется, результатом является «ABB».kCFCompareAnchored
опция гарантирует, что только привязанные но многократные экземпляры найдены (экземпляры должны быть последовательными в запуске или конце). Например, если параметрtheString
«AAXAA»,stringToFind
иreplacementString
«B», тогда результатом обычно является «BBXBB». Однако, еслиkCFCompareAnchored
постоянный используется, результатом является «BBXAA».Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Сворачивает данную строку в форму, указанную дополнительными флагами.
Объявление
Swift
func CFStringFold(_
theString
: CFMutableString!, _theFlags
: CFStringCompareFlags, _theLocale
: CFLocale!)Objective C
void CFStringFold ( CFMutableStringRef theString, CFStringCompareFlags theFlags, CFLocaleRef theLocale );
Параметры
theString
Строка, которая должна быть свернута. Если этот параметр не является допустимым непостоянным CFString, поведение не определено.
theFlags
Флаги эквивалентности, который описывает форму сворачивания символа. См. “Флаги Сравнения строк” в Ссылке CFString для возможных значений. Только те флаги, содержащие «нечувствительное» слово, распознаны; другие флаги проигнорированы.
Сворачивание с
kCFCompareCaseInsensitive
удаляет различия случая в соответствии с отображением, указанным ftp://ftp .unicode.org/Public/UNIDATA/CaseFolding.txt. Сворачивание сkCFCompareDiacriticInsensitive
удаляет различия диакритических знаков и других диакритических знаков. Сворачивание сkCFCompareWidthInsensitive
удаляет различия ширины символов путем отображения символов в диапазонеU+FF00-U+FFEF
к их обычным эквивалентам.theLocale
Локаль для использования для работы.
NULL
указывает каноническую локаль (возвращаемое значение отCFLocaleGetSystem
).Параметр локали влияет на алгоритм отображения случая. Например, для турецкой локали, нечувствительной к регистру, сравнивают соответствия «я» с «ı» (кодовая точка Unicode U+0131, латинский Маленький Dotless I), не нормальное, которое «я» изображаю.
Обсуждение
Символьное сворачивание является операциями, преобразовывающими любой ряд символов, совместно использующих подобную семантику в единственного представителя того набора.
Можно использовать эту функцию для предварительной обработки строк, которые должны сравниваться, искаться или индексироваться. Обратите внимание на то, что сворачивание не включает нормализацию, таким образом, необходимо использовать
CFStringNormalize
в дополнение к CFStringFold для получения эффектаkCFCompareNonliteral
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Вставляет строку в указанном расположении в символьном буфере объекта CFMutableString.
Объявление
Swift
func CFStringInsert(_
str
: CFMutableString!, _index
: CFIndex, _insertedStr
: CFString!)Objective C
void CFStringInsert ( CFMutableStringRef str, CFIndex idx, CFStringRef insertedStr );
Параметры
str
Строка, которая будет изменена. Если это значение не является объектом CFMutableString, утверждение повышено.
index
Индекс символа в
str
после которого должны быть вставлены новые символы. Если индекс выходит за пределы, утверждение повышено.insertedStr
Строка для вставки в
str
.Обсуждение
Для размещения новых символов эта функция перемещает любые существующие символы направо от вставленных символов надлежащее число позиций.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Изменения все прописные алфавитные символы в CFMutableString к нижнему регистру.
Объявление
Swift
func CFStringLowercase(_
theString
: CFMutableString!, _locale
: CFLocale!)Objective C
void CFStringLowercase ( CFMutableStringRef theString, CFLocaleRef locale );
Параметры
theString
Строка, которая будет печататься строчными литерами. Если это значение не является объектом CFMutableString, утверждение повышено.
locale
Локаль для использования, когда выполняется печатающая строчными литерами работа. До OS X v10.3 этот параметр был невведенный указатель и не использовал.
Параметр локали влияет на алгоритм отображения случая. Например, для турецкой локали, нечувствительной к регистру, сравнивают соответствия «я» с «ı» (кодовая точка Unicode U+0131, латинский Маленький Dotless I), не нормальное, которое «я» изображаю.
Специальные замечания
locale
тип параметра изменился от недействительного * к CFLocaleRef в OS X v10.3.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Нормализует строку в указанную форму, как описано в Техническом отчете № 15 Unicode.
Объявление
Swift
func CFStringNormalize(_
theString
: CFMutableString!, _theForm
: CFStringNormalizationForm)Objective C
void CFStringNormalize ( CFMutableStringRef theString, CFStringNormalizationForm theForm );
Параметры
theString
Строка, которая будет нормализована.
theForm
Форма для нормализации
theString
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Увеличивает строку, дополняя его указанными символами, или усекает строку.
Объявление
Swift
func CFStringPad(_
theString
: CFMutableString!, _padString
: CFString!, _length
: CFIndex, _indexIntoPad
: CFIndex)Objective C
void CFStringPad ( CFMutableStringRef theString, CFStringRef padString, CFIndex length, CFIndex indexIntoPad );
Параметры
theString
Строка для изменения.
padString
Строка, содержащая символы, которыми можно заполнить буфер расширенного символа. Передача
NULL
усекать строку.length
Новая длина
theString
. Если эта длина больше, чем текущая длина, дополнение имеет место; если это меньше, усечение имеет место.indexIntoPad
Индекс символа в
padString
которым можно начать дополнять. При усечении строки, представленной объектом этот параметр проигнорирован.Обсуждение
Эта функция имеет две цели. Это или увеличивает символьный буфер объекта CFMutableString к данной длине, дополняя добавленную длину данным символом или символами, или это усекает символьный буфер к меньшему размеру. Основной параметр для этого поведения
length
; если это больше, чем текущая длина представленной строки, дополнение имеет место, и если это меньше, чем текущая длина, происходит усечение.Например, скажите, что у Вас есть строка,
aMutStr
, содержа символы «abcdef». ВызовCFStringPad(aMutStr, CFSTR("123"), 9, 1);
результаты в
aMutStr
содержа «abcdef231». Однако следующий вызовCFStringPad(aMutStr, NULL, 3, 0);
результаты в
aMutStr
содержа «abc».Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Часть замен символьного содержания CFMutableString возражает с другой строкой.
Объявление
Swift
func CFStringReplace(_
theString
: CFMutableString!, _range
: CFRange, _replacement
: CFString!)Objective C
void CFStringReplace ( CFMutableStringRef theString, CFRange range, CFStringRef replacement );
Параметры
theString
Строка для изменения. Символы корректируются левые или правые (в зависимости от длины строки, которой заменяют), и символьный буфер объекта изменен соответственно. Если это значение не является объектом CFMutableString, утверждение повышено.
range
Диапазон символов в
theString
заменять.replacement
Замещающая строка для помещения в
theString
.Обсуждение
Несмотря на то, что можно использовать эту функцию для замены всех символов в объекте CFMutableString (путем указания диапазона
(0, CFStringGetLength(theString))
), более удобно использоватьCFStringReplaceAll
функция с этой целью.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Замены все символы CFMutableString возражают с другими символами.
Объявление
Swift
func CFStringReplaceAll(_
theString
: CFMutableString!, _replacement
: CFString!)Objective C
void CFStringReplaceAll ( CFMutableStringRef theString, CFStringRef replacement );
Параметры
theString
Строка для изменения. Если это значение не является объектом CFMutableString, утверждение повышено.
replacement
Замещающая строка для помещения в
theString
.Обсуждение
Символьный буфер
theString
изменен согласно длине новых символов.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Уведомляет, что CFMutableString возражает, что изменилось его внешнее запоминающее устройство символов Unicode.
Объявление
Swift
func CFStringSetExternalCharactersNoCopy(_
theString
: CFMutableString!, _chars
: UnsafeMutablePointer<UniChar>, _length
: CFIndex, _capacity
: CFIndex)Objective C
void CFStringSetExternalCharactersNoCopy ( CFMutableStringRef theString, UniChar *chars, CFIndex length, CFIndex capacity );
Параметры
theString
Строка для действия как «обертка» для внешнего запоминающего устройства (
chars
). Если это значение не является объектом CFMutableString, утверждение повышено.chars
Внешний (клиентский) буфер Unicode, действующий как запоминающее устройство для
theString
.length
Текущая длина содержания
chars
(в символах Unicode).capacity
Мощность буфера Unicode — т.е. общее количество символов Unicode, которые могут быть сохранены в нем перед буфером, должна быть увеличена.
Обсуждение
Вы используете эту функцию, чтобы перераспределить память для строки, при необходимости, и изменить ее ссылки на данные в буфере. Объект, должно быть, был создан с
CFStringCreateMutableWithExternalCharactersNoCopy
функция; посмотрите обсуждение этой функции для получения дополнительной информации.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Выполните оперативную транслитерацию на непостоянной строке.
Объявление
Swift
func CFStringTransform(_
string
: CFMutableString!, _range
: UnsafeMutablePointer<CFRange>, _transform
: CFString!, _reverse
: Boolean) -> BooleanObjective C
Boolean CFStringTransform ( CFMutableStringRef string, CFRange *range, CFStringRef transform, Boolean reverse );
Параметры
string
Строка для преобразования.
range
Указатель на диапазон, по которому применяется трансформация.
NULL
заставляет целую строку быть преобразованной. По возврату,range
изменяется для отражения нового диапазона, соответствующего исходному диапазону.transform
Объект CFString, идентифицирующий трансформацию для применения. Для списка допустимых значений посмотрите, Преобразовывают Идентификаторы для CFStringTransform. На OS X v10.4 и позже, можно также использовать любой допустимый ICU, преобразовывают ID, определенный в Руководство пользователя ICU для Преобразований.
reverse
Булевская переменная это, если
true
, указывает, что обратное преобразование должно использоваться (если оно существует).Возвращаемое значение
true
если преобразование успешно; иначеfalse
.Обсуждение
Трансформация, представленная
transform
применяется к данному диапазонуstring
, изменение его на месте. Только указанный диапазон изменяется, но преобразование может смотреть на части строки вне того диапазона для контекста. Причины, что преобразование может быть неуспешным, включают недопустимый идентификатор преобразования, и пытающийся инвертировать необратимое преобразование.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Обрезает указанную подстроку с начала и конца объекта CFMutableString.
Объявление
Swift
func CFStringTrim(_
theString
: CFMutableString!, _trimString
: CFString!)Objective C
void CFStringTrim ( CFMutableStringRef theString, CFStringRef trimString );
Параметры
theString
Строка для обрезки. Если это значение не является объектом CFMutableString, утверждение повышено.
trimString
Строка для обрезки от
theString
. Символы строки для обрезки обрабатываются как подстрока и весьма отдельным образом; например, если непостоянные символы являются «abc X», и строка для обрезки является «XY», непостоянные символы не затронуты.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Пробел обрезок с начала и конца объекта CFMutableString.
Объявление
Swift
func CFStringTrimWhitespace(_
theString
: CFMutableString!)Objective C
void CFStringTrimWhitespace ( CFMutableStringRef theString );
Параметры
theString
Строка для обрезки. Если это значение не является объектом CFMutableString, утверждение повышено.
Обсуждение
Пробел для этой функции включает пробелы, вкладки, новые строки, возвраты каретки и любые подобные символы, не имеющие видимого представления.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Изменения все строчные алфавитные символы в CFMutableString возражают против верхнего регистра.
Объявление
Swift
func CFStringUppercase(_
theString
: CFMutableString!, _locale
: CFLocale!)Objective C
void CFStringUppercase ( CFMutableStringRef theString, CFLocaleRef locale );
Параметры
theString
Строка к верхнему регистру. Если это значение не является объектом CFMutableString, утверждение повышено.
locale
Объект CFLocale, указывающий определенный язык или область. До OS X v10.3, этот параметр был невведенным указателем и не использовал.
Параметр локали влияет на алгоритм отображения случая. Например, для турецкой локали, нечувствительной к регистру, сравнивают соответствия «я» с «ı» (кодовая точка Unicode U+0131, латинский Маленький Dotless I), не нормальное, которое «я» изображаю.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Ссылка на объект CFMutableString.
Объявление
Swift
typealias CFMutableStringRef = CFMutableString
Objective C
typedef CFStringRef CFMutableStringRef;
Обсуждение
Тип относится к объекту CFMutableString, «инкапсулирующему» Unicode, следуют за его длиной; объект имеет атрибут того, чтобы быть непостоянным, что означает, что может быть изменено его символьное содержание. CFString является непрозрачным типом, определяющим характеристики и поведение объектов CFString, и неизменных и непостоянных.
CFMutableString происходит из CFString. Поэтому можно передать объекты CFMutableString в функции, принимающие объекты CFString.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Формы нормализации Unicode, как описано в Техническом отчете № 15 Unicode.
Объявление
Swift
enum CFStringNormalizationForm : CFIndex { case D case KD case C case KC }
Objective C
enum CFStringNormalizationForm { kCFStringNormalizationFormD = 0, kCFStringNormalizationFormKD = 1, kCFStringNormalizationFormC = 2, kCFStringNormalizationFormKC = 3 }; typedef enum CFStringNormalizationForm CFStringNormalizationForm;
Константы
-
D
kCFStringNormalizationFormD
Каноническое разложение.
Доступный в iOS 2.0 и позже.
-
KD
kCFStringNormalizationFormKD
Разложение совместимости.
Доступный в iOS 2.0 и позже.
-
C
kCFStringNormalizationFormC
Каноническое разложение, сопровождаемое каноническим составом.
Доступный в iOS 2.0 и позже.
-
KC
kCFStringNormalizationFormKC
Разложение совместимости, сопровождаемое каноническим составом.
Доступный в iOS 2.0 и позже.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
-
Идентифицирующие константы преобразовывают используемый с
CFStringTransform
.Объявление
Swift
let kCFStringTransformStripCombiningMarks: CFString! let kCFStringTransformToLatin: CFString! let kCFStringTransformFullwidthHalfwidth: CFString! let kCFStringTransformLatinKatakana: CFString! let kCFStringTransformLatinHiragana: CFString! let kCFStringTransformHiraganaKatakana: CFString! let kCFStringTransformMandarinLatin: CFString! let kCFStringTransformLatinHangul: CFString! let kCFStringTransformLatinArabic: CFString! let kCFStringTransformLatinHebrew: CFString! let kCFStringTransformLatinThai: CFString! let kCFStringTransformLatinCyrillic: CFString! let kCFStringTransformLatinGreek: CFString! let kCFStringTransformToXMLHex: CFString! let kCFStringTransformToUnicodeName: CFString! let kCFStringTransformStripDiacritics: CFString!
Objective C
const CFStringRef kCFStringTransformStripCombiningMarks; const CFStringRef kCFStringTransformToLatin; const CFStringRef kCFStringTransformFullwidthHalfwidth; const CFStringRef kCFStringTransformLatinKatakana; const CFStringRef kCFStringTransformLatinHiragana; const CFStringRef kCFStringTransformHiraganaKatakana; const CFStringRef kCFStringTransformMandarinLatin; const CFStringRef kCFStringTransformLatinHangul; const CFStringRef kCFStringTransformLatinArabic; const CFStringRef kCFStringTransformLatinHebrew; const CFStringRef kCFStringTransformLatinThai; const CFStringRef kCFStringTransformLatinCyrillic; const CFStringRef kCFStringTransformLatinGreek; const CFStringRef kCFStringTransformToXMLHex; const CFStringRef kCFStringTransformToUnicodeName; const CFStringRef kCFStringTransformStripDiacritics;
Константы
-
kCFStringTransformStripCombiningMarks
Идентификатор преобразования для разделения объединяющихся меток (диакритические знаки или диакритические знаки).
Доступный в iOS 2.0 и позже.
-
kCFStringTransformToLatin
Идентификатор преобразования для транслитерации всего текста, возможного к латинскому сценарию. Идеограммы транслитерируются как мандаринский диалект китайского языка.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformFullwidthHalfwidth
Идентификатор обратимого преобразования для преобразования полноширинных символов в их эквиваленты полуширины.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinKatakana
Идентификатор обратимого преобразования для транслитерации текста к Katakana с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinHiragana
Идентификатор обратимого преобразования для транслитерации текста к Hiragana с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformHiraganaKatakana
Идентификатор обратимого преобразования для транслитерации текста к Katakana от Hiragana.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformMandarinLatin
Идентификатор преобразования для транслитерации текста на латынь от идеограмм, интерпретируемых как мандаринский диалект китайского языка. Это преобразование не обратимо.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinHangul
Идентификатор обратимого преобразования для транслитерации текста к Хангулу с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinArabic
Идентификатор обратимого преобразования для транслитерации текста на арабский язык с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinHebrew
Идентификатор обратимого преобразования для транслитерации текста ивриту с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinThai
Идентификатор обратимого преобразования для транслитерации текста тайскому языку с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinCyrillic
Идентификатор обратимого преобразования для транслитерации текста к Кириллице с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformLatinGreek
Идентификатор обратимого преобразования для транслитерации текста греческому языку с латыни.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformToXMLHex
Идентификатор обратимого преобразования для транслитерации символов кроме печатаемого ASCII к числовым объектам XML/HTML.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformToUnicodeName
Идентификатор обратимого преобразования для транслитерации символов кроме печатаемого ASCII (минус фигурные скобки) к их имени персонажа Unicode в фигурных скобках.
Примеры включают {AIRPLANE} и {GREEK CAPITAL LETTER PSI}.
Доступный в iOS 2.0 и позже.
-
kCFStringTransformStripDiacritics
Идентификатор преобразования для удаления диакритических маркировок.
Доступный в iOS 2.0 и позже.
Обсуждение
На OS X v10.4 и позже, с
CFStringTransform
можно также использовать любой допустимый ICU, преобразовывают ID, определенный в Руководство пользователя ICU для Преобразований. -