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

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

Разработчик

Ссылка платформы основы ссылка класса NSMutableData

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

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

NSMutableData

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

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

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

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

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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


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

    Объявление

    Objective C

    + (instancetype)dataWithCapacity:(NSUInteger)aNumItems

    Параметры

    aNumItems

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

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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Доступность

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

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

    Объявление

    Objective C

    + (instancetype)dataWithLength:(NSUInteger)length

    Параметры

    length

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

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

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

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

    Objective C

    @import Foundation;

    Доступность

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

  • Возвращает инициализированный 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 и позже.

  • Инициализирует и возвращается 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 и позже.

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

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

    Объявление

    Swift

    var length: Int

    Objective C

    @property NSUInteger length

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – 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 зависящий от многих факторов имел отношение к тому, как объект создавался (кроме того, в этом случае результат метода мог бы измениться между различными выпусками).

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – байты

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

    Объявление

    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:

  • Добавляет содержание другого 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:

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    Swift

    func resetBytesInRange(_ range: NSRange)

    Objective C

    - (void)resetBytesInRange:(NSRange)range

    Параметры

    range

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    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 и позже.