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

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

Разработчик

Ссылка платформы CoreFoundation ссылка CFMutableString

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

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

Ссылка 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 и позже.

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

    Доступность

    Доступный в 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) -> 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

    Доступность

    Доступный в 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 для Преобразований.