Ссылка CFMutableData

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

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

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

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

Функции

Создание непостоянного объекта данных


    
    CFDataCreateMutable (_: _:)
    CFDataCreateMutable

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

Доступность

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


    
    CFDataCreateMutableCopy (_: _: _:)
    CFDataCreateMutableCopy

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

Доступность

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

Доступ к данным


    
    CFDataGetMutableBytePtr (_:)
    CFDataGetMutableBytePtr

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

Доступность

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

Изменение непостоянного объекта данных


    
    CFDataAppendBytes (_: _: _:)
    CFDataAppendBytes

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

Доступность

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


    
    CFDataDeleteBytes (_: _:)
    CFDataDeleteBytes

Удаляет байты в объекте 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

Доступность

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


    
    CFDataReplaceBytes (_: _: _: _:)
    CFDataReplaceBytes

Замены те байты в объекте 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

Доступность

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


    
    CFDataIncreaseLength (_: _:)
    CFDataIncreaseLength

Увеличивает длину внутреннего буфера байта объекта 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

Доступность

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


    
    CFDataSetLength (_: _:)
    CFDataSetLength

Сбрасывает длину внутреннего буфера байта объекта 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

Доступность

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

Типы данных

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

CFMutableDataRef CFMutableDataRef

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

Объявление

Swift

typealias CFMutableDataRef = CFMutableData

Objective C

typedef struct __CFData *CFMutableDataRef;

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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