Ссылка CFMutableString

CFMutableString управляет динамическими строками. Основной интерфейс для управления строками предоставлен CFString. CFMutableString добавляет функции для изменения содержания строки.

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

Функции

Разные функции CFMutableString


    
    CFStringAppend (_: _:)
    CFStringAppend

Добавляет символы строки к тем из объекта 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

Доступность

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


    
    CFStringAppendCharacters (_: _: _:)
    CFStringAppendCharacters

Добавляет буфер символов 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

Доступность

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


    
    CFStringAppendCString (_: _: _:)
    CFStringAppendCString

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

Доступность

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


    
    CFStringAppendFormat
    CFStringAppendFormat

Добавляет отформатированную строку к символьному содержанию объекта 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;

Доступность

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


    
    CFStringAppendFormatAndArguments (_: _: _: _:)
    CFStringAppendFormatAndArguments

Добавляет отформатированную строку к символьному содержанию объекта 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`.

Обсуждение

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFStringAppendPascalString (_: _: _:)
    CFStringAppendPascalString

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

Доступность

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


    
    CFStringCapitalize (_: _:)
    CFStringCapitalize

Изменяет первый символ в каждом слове строки к верхнему регистру (если это - строчный алфавитный символ).

Объявление

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

Доступность

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


    
    CFStringCreateMutable (_: _:)
    CFStringCreateMutable

Создает пустой объект 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

Доступность

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


    
    CFStringCreateMutableCopy (_: _: _:)
    CFStringCreateMutableCopy

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

Объявление

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

Доступность

Доступный в OS X v10.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

Доступность

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


    
    CFStringDelete (_: _:)
    CFStringDelete

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

Объявление

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

Доступность

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


    
    CFStringFindAndReplace (_: _: _: _: _:)
    CFStringFindAndReplace

Замены все случаи подстроки в данном диапазоне.

Объявление

Swift

func CFStringFindAndReplace(_ theString: CFMutableString!, _ stringToFind: CFString!, _ replacementString: CFString!, _ rangeToSearch: CFRange, _ compareOptions: CFStringCompareFlags) -> CFIndex

Objective 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

Доступность

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


    
    CFStringFold (_: _: _:)
    CFStringFold

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

Объявление

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

Доступность

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


    
    CFStringInsert (_: _: _:)
    CFStringInsert

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

Доступность

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


    
    CFStringLowercase (_: _:)
    CFStringLowercase

Изменения все прописные алфавитные символы в 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

Доступность

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


    
    CFStringNormalize (_: _:)
    CFStringNormalize

Нормализует строку в указанную форму, как описано в Техническом отчете № 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

Доступность

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


    
    CFStringPad (_: _: _: _:)
    CFStringPad

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

Объявление

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

Доступность

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


    
    CFStringReplace (_: _: _:)
    CFStringReplace

Часть замен символьного содержания 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

Доступность

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


    
    CFStringReplaceAll (_: _:)
    CFStringReplaceAll

Замены все символы 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

Доступность

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


    
    CFStringSetExternalCharactersNoCopy (_: _: _: _:)
    CFStringSetExternalCharactersNoCopy

Уведомляет, что 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

Доступность

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


    
    CFStringTransform (_: _: _: _:)
    CFStringTransform

Выполните оперативную транслитерацию на непостоянной строке.

Объявление

Swift

func CFStringTransform(_ string: CFMutableString!, _ range: UnsafeMutablePointer<CFRange>, _ transform: CFString!, _ reverse: Boolean) -> Boolean

Objective 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

Доступность

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


    
    CFStringTrim (_: _:)
    CFStringTrim

Обрезает указанную подстроку с начала и конца объекта 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

Доступность

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


    
    CFStringTrimWhitespace (_:)
    CFStringTrimWhitespace

Пробел обрезок с начала и конца объекта CFMutableString.

Объявление

Swift

func CFStringTrimWhitespace(_ theString: CFMutableString!)

Objective C

void CFStringTrimWhitespace ( CFMutableStringRef theString );

Параметры


      theString

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

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFStringUppercase (_: _:)
    CFStringUppercase

Изменения все строчные алфавитные символы в CFMutableString возражают против верхнего регистра.

Объявление

Swift

func CFStringUppercase(_ theString: CFMutableString!, _ locale: CFLocale!)

Objective C

void CFStringUppercase ( CFMutableStringRef theString, CFLocaleRef locale );

Параметры


      theString

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


      locale

Объект CFLocale, указывающий определенный язык или область. До OS X v10.3, этот параметр был невведенным указателем и не использовал.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Типы данных

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

CFMutableStringRef CFMutableStringRef

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

Доступность

Доступный в OS X v10.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
  
  Каноническое разложение.
  
  Доступный в OS X v10.2 и позже.
- KD
  
  kCFStringNormalizationFormKD
  
  Разложение совместимости.
  
  Доступный в OS X v10.2 и позже.
- C
  
  kCFStringNormalizationFormC
  
  Каноническое разложение, сопровождаемое каноническим составом.
  
  Доступный в OS X v10.2 и позже.
- KC
  
  kCFStringNormalizationFormKC
  
  Разложение совместимости, сопровождаемое каноническим составом.
  
  Доступный в OS X v10.2 и позже.
Оператор импорта

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.2 и позже.
Преобразуйте идентификаторы для CFStringTransform
Идентифицирующие константы преобразовывают используемый с 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
  
  kCFStringTransformStripCombiningMarks
  
  Идентификатор преобразования для разделения объединяющихся меток (диакритические знаки или диакритические знаки).
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformToLatin
  
  kCFStringTransformToLatin
  
  Идентификатор преобразования для транслитерации всего текста, возможного к латинскому сценарию. Идеограммы транслитерируются как мандаринский диалект китайского языка.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformFullwidthHalfwidth
  
  kCFStringTransformFullwidthHalfwidth
  
  Идентификатор обратимого преобразования для преобразования полноширинных символов в их эквиваленты полуширины.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinKatakana
  
  kCFStringTransformLatinKatakana
  
  Идентификатор обратимого преобразования для транслитерации текста к Katakana с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinHiragana
  
  kCFStringTransformLatinHiragana
  
  Идентификатор обратимого преобразования для транслитерации текста к Hiragana с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformHiraganaKatakana
  
  kCFStringTransformHiraganaKatakana
  
  Идентификатор обратимого преобразования для транслитерации текста к Katakana от Hiragana.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformMandarinLatin
  
  kCFStringTransformMandarinLatin
  
  Идентификатор преобразования для транслитерации текста на латынь от идеограмм, интерпретируемых как мандаринский диалект китайского языка. Это преобразование не обратимо.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinHangul
  
  kCFStringTransformLatinHangul
  
  Идентификатор обратимого преобразования для транслитерации текста к Хангулу с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinArabic
  
  kCFStringTransformLatinArabic
  
  Идентификатор обратимого преобразования для транслитерации текста на арабский язык с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinHebrew
  
  kCFStringTransformLatinHebrew
  
  Идентификатор обратимого преобразования для транслитерации текста ивриту с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinThai
  
  kCFStringTransformLatinThai
  
  Идентификатор обратимого преобразования для транслитерации текста тайскому языку с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinCyrillic
  
  kCFStringTransformLatinCyrillic
  
  Идентификатор обратимого преобразования для транслитерации текста к Кириллице с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformLatinGreek
  
  kCFStringTransformLatinGreek
  
  Идентификатор обратимого преобразования для транслитерации текста греческому языку с латыни.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformToXMLHex
  
  kCFStringTransformToXMLHex
  
  Идентификатор обратимого преобразования для транслитерации символов кроме печатаемого ASCII к числовым объектам XML/HTML.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformToUnicodeName
  
  kCFStringTransformToUnicodeName
  
  Идентификатор обратимого преобразования для транслитерации символов кроме печатаемого ASCII (минус фигурные скобки) к их имени персонажа Unicode в фигурных скобках.
  
  Примеры включают {AIRPLANE} и {GREEK CAPITAL LETTER PSI}.
  
  Доступный в OS X v10.4 и позже.
- kCFStringTransformStripDiacritics
  
  kCFStringTransformStripDiacritics
  
  Идентификатор преобразования для удаления диакритических маркировок.
  
  Доступный в OS X v10.5 и позже.
Обсуждение

На OS X v10.4 и позже, с CFStringTransform можно также использовать любой допустимый ICU, преобразовывают ID, определенный в Руководство пользователя ICU для Преобразований.