NSMutableData

NSMutableData (и его суперкласс NSData) обеспечьте объекты данных, объектно-ориентированные обертки для буферов байта. Объекты данных позволяют простым выделенным буферам (т.е. данные без встроенных указателей) берут поведение объектов Основы. Они обычно используются для хранения данных и также полезны в Распределенных приложениях Объектов, где данные, содержавшиеся в объектах данных, могут быть скопированы или перемещены между приложениями. NSData создает статические объекты данных, и NSMutableData создает объекты динамических данных. Можно легко преобразовать один тип объекта данных к другому с инициализатором, берущим NSData возразите или NSMutableData возразите как параметр.

Следующий NSData методы изменяются, когда используется на непостоянном объекте данных:

Когда вызвано, байты сразу копируются, и затем буфер освобожден.

NSMutableData “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFDataRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации о бесплатном образовании моста.

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

NSObject
NSData
NSMutableData
NSPurgeableData

NSObject
NSData
NSMutableData
NSPurgeableData

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание и инициализация объекта NSMutableData

dataWithCapacity: + dataWithCapacity:

Создает и возвращается NSMutableData объект, способный к содержанию конкретного количества байтов.

Объявление

Objective C

+ (instancetype)dataWithCapacity:(NSUInteger)aNumItems

Параметры

aNumItems

Число байтов новый объект данных может первоначально содержать.

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

Новое NSMutableData объект, способный к содержанию aNumItems байты.

Обсуждение

Этот метод не обязательно выделяет требуемую память сразу же. Непостоянные объекты данных выделяют дополнительную память по мере необходимости, таким образом, aNumItems просто устанавливает начальную способность объекта. Когда это действительно выделяет начальную память, тем не менее, это выделяет указанную сумму. Этот метод устанавливает длину объекта данных к 0.

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

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

Objective C

@import Foundation;

Доступность

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

См. также

+ dataWithLength:
– initWithCapacity:
– initWithLength:
dataWithLength: + dataWithLength:

Создает и возвращается NSMutableData объект, содержащий данное число обнуленных байтов.

Объявление

Objective C

+ (instancetype)dataWithLength:(NSUInteger)length

Параметры

length

Число байтов новый объект данных первоначально содержит.

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

Новое NSMutableData объект length байты, заполненные нулями.

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

Objective C

@import Foundation;

Доступность

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

См. также

+ dataWithCapacity:
– initWithCapacity:
– initWithLength:
init (способность:) - initWithCapacity:

Возвращает инициализированный NSMutableData объект, способный к содержанию конкретного количества байтов.

Объявление

Swift

init?(capacity capacity: Int)

Objective C

- (instancetype)initWithCapacity:(NSUInteger)capacity

Параметры

capacity

Число байтов объект данных может первоначально содержать.

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

Инициализированный NSMutableData объект, способный к содержанию capacity байты.

Обсуждение

Этот метод не обязательно выделяет требуемую память сразу же. Непостоянные объекты данных выделяют дополнительную память по мере необходимости, таким образом, aNumItems просто устанавливает начальную способность объекта. Когда это действительно выделяет начальную память, тем не менее, это выделяет указанную сумму. Этот метод устанавливает длину объекта данных к 0.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ dataWithCapacity:
– initWithLength:
init (длина:) - initWithLength:

Инициализирует и возвращается NSMutableData объект, содержащий данное число обнуленных байтов.

Объявление

Swift

init?(length length: Int)

Objective C

- (instancetype)initWithLength:(NSUInteger)length

Параметры

length

Число байтов объект первоначально содержит.

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

Инициализированный NSMutableData объектный содержащий length обнуленные байты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ dataWithCapacity:
+ dataWithLength:
– initWithCapacity:

Корректировка способности

длина длина Свойство

Число байтов содержится в непостоянном объекте данных.

Объявление

Swift

var length: Int

Objective C

@property NSUInteger length

Обсуждение

Параметр длины непостоянного объекта данных читается-writeable. Можно установить этот параметр, чтобы развернуть или усечь число байтов, содержавших, по условию возражают. Если непостоянный объект данных расширен, дополнительные байты заполнены нулями.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– increaseLengthBy:
increaseLengthBy (_:) - increaseLengthBy:

Увеличивает длину получателя данным числом байтов.

Объявление

Swift

func increaseLengthBy(_ extraLength: Int)

Objective C

- (void)increaseLengthBy:(NSUInteger)extraLength

Параметры

extraLength

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

Обсуждение

Дополнительные байты все установлены в 0.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

длина

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

mutableBytes mutableBytes Свойство

Указатель на данные содержится непостоянным объектом данных. (только для чтения)

Объявление

Swift

var mutableBytes: UnsafeMutablePointer<Void> { get }

Objective C

@property(readonly) void *mutableBytes

Обсуждение

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

Примечание:

Это свойство подобно, но отличается, чем bytes свойство. bytes свойство содержит указатель на константу. Можно использовать bytes указатель для чтения данных, управляемых по условию, возражает, но Вы не можете изменить те данные. Однако, если mutableBytes свойство содержит не -null указатель, этот указатель указывает на непостоянные данные. Можно использовать mutableBytes указатель для изменения данных, управляемых по условию, возражает.

Выборка с помощью этого метода может быть найдена в Работе С Непостоянными Двоичными данными.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– байты

Добавление данных


    
    appendBytes (_: длина:)
    - appendBytes:length:

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

Объявление

Swift

func appendBytes(_ bytes: UnsafePointer<Void>, length length: Int)

Objective C

- (void)appendBytes:(const void *)bytes length:(NSUInteger)length

Параметры

`bytes`	Буферное, содержащее данные для добавления к содержанию получателя.
`length`	Число байтов от `bytes` добавлять.

Обсуждение

Выборка с помощью этого метода может быть найдена в Работе С Непостоянными Двоичными данными.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– appendData:


    
    appendData (_:)
    - appendData:

Добавляет содержание другого NSData возразите против получателя.

Объявление

Swift

func appendData(_ otherData: NSData)

Objective C

- (void)appendData:(NSData *)otherData

Параметры


      otherData

Объект данных, содержание которого должно быть добавлено к содержанию получателя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– appendBytes:length:

Изменение данных


    
    replaceBytesInRange (_: withBytes:)
    - replaceBytesInRange:withBytes:

Замены данным набором байтов данный диапазон в содержании получателя.

Объявление

Swift

func replaceBytesInRange(_ range: NSRange, withBytes bytes: UnsafePointer<Void>)

Objective C

- (void)replaceBytesInRange:(NSRange)range withBytes:(const void *)bytes

Параметры

`range`	Диапазон в содержании получателя для замены `bytes`. Диапазон не должен превышать границы получателя.
`bytes`	Данные для вставки в содержание получателя.

Обсуждение

Если расположение range не в диапазоне получателя байтов, NSRangeException повышен. Получатель изменен для размещения новых байтов, при необходимости.

Выборка с помощью этого метода дана в Работе С Непостоянными Двоичными данными.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– replaceBytesInRange:withBytes:length:
– resetBytesInRange:


    
    replaceBytesInRange (_: withBytes:length:)
    - replaceBytesInRange:withBytes:length:

Замены данным набором байтов данный диапазон в содержании получателя.

Объявление

Swift

func replaceBytesInRange(_ range: NSRange, withBytes replacementBytes: UnsafePointer<Void>, length replacementLength: Int)

Objective C

- (void)replaceBytesInRange:(NSRange)range withBytes:(const void *)replacementBytes length:(NSUInteger)replacementLength

Параметры

`range`	Диапазон в содержании получателя для замены `bytes`. Диапазон не должен превышать границы получателя.
`replacementBytes`	Данные для вставки в содержание получателя.
`replacementLength`	Число байтов для взятия от `replacementBytes`.

Обсуждение

Если длина range не равно replacementLength, получатель изменен для размещения новых байтов. Любые байты мимо range в получателе смещаются для размещения новых байтов. Можно поэтому передать NULL для replacementBytes и 0 для replacementLength удалить байты в получателе в диапазоне range. Можно также заменить диапазон (который мог бы быть нулевой длиной) с большим количеством байтов, чем длина диапазона, имеющего эффект вставки (или “заменяют некоторых и вставляют больше”).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– replaceBytesInRange:withBytes:


    
    resetBytesInRange (_:)
    - resetBytesInRange:

Замены обнуляют содержание получателя в данном диапазоне.

Объявление

Swift

func resetBytesInRange(_ range: NSRange)

Objective C

- (void)resetBytesInRange:(NSRange)range

Параметры


      range

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

Обсуждение

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– replaceBytesInRange:withBytes:

setData (_:) - setData:

Заменяет все содержание получателя с содержанием другого объекта данных.

Объявление

Swift

func setData(_ aData: NSData)

Objective C

- (void)setData:(NSData *)aData

Параметры

aData

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

Обсуждение

Как часть его реализации, это вызовы метода replaceBytesInRange:withBytes:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

NSMutableData

Создание и инициализация объекта NSMutableData

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

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

Доступность

См. также

Корректировка способности

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

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

Объявление

Обсуждение

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

Доступность

См. также

Добавление данных

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Доступность

См. также

Изменение данных

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение