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

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

Разработчик

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

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

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

Ссылка CFMutableData

Наследование


Не применимый

Соответствует


Не применимый

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


Swift

import CoreFoundation

Objective C

@import CoreFoundation;

CFMutableData управляет динамическими двоичными данными. Основной интерфейс для управления двоичными данными предоставлен CFData. CFMutableData добавляет функции для изменения содержания объекта двоичных данных.

Вы создаете непостоянный объект данных с помощью любого CFDataCreateMutable или CFDataCreateMutableCopy функция.

Байты добавляются к объекту данных с CFDataAppendBytes функция. Байты удалены из объекта данных с CFDataDeleteBytes функция.

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

Функции

  • Создает пустой объект CFMutableData.

    Объявление

    Swift

    func CFDataCreateMutable(_ allocator: CFAllocator!, _ capacity: CFIndex) -> CFMutableData!

    Objective C

    CFMutableDataRef CFDataCreateMutable ( CFAllocatorRef allocator, CFIndex capacity );

    Параметры

    allocator

    CFAllocator возражают, чтобы использоваться для выделения памяти для нового объекта. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    capacity

    Максимальное количество байтов, которые может содержать объект CFData. Объект CFData запускается пустой и может расти для содержания этого числа значений (и это может иметь меньше).

    Передача 0 указать, что не ограничивается максимальная способность. Значение не должно быть отрицательным.

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

    CFMutableData возражает или NULL если была проблема, создающая объект. Владение соблюдает Создать Правило.

    Обсуждение

    Эта функция создает пустое (т.е. содержание меньше) объект CFMutableData. Можно добавить необработанные данные к этому объекту с CFDataAppendBytes функция, и после того можно заменить и удалить символы с надлежащими функциями CFMutableData. Если capacity параметр больше, чем 0, любая попытка добавить символы вне этого предела может привести к неопределенному поведению.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Создает объект CFMutableData путем копирования другого объекта CFData.

    Объявление

    Swift

    func CFDataCreateMutableCopy(_ allocator: CFAllocator!, _ capacity: CFIndex, _ theData: CFData!) -> CFMutableData!

    Objective C

    CFMutableDataRef CFDataCreateMutableCopy ( CFAllocatorRef allocator, CFIndex capacity, CFDataRef theData );

    Параметры

    allocator

    CFAllocator возражают, чтобы использоваться для выделения памяти для нового объекта. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    capacity

    Максимальное количество байтов, которые может содержать объект CFData. Объект CFData запускается с той же длины как исходный объект и может расти для содержания этого числа байтов.

    Передача 0 указать, что не ограничивается максимальная способность. Если не -0, capacity должно быть больше, чем или равным длине theData.

    theData

    CFData возражают, чтобы быть скопированными.

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

    Объект CFMutableData, имеющий то же содержание как исходный объект. Возвраты NULL если была проблема, копируя объект. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Возвращает указатель на непостоянный буфер байта объекта CFMutableData.

    Объявление

    Swift

    func CFDataGetMutableBytePtr(_ theData: CFMutableData!) -> UnsafeMutablePointer<UInt8>

    Objective C

    UInt8 * CFDataGetMutableBytePtr ( CFMutableDataRef theData );

    Параметры

    theData

    Объект CFMutableData. При передаче неизменного объекта CFData поведение не определяется.

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

    Указатель на байты связался с theData.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Добавляет байты от буфера байта до содержания объекта CFData.

    Объявление

    Swift

    func CFDataAppendBytes(_ theData: CFMutableData!, _ bytes: UnsafePointer<UInt8>, _ length: CFIndex)

    Objective C

    void CFDataAppendBytes ( CFMutableDataRef theData, const UInt8 *bytes, CFIndex length );

    Параметры

    theData

    Объект CFMutableData. При передаче неизменного объекта CFData поведение не определяется.

    bytes

    Указатель на буфер байтов, которые будут добавлены к theData.

    length

    Число байтов в буфере байта bytes.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Удаляет байты в объекте CFMutableData в указанном диапазоне.

    Объявление

    Swift

    func CFDataDeleteBytes(_ theData: CFMutableData!, _ range: CFRange)

    Objective C

    void CFDataDeleteBytes ( CFMutableDataRef theData, CFRange range );

    Параметры

    theData

    Объект CFMutableData. При передаче неизменного объекта CFData поведение не определяется.

    range

    Диапазон байтов (т.е. стартового байта и числа байтов от той точки) для удаления из theDataбуфер байта.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Замены те байты в объекте CFMutableData, находящиеся в пределах указанного диапазона с другими байтами.

    Объявление

    Swift

    func CFDataReplaceBytes(_ theData: CFMutableData!, _ range: CFRange, _ newBytes: UnsafePointer<UInt8>, _ newLength: CFIndex)

    Objective C

    void CFDataReplaceBytes ( CFMutableDataRef theData, CFRange range, const UInt8 *newBytes, CFIndex newLength );

    Параметры

    theData

    Объект CFMutableData. При передаче неизменного объекта CFData поведение не определяется.

    range

    Диапазон байтов (т.е. стартового байта и числа байтов от той точки) для удаления из theDataбуфер байта.

    newBytes

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

    newLength

    Число байтов в буфере байта newBytes.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • Увеличивает длину внутреннего буфера байта объекта CFMutableData, заполняя нулями расширение буфера.

    Объявление

    Swift

    func CFDataIncreaseLength(_ theData: CFMutableData!, _ extraLength: CFIndex)

    Objective C

    void CFDataIncreaseLength ( CFMutableDataRef theData, CFIndex extraLength );

    Параметры

    theData

    Объект CFMutableData. При передаче неизменного объекта CFData поведение не определяется.

    extraLength

    Число байтов, которыми можно увеличить буфер байта.

    Обсуждение

    Эта функция увеличивает длину базового буфера байта объекта CFMutableData к новому размеру, инициализируя новые байты к 0.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Swift

    func CFDataSetLength(_ theData: CFMutableData!, _ length: CFIndex)

    Objective C

    void CFDataSetLength ( CFMutableDataRef theData, CFIndex length );

    Параметры

    theData

    Объект CFMutableData. При передаче неизменного объекта CFData поведение не определяется.

    length

    Новый размер theDataбуфер байта.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

Типы данных

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

  • Ссылка на объект CFMutableData.

    Объявление

    Swift

    typealias CFMutableDataRef = CFMutableData

    Objective C

    typedef struct __CFData *CFMutableDataRef;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.