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

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

Разработчик

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

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

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

NSData

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

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

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

Размер данных подвергается теоретическому пределу приблизительно 8 эксабайт (на практике, предел не должен быть фактором).

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

Сохранение данных

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

В то время как атомарные операции записи минимизируют риск потери данных вследствие поврежденных или частично записанных файлов, они могут не быть надлежащими при записи во временный каталог, корневой каталог пользователя или другие публично доступные каталоги. Любое время Вы работаете с публично доступным файлом, необходимо обработать тот файл как недоверяемый и потенциально опасный ресурс. Атакующий может поставить под угрозу или повредить эти файлы. Атакующий может также заменить файлы жесткими или символьными ссылками, заставив Ваши операции записи перезаписать или повредить другие системные ресурсы.

Избегайте использования writeToURL:atomically: метод (и связанные методы) при работе в публично доступном каталоге. Вместо этого инициализируйте NSFileHandle объект с существующим дескриптором файла и использованием NSFileHandle методы для безопасной записи файла.

Для получения дополнительной информации посмотрите Операции Файла Обеспечения в Безопасном Руководстве по Кодированию.

Создание объектов данных
  • + данные

    Создает и возвращает пустой объект данных.

    Объявление

    Objective C

    + (instancetype)data

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

    Пустой объект данных.

    Обсуждение

    Этот метод объявляется прежде всего для использования непостоянных подклассов NSData.

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

    Objective C

    @import Foundation;

    Доступность

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

  • + dataWithBytes:length:

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

    Объявление

    Objective C

    + (instancetype)dataWithBytes:(const void *)bytes length:(NSUInteger)length

    Параметры

    bytes

    Буферное, содержащее данные для нового объекта.

    length

    Число байтов для копирования с bytes. Это значение не должно превышать длину bytes.

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

    Объект данных, содержащий length байты скопированы с буфера bytes. Возвраты nil если не мог бы быть создан объект данных.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + dataWithBytesNoCopy:length:
    + dataWithBytesNoCopy:length:freeWhenDone:

  • + dataWithBytesNoCopy:length:

    Создает и возвращает содержащий объект данных length байты от буфера bytes.

    Объявление

    Objective C

    + (instancetype)dataWithBytesNoCopy:(void *)bytes length:(NSUInteger)length

    Параметры

    bytes

    Буферное, содержащее данные для нового объекта. bytes должен указать на блок памяти, выделенный с malloc.

    length

    Число байтов для содержания от bytes. Это значение не должно превышать длину bytes.

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

    Содержащий объект данных length байты от буфера bytes. Возвраты nil если не мог бы быть создан объект данных.

    Обсуждение

    Возвращенный объект берет владение bytes указатель и освобождает его на освобождении. Поэтому bytes должен указать на блок памяти, выделенный с malloc.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + dataWithBytes:length:
    + dataWithBytesNoCopy:length:freeWhenDone:

  • + dataWithBytesNoCopy:length:freeWhenDone:

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

    Объявление

    Objective C

    + (instancetype)dataWithBytesNoCopy:(void *)bytes length:(NSUInteger)length freeWhenDone:(BOOL)freeWhenDone

    Параметры

    bytes

    Буферное, содержащее данные для нового объекта. Если freeWhenDone YEStrue, bytes должен указать на блок памяти, выделенный с malloc.

    length

    Число байтов для содержания от bytes. Это значение не должно превышать длину bytes.

    freeWhenDone

    Если YEStrue, возвращенный объект берет владение bytes указатель и освобождает его на освобождении.

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

    Содержащий объект данных length байты от буфера bytes. Возвраты nil если не мог бы быть создан объект данных.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + dataWithBytes:length:
    + dataWithBytesNoCopy:length:

  • + dataWithContentsOfFile:

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

    Объявление

    Objective C

    + (instancetype)dataWithContentsOfFile:(NSString *)path

    Параметры

    path

    Абсолютный путь файла, из которого можно считать данные.

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

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

    Обсуждение

    Этот метод эквивалентен dataWithContentsOfFile:options:error: без опций. Если необходимо знать то, что было причиной отказа, использовать dataWithContentsOfFile:options:error:.

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

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + dataWithContentsOfFile:options:error:
    + dataWithContentsOfMappedFile:

  • + dataWithContentsOfFile:options:error:

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

    Объявление

    Objective C

    + (instancetype)dataWithContentsOfFile:(NSString *)path options:(NSDataReadingOptions)mask error:(NSError **)errorPtr

    Параметры

    path

    Абсолютный путь файла, из которого можно считать данные.

    mask

    Маска, указывающая опции для чтения данных. Постоянные компоненты описаны в “NSDataReadingOptions”.

    errorPtr

    Если ошибка происходит, по возврату содержит NSError объект, описывающий проблему.

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

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

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

    Objective C

    @import Foundation;

    Доступность

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

  • dataWithContentsOfMappedFile (_:) + dataWithContentsOfMappedFile: (iOS 8.0)

    Создает и возвращает объект данных из отображенного файла, указанного path.

    Объявление

    Swift

    class func dataWithContentsOfMappedFile(_ path: String) -> AnyObject?

    Objective C

    + (id)dataWithContentsOfMappedFile:(NSString *)path

    Параметры

    path

    Абсолютный путь файла, из которого можно считать данные.

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

    Объект данных от отображенного файла, указанного path. Возвраты nil если не мог бы быть создан объект данных.

    Обсуждение

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

    Это методы принимают отображенные файлы, доступно от базовой операционной системы. Отображенный файл использует методы виртуальной памяти, чтобы избежать копировать страницы файла в память, пока они не фактически необходимы.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    Осуждаемый в iOS 8.0.

    См. также

    + dataWithContentsOfFile:

  • + dataWithContentsOfURL:

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

    Объявление

    Objective C

    + (instancetype)dataWithContentsOfURL:(NSURL *)aURL

    Параметры

    aURL

    URL, из которого можно считать данные.

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

    Объект данных, содержащий данные от расположения, указанного aURL. Возвраты nil если не мог бы быть создан объект данных.

    Обсуждение

    Этот метод идеален для преобразования data:// URLs к NSData объекты, и могут также использоваться для чтения коротких файлов синхронно. Если необходимо считать потенциально большие файлы, использовать inputStreamWithURL: для открытия потока затем считайте файл часть за один раз.

    Если необходимо знать причину отказа, использовать dataWithContentsOfURL:options:error:.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + dataWithContentsOfURL:options:error:
    – initWithContentsOfURL:

  • + dataWithContentsOfURL:options:error:

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

    Объявление

    Objective C

    + (instancetype)dataWithContentsOfURL:(NSURL *)aURL options:(NSDataReadingOptions)mask error:(NSError **)errorPtr

    Параметры

    aURL

    URL, из которого можно считать данные.

    mask

    Маска, указывающая опции для чтения данных. Постоянные компоненты описаны в “NSDataReadingOptions”.

    errorPtr

    Если существует ошибка при чтении в данных, по возврату содержит NSError объект, описывающий проблему.

    Обсуждение

    Этот метод идеален для преобразования data:// URLs к NSData объекты, и могут также использоваться для чтения коротких файлов синхронно. Если необходимо считать потенциально большие файлы, использовать inputStreamWithURL: для открытия потока затем считайте файл часть за один раз.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithContentsOfURL:

  • + dataWithData:

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

    Объявление

    Objective C

    + (instancetype)dataWithData:(NSData *)aData

    Параметры

    aData

    Объект данных.

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

    Объект данных, содержащий содержание aData. Возвраты nil если не мог бы быть создан объект данных.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithData:

  • init (base64EncodedData:options:) - initWithBase64EncodedData:options:

    Возвращает объект данных, инициализированный с данной Основой 64 закодированных данных.

    Объявление

    Swift

    init?(base64EncodedData base64Data: NSData, options options: NSDataBase64DecodingOptions)

    Objective C

    - (instancetype)initWithBase64EncodedData:(NSData *)base64Data options:(NSDataBase64DecodingOptions)options

    Параметры

    base64Data

    Основа 64, UTF-8 закодировал объект данных.

    options

    Маска, указывающая опции для Основы 64 декодирования данных. Поданы возможные значения “NSDataBase64DecodingOptions”.

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

    Объект данных, содержащий Основу 64 декодируемых данных. Возвраты nil если не мог бы декодироваться объект данных.

    Обсуждение

    Реализация по умолчанию этого метода отклонит символы неалфавита, включая символы разрыва строки. Чтобы поддерживать различные кодировки и проигнорировать символы неалфавита, укажите options значение NSDataBase64DecodingIgnoreUnknownCharacters.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • init (base64EncodedString:options:) - initWithBase64EncodedString:options:

    Возвращает объект данных, инициализированный с данной Основой 64 закодированных строки.

    Объявление

    Swift

    init?(base64EncodedString base64String: String, options options: NSDataBase64DecodingOptions)

    Objective C

    - (instancetype)initWithBase64EncodedString:(NSString *)base64String options:(NSDataBase64DecodingOptions)options

    Параметры

    base64String

    Основа 64 закодированных строки.

    options

    Маска, указывающая опции для Основы 64 декодирования данных. Поданы возможные значения “NSDataBase64DecodingOptions”.

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

    Объект данных, созданный Основой 64 декодирования предоставленной строки. Возвраты nil если не мог бы декодироваться объект данных.

    Обсуждение

    Реализация по умолчанию этого метода отклонит символы неалфавита, включая символы разрыва строки. Чтобы поддерживать различные кодировки и проигнорировать символы неалфавита, укажите options значение NSDataBase64DecodingIgnoreUnknownCharacters.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • - initWithBase64Encoding: (iOS 7.0)

    Возвращает объект данных, инициализированный с данной Основой 64 закодированных строки.

    Оператор осуждения

    Необходимо перейти к также initWithBase64EncodedString:options: или initWithBase64EncodedData:options:.

    Объявление

    Objective C

    - (id)initWithBase64Encoding:(NSString *)base64String

    Параметры

    base64String

    Основа 64 закодированных строки.

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

    Объект данных, созданный Основой 64 декодирования предоставленной строки. Возвраты nil если не мог бы декодироваться объект данных.

    Специальные замечания

    Несмотря на то, что этот метод был только внедрен публично для iOS 7, он существовал начиная с iOS 4; если приложение должно предназначаться для операционной системы до iOS 7, можно использовать его. Этот метод ведет себя как initWithBase64EncodedString:options:, но игнорирует все неизвестные символы.

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

    Objective C

    @import Foundation;

    Доступность

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

    Осуждаемый в iOS 7.0.

  • init (bytes:length:) - initWithBytes:length:

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

    Объявление

    Swift

    init(bytes bytes: UnsafePointer<Void>, length length: Int)

    Objective C

    - (instancetype)initWithBytes:(const void *)bytes length:(NSUInteger)length

    Обсуждение

    Объект данных, инициализированный путем добавления к нему length байты данных скопированы с буфера bytes. Возвращенный объект мог бы отличаться, чем исходный получатель.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithBytes:length:
    – initWithBytesNoCopy:length:
    – initWithBytesNoCopy:length:freeWhenDone:

  • init (bytesNoCopy:length:) - initWithBytesNoCopy:length:

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

    Объявление

    Swift

    init(bytesNoCopy bytes: UnsafeMutablePointer<Void>, length length: Int)

    Objective C

    - (instancetype)initWithBytesNoCopy:(void *)bytes length:(NSUInteger)length

    Параметры

    bytes

    Буферное, содержащее данные для нового объекта. bytes должен указать на блок памяти, выделенный с malloc.

    length

    Число байтов для содержания от bytes. Это значение не должно превышать длину bytes.

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

    Объект данных, инициализированный путем добавления к нему length байты данных от буфера bytes. Возвращенный объект мог бы отличаться, чем исходный получатель.

    Обсуждение

    Возвращенный объект берет владение bytes указатель и освобождает его на освобождении. Поэтому bytes должен указать на блок памяти, выделенный с malloc.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithBytes:length:
    – initWithBytes:length:
    – initWithBytesNoCopy:length:freeWhenDone:

  • init (bytesNoCopy:length:deallocator:) - initWithBytesNoCopy:length:deallocator:

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

    Объявление

    Swift

    init(bytesNoCopy bytes: UnsafeMutablePointer<Void>, length length: Int, deallocator deallocator: ((UnsafeMutablePointer<Void>, Int) -> Void)?)

    Objective C

    - (instancetype)initWithBytesNoCopy:(void *)bytes length:(NSUInteger)length deallocator:(void (^)(void *bytes, NSUInteger length))deallocator

    Параметры

    bytes

    Буферное, содержащее данные для нового объекта.

    length

    Число байтов для содержания от bytes. Это значение не должно превышать длину bytes.

    deallocator

    Блок для вызова, когда получающееся NSData объект освобожден.

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

    Объект данных, инициализированный путем добавления к нему length байты данных от буфера bytes. Возвращенный объект мог бы отличаться, чем исходный получатель.

    Обсуждение

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

    Во избежание любых непреднамеренных циклов сильной ссылки необходимо избежать получать указатели на любые объекты, которые могут поочередно поддержать сильные ссылки к NSData объект. Это включает прямые ссылки на self, и неявные ссылки на self вследствие прямого доступа переменной экземпляра. Упростить избегать этих ссылок, deallocator блок берет два параметра, указатель на buffer, и его длина; необходимо всегда использовать эти значения вместо того, чтобы пытаться использовать ссылки извне блока.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • init (bytesNoCopy:length:freeWhenDone:) - initWithBytesNoCopy:length:freeWhenDone:

    Инициализирует недавно выделенный объект данных путем добавления к нему length байты данных от буфера bytes.

    Объявление

    Swift

    init(bytesNoCopy bytes: UnsafeMutablePointer<Void>, length length: Int, freeWhenDone flag: Bool)

    Objective C

    - (instancetype)initWithBytesNoCopy:(void *)bytes length:(NSUInteger)length freeWhenDone:(BOOL)flag

    Параметры

    bytes

    Буферное, содержащее данные для нового объекта. Если flag YEStrue, bytes должен указать на блок памяти, выделенный с malloc.

    length

    Число байтов для содержания от bytes. Это значение не должно превышать длину bytes.

    flag

    Если YEStrue, возвращенный объект берет владение bytes указатель и освобождает его на освобождении.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithBytesNoCopy:length:freeWhenDone:
    – initWithBytes:length:
    – initWithBytesNoCopy:length:

  • init (contentsOfFile:) - initWithContentsOfFile:

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

    Объявление

    Swift

    init?(contentsOfFile path: String)

    Objective C

    - (instancetype)initWithContentsOfFile:(NSString *)path

    Параметры

    path

    Абсолютный путь файла, из которого можно считать данные.

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

    Объект данных, инициализированный путем считывания в него данных от файла, указанного path. Возвращенный объект мог бы отличаться, чем исходный получатель.

    Обсуждение

    Этот метод эквивалентен initWithContentsOfFile:options:error: без опций.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithContentsOfFile:
    – initWithContentsOfMappedFile:

  • init (contentsOfFile:options:error:) - initWithContentsOfFile:options:error:

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

    Объявление

    Swift

    init?(contentsOfFile path: String, options mask: NSDataReadingOptions, error errorPtr: NSErrorPointer)

    Objective C

    - (instancetype)initWithContentsOfFile:(NSString *)path options:(NSDataReadingOptions)mask error:(NSError **)errorPtr

    Параметры

    path

    Абсолютный путь файла, из которого можно считать данные.

    mask

    Маска, указывающая опции для чтения данных. Постоянные компоненты описаны в “NSDataReadingOptions”.

    errorPtr

    Если ошибка происходит, по возврату содержит NSError объект, описывающий проблему.

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

    Объект данных, инициализированный путем считывания в него данных от файла, указанного path. Возвращенный объект мог бы отличаться, чем исходный получатель.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithContentsOfFile:options:error:

  • init (contentsOfMappedFile:) - initWithContentsOfMappedFile: (iOS 8.0)

    Возвращает объект данных, инициализированный путем чтения в него отображенного файла, указанного данным путем.

    Объявление

    Swift

    init?(contentsOfMappedFile path: String)

    Objective C

    - (id)initWithContentsOfMappedFile:(NSString *)path

    Параметры

    path

    Абсолютный путь файла, из которого можно считать данные.

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

    Объект данных, инициализированный путем чтения в него отображенного файла, указанного path. Возвращенный объект мог бы отличаться, чем исходный получатель.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    Осуждаемый в iOS 8.0.

    См. также

    + dataWithContentsOfMappedFile:
    – initWithContentsOfFile:

  • init (contentsOfURL:) - initWithContentsOfURL:

    Инициализирует недавно выделенный объект данных, инициализированный с данными от расположения, указанного aURL.

    Объявление

    Swift

    init?(contentsOfURL aURL: NSURL)

    Objective C

    - (instancetype)initWithContentsOfURL:(NSURL *)aURL

    Параметры

    aURL

    URL, из которого можно считать данные

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

    NSData объект, инициализированный с данными от расположения, указанного aURL. Возвращенный объект мог бы отличаться, чем исходный получатель.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithContentsOfURL:

  • init (contentsOfURL:options:error:) - initWithContentsOfURL:options:error:

    Возвращает объект данных, инициализированный с данными от расположения, указанного данным URL.

    Объявление

    Swift

    init?(contentsOfURL aURL: NSURL, options mask: NSDataReadingOptions, error errorPtr: NSErrorPointer)

    Objective C

    - (instancetype)initWithContentsOfURL:(NSURL *)aURL options:(NSDataReadingOptions)mask error:(NSError **)errorPtr

    Параметры

    aURL

    URL, из которого можно считать данные.

    mask

    Маска, указывающая опции для чтения данных. Постоянные компоненты описаны в “NSDataReadingOptions”.

    errorPtr

    Если существует ошибка при чтении в данных, по возврату содержит NSError объект, описывающий проблему.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithContentsOfURL:options:error:

  • init (данные:) - initWithData:

    Возвращает объект данных, инициализированный с содержанием другого объекта данных.

    Объявление

    Swift

    init(data data: NSData)

    Objective C

    - (instancetype)initWithData:(NSData *)data

    Параметры

    data

    Объект данных.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + dataWithData:

Доступ к данным
  • bytes Свойство

    Указатель на содержание получателя. (только для чтения)

    Объявление

    Swift

    var bytes: UnsafePointer<Void> { get }

    Objective C

    @property(readonly) const void *bytes

    Обсуждение

    Если length из NSData объект 0, этот метод возвраты nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    описание
    – getBytes:
    – getBytes:length:
    – getBytes:range:

  • description Свойство

    Строка, содержащая шестнадцатеричное представление содержания объекта в формате списка свойств. (только для чтения)

    Объявление

    Swift

    var description: String { get }

    Objective C

    @property(readonly, copy) NSString *description

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    байты
    – getBytes:
    – getBytes:length:
    – getBytes:range:

  • enumerateByteRangesUsingBlock (_:) - enumerateByteRangesUsingBlock:

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

    Объявление

    Swift

    func enumerateByteRangesUsingBlock(_ block: (UnsafePointer<Void>, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)

    Objective C

    - (void)enumerateByteRangesUsingBlock:(void (^)(const void *bytes, NSRange byteRange, BOOL *stop))block

    Параметры

    block

    Блок для применения к байту располагается в массиве.

    Блок берет три параметра:

    bytes

    Байты для текущего диапазона.

    byteRange

    Диапазон текущих байтов данных.

    stop

    Ссылка на булево значение. Блок может установить значение в YEStrue остановить последующую обработку данных. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в YEStrue в Блоке.

    Обсуждение

    Блок перечисления вызывают один раз для каждой непрерывной области памяти в получателе (один раз общее количество для непрерывного NSData объект), или до все байты были перечислены, или до stop параметр устанавливается на YEStrue.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • getBytes (_:) - getBytes: (iOS 8.0)

    Копирует содержание объекта данных в данный буфер.

    Оператор осуждения

    Этот метод небезопасен, потому что он мог потенциально вызвать переполнение буфера. Необходимо использовать getBytes:length: или getBytes:range: вместо этого.

    Объявление

    Swift

    func getBytes(_ buffer: UnsafeMutablePointer<Void>)

    Objective C

    - (void)getBytes:(void *)buffer

    Параметры

    buffer

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

    Обсуждение

    Вы видите, что выборка использует этот метод в Работе С Двоичными данными.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    Осуждаемый в iOS 8.0.

    См. также

    байты
    описание
    – getBytes:length:
    – getBytes:range:

  • getBytes (_: длина:) - getBytes:length:

    Копии многие байты от запуска данных получателя в данный буфер.

    Объявление

    Swift

    func getBytes(_ buffer: UnsafeMutablePointer<Void>, length length: Int)

    Objective C

    - (void)getBytes:(void *)buffer length:(NSUInteger)length

    Параметры

    buffer

    Буфер, в который можно скопировать данные.

    length

    Число байтов от запуска данных получателя для копирования в buffer.

    Обсуждение

    Число скопированных байтов является меньшим из length параметр и length из данных, инкапсулировавших в объекте.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    байты
    описание
    – getBytes:
    – getBytes:range:

  • getBytes (_: диапазон:) - getBytes:range:

    Копирует диапазон байтов от данных получателя в данный буфер.

    Объявление

    Swift

    func getBytes(_ buffer: UnsafeMutablePointer<Void>, range range: NSRange)

    Objective C

    - (void)getBytes:(void *)buffer range:(NSRange)range

    Параметры

    buffer

    Буфер, в который можно скопировать данные.

    range

    Диапазон байтов в данных получателя для копирования в buffer. Диапазон должен лечь в диапазоне байтов данных получателя.

    Обсуждение

    Если range не в диапазоне получателя байтов, NSRangeException повышен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    байты
    описание
    – getBytes:
    – getBytes:length:

  • subdataWithRange (_:) - subdataWithRange:

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

    Объявление

    Swift

    func subdataWithRange(_ range: NSRange) -> NSData

    Objective C

    - (NSData *)subdataWithRange:(NSRange)range

    Параметры

    range

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • rangeOfData (_: options:range:) - rangeOfData:options:range:

    Находит и возвращает диапазон первого возникновения определенных данных, в данном диапазоне согласно данным опциям.

    Объявление

    Swift

    func rangeOfData(_ dataToFind: NSData, options mask: NSDataSearchOptions, range searchRange: NSRange) -> NSRange

    Objective C

    - (NSRange)rangeOfData:(NSData *)dataToFind options:(NSDataSearchOptions)mask range:(NSRange)searchRange

    Параметры

    dataToFind

    Данные, которые можно искать. Это значение не должно быть nil.

    mask

    Маска, указывающая параметры поиска. Опции NSDataSearchOptions могут быть указаны отдельно или путем объединения их с C поразрядно OR оператор.

    searchRange

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

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

    NSRange структура, дающая расположение и длину dataToFind в searchRange, по модулю опции в mask. Диапазон возвратился, относительно запуска искавших данных, не переданного - в поисковом диапазоне. Возвраты {NSNotFound, 0} если dataToFind не найден или пуст (@"").

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Кодировка Base 64
  • base64EncodedDataWithOptions (_:) - base64EncodedDataWithOptions:

    Заложите Основу 64, закодированный UTF-8 NSData от содержания получателя с помощью данных опций.

    Объявление

    Swift

    func base64EncodedDataWithOptions(_ options: NSDataBase64EncodingOptions) -> NSData

    Objective C

    - (NSData *)base64EncodedDataWithOptions:(NSDataBase64EncodingOptions)options

    Параметры

    options

    Маска, указывающая опции для Кодировки Base 64 данные. Поданы возможные значения “NSDataBase64EncodingOptions”.

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

    Основа 64, UTF-8 закодировал объект данных.

    Обсуждение

    По умолчанию никакие окончания строки не вставляются.

    Если Вы указываете одну из опций длины строки (NSDataBase64Encoding64CharacterLineLength или NSDataBase64Encoding76CharacterLineLength) но не указывайте вид строки, заканчивающейся для вставки, окончанием строки по умолчанию является Возврат каретки + Перевод строки.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • base64EncodedStringWithOptions (_:) - base64EncodedStringWithOptions:

    Заложите Основу 64 закодированных NSString от содержания получателя с помощью данных опций.

    Объявление

    Swift

    func base64EncodedStringWithOptions(_ options: NSDataBase64EncodingOptions) -> String

    Objective C

    - (NSString *)base64EncodedStringWithOptions:(NSDataBase64EncodingOptions)options

    Параметры

    options

    Маска, указывающая опции для Кодировки Base 64 данные. Поданы возможные значения “NSDataBase64EncodingOptions”.

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

    Основа 64 закодированных строки.

    Обсуждение

    По умолчанию никакие окончания строки не вставляются.

    Если Вы указываете одну из опций длины строки (NSDataBase64Encoding64CharacterLineLength или NSDataBase64Encoding76CharacterLineLength) но не указывайте вид строки, заканчивающейся для вставки, окончанием строки по умолчанию является Возврат каретки + Перевод строки.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • - base64Encoding (iOS 7.0)

    Заложите Основу 64 закодированных NSString от содержания получателя.

    Оператор осуждения

    Необходимо перейти к также base64EncodedStringWithOptions: или base64EncodedDataWithOptions:

    Объявление

    Objective C

    - (NSString *)base64Encoding

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

    Основа 64 закодированных строки.

    Специальные замечания

    Несмотря на то, что этот метод был только внедрен публично для iOS 7, он существовал начиная с iOS 4; если приложение должно предназначаться для операционной системы до iOS 7, можно использовать его. Этот метод ведет себя как base64EncodedStringWithOptions:, но игнорирует все неизвестные символы.

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

    Objective C

    @import Foundation;

    Доступность

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

    Осуждаемый в iOS 7.0.

Тестирование данных
  • isEqualToData (_:) - isEqualToData:

    Сравнивает объект данных получения с otherData.

    Объявление

    Swift

    func isEqualToData(_ otherData: NSData) -> Bool

    Objective C

    - (BOOL)isEqualToData:(NSData *)otherData

    Параметры

    otherData

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

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

    YEStrue если содержание otherData равны содержанию получателя, иначе NOfalse.

    Обсуждение

    Два объекта данных равны, если они содержат то же число байтов, и если байты в той же позиции в объектах являются тем же.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • length Свойство

    Число байтов, содержавших по условию, возражает. (только для чтения)

    Объявление

    Swift

    var length: Int { get }

    Objective C

    @property(readonly) NSUInteger length

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Хранить данные
  • writeToFile (_: атомарно:) - writeToFile:atomically:

    Пишут байты в получателе к файлу, указанному данным путем.

    Объявление

    Swift

    func writeToFile(_ path: String, atomically atomically: Bool) -> Bool

    Objective C

    - (BOOL)writeToFile:(NSString *)path atomically:(BOOL)atomically

    Параметры

    path

    Расположение, в которое можно записать байты получателя. Если path содержит тильду (~) символ, необходимо развернуть его с stringByExpandingTildeInPath прежде, чем вызвать этот метод.

    atomically

    Если YEStrue, данные записаны в файл резервной копии, и затем — предполагающий, что никакие ошибки не происходят — файл резервной копии переименован к имени, указанному path; иначе, данные записаны непосредственно в path.

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

    YEStrue если работа успешно выполняется, иначе NOfalse.

    Обсуждение

    Этот метод может не быть надлежащим при записи в публично доступные файлы. Для безопасной записи данных в общедоступное расположение использовать NSFileHandle вместо этого. Для получения дополнительной информации, seeSecuring Операции Файла в Безопасном Руководстве по Кодированию.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – writeToURL:atomically:

  • writeToFile (_: options:error:) - writeToFile:options:error:

    Пишут байты в получателе к файлу, указанному данным путем.

    Объявление

    Swift

    func writeToFile(_ path: String, options mask: NSDataWritingOptions, error errorPtr: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)writeToFile:(NSString *)path options:(NSDataWritingOptions)mask error:(NSError **)errorPtr

    Параметры

    path

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

    mask

    Маска, указывающая опции для записи данных. Постоянные компоненты описаны в “NSDataWritingOptions”.

    errorPtr

    Если существует ошибка при выписывании данных, по возврату содержит NSError объект, описывающий проблему.

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

    YEStrue если работа успешно выполняется, иначе NOfalse.

    Обсуждение

    Этот метод может не быть надлежащим при записи в публично доступные файлы. Для безопасной записи данных в общедоступное расположение использовать NSFileHandle вместо этого. Для получения дополнительной информации, seeSecuring Операции Файла в Безопасном Руководстве по Кодированию.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – writeToURL:options:error:

  • writeToURL (_: атомарно:) - writeToURL:atomically:

    Пишут байты в получателе к расположению, указанному aURL.

    Объявление

    Swift

    func writeToURL(_ aURL: NSURL, atomically atomically: Bool) -> Bool

    Objective C

    - (BOOL)writeToURL:(NSURL *)aURL atomically:(BOOL)atomically

    Параметры

    aURL

    Расположение, в которое можно записать байты получателя. Только file:// URLs поддерживается.

    atomically

    Если YEStrue, данные записаны в местоположение резервирных копий, и затем — предполагающий, что никакие ошибки не происходят — местоположение резервирных копий переименовано к имени, указанному aURL; иначе, данные записаны непосредственно в aURL. atomically проигнорирован если aURL не имеет типа поддержки атомарные записи.

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

    YEStrue если работа успешно выполняется, иначе NOfalse.

    Обсуждение

    С тех пор в настоящее время только file:// URLs поддерживается, нет никакого различия между этим методом и writeToFile:atomically: за исключением типа первого параметра.

    Этот метод может не быть надлежащим при записи в публично доступные файлы. Для безопасной записи данных в общедоступное расположение использовать NSFileHandle вместо этого. Для получения дополнительной информации, seeSecuring Операции Файла в Безопасном Руководстве по Кодированию.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – writeToFile:atomically:

  • writeToURL (_: options:error:) - writeToURL:options:error:

    Пишут байты в получателе к расположению, указанному данным URL.

    Объявление

    Swift

    func writeToURL(_ aURL: NSURL, options mask: NSDataWritingOptions, error errorPtr: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)writeToURL:(NSURL *)aURL options:(NSDataWritingOptions)mask error:(NSError **)errorPtr

    Параметры

    aURL

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

    mask

    Маска, указывающая опции для записи данных. Постоянные компоненты описаны в “NSDataWritingOptions”.

    errorPtr

    Если существует ошибка при выписывании данных, по возврату содержит NSError объект, описывающий проблему.

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

    YEStrue если работа успешно выполняется, иначе NOfalse.

    Обсуждение

    С тех пор в настоящее время только file:// URLs поддерживается, нет никакого различия между этим методом и writeToFile:options:error:, за исключением типа первого параметра.

    Этот метод может не быть надлежащим при записи в публично доступные файлы. Для безопасной записи данных в общедоступное расположение использовать NSFileHandle вместо этого. Для получения дополнительной информации, seeSecuring Операции Файла в Безопасном Руководстве по Кодированию.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – writeToFile:options:error:

Константы
  • NSDataReadingOptions

    Опции для методов раньше читали NSData объекты.

    Объявление

    Swift

    struct NSDataReadingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var DataReadingMappedIfSafe: NSDataReadingOptions { get } static var DataReadingUncached: NSDataReadingOptions { get } static var DataReadingMappedAlways: NSDataReadingOptions { get } static var DataReadingMapped: NSDataReadingOptions { get } static var MappedRead: NSDataReadingOptions { get } static var UncachedRead: NSDataReadingOptions { get } }

    Objective C

    enum { NSDataReadingMappedIfSafe = 1UL << 0, NSDataReadingUncached = 1UL << 1, NSDataReadingMappedAlways = 1UL << 3, }; typedef NSUInteger NSDataReadingOptions;

    Константы

    • DataReadingMappedIfSafe

      NSDataReadingMappedIfSafe

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

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

    • DataReadingUncached

      NSDataReadingUncached

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

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

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

    • DataReadingMappedAlways

      NSDataReadingMappedAlways

      Подскажите для отображения файла в, если это возможно.

      Это имеет приоритет NSDataReadingMappedIfSafe если обоим дают.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • NSDataBase64EncodingOptions

    Опции для методов раньше Базировались 64, кодируют данные.

    Объявление

    Swift

    struct NSDataBase64EncodingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Encoding64CharacterLineLength: NSDataBase64EncodingOptions { get } static var Encoding76CharacterLineLength: NSDataBase64EncodingOptions { get } static var EncodingEndLineWithCarriageReturn: NSDataBase64EncodingOptions { get } static var EncodingEndLineWithLineFeed: NSDataBase64EncodingOptions { get } }

    Objective C

    enum { NSDataBase64Encoding64CharacterLineLength = 1UL << 0, NSDataBase64Encoding76CharacterLineLength = 1UL << 1, NSDataBase64EncodingEndLineWithCarriageReturn = 1UL << 4, NSDataBase64EncodingEndLineWithLineFeed = 1UL << 5, }; typedef NSUInteger NSDataBase64EncodingOptions;

    Константы

    • Encoding64CharacterLineLength

      NSDataBase64Encoding64CharacterLineLength

      Установите максимальную длину строки в 64 символа, после которых вставляется окончание строки.

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

    • Encoding76CharacterLineLength

      NSDataBase64Encoding76CharacterLineLength

      Установите максимальную длину строки в 76 символов, после которых вставляется окончание строки.

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

    • EncodingEndLineWithCarriageReturn

      NSDataBase64EncodingEndLineWithCarriageReturn

      Когда максимальная длина строки установлена, укажите, что строка, заканчивающаяся для вставки, должна включать возврат каретки.

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

    • EncodingEndLineWithLineFeed

      NSDataBase64EncodingEndLineWithLineFeed

      Когда максимальная длина строки установлена, укажите, что строка, заканчивающаяся для вставки, должна включать перевод строки.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • NSDataBase64DecodingOptions

    Опции изменить алгоритм декодирования раньше декодировали Основу 64 закодированных NSData объекты.

    Объявление

    Swift

    struct NSDataBase64DecodingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var IgnoreUnknownCharacters: NSDataBase64DecodingOptions { get } }

    Objective C

    enum { NSDataBase64DecodingIgnoreUnknownCharacters = 1UL << 0 }; typedef NSUInteger NSDataBase64DecodingOptions;

    Константы

    • IgnoreUnknownCharacters

      NSDataBase64DecodingIgnoreUnknownCharacters

      Измените алгоритм декодирования так, чтобы он проигнорировал неизвестные non-Base-64 байты, включая конечные символы строки.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Устаревшие опции чтения

    устаревшие (deprecated) имена для чтения опций. Не используйте эти имена, используйте новые замены вместо этого.

    Объявление

    Swift

    struct NSDataReadingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var DataReadingMappedIfSafe: NSDataReadingOptions { get } static var DataReadingUncached: NSDataReadingOptions { get } static var DataReadingMappedAlways: NSDataReadingOptions { get } static var DataReadingMapped: NSDataReadingOptions { get } static var MappedRead: NSDataReadingOptions { get } static var UncachedRead: NSDataReadingOptions { get } }

    Objective C

    enum { NSDataReadingMapped = NSDataReadingMappedIfSafe, NSMappedRead = NSDataReadingMapped, NSUncachedRead = NSDataReadingUncached };

    Константы

    • DataReadingMapped

      NSDataReadingMapped

      Осуждаемое имя для NSDataReadingMappedIfSafe.

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

    • MappedRead

      NSMappedRead

      Осуждаемое имя для NSDataReadingMapped.

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

    • UncachedRead

      NSUncachedRead

      Осуждаемое имя для NSDataReadingUncached.

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

  • NSDataWritingOptions

    Опции для методов раньше писали NSData объекты.

    Объявление

    Swift

    struct NSDataWritingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var DataWritingAtomic: NSDataWritingOptions { get } static var DataWritingWithoutOverwriting: NSDataWritingOptions { get } static var DataWritingFileProtectionNone: NSDataWritingOptions { get } static var DataWritingFileProtectionComplete: NSDataWritingOptions { get } static var DataWritingFileProtectionCompleteUnlessOpen: NSDataWritingOptions { get } static var DataWritingFileProtectionCompleteUntilFirstUserAuthentication: NSDataWritingOptions { get } static var DataWritingFileProtectionMask: NSDataWritingOptions { get } static var AtomicWrite: NSDataWritingOptions { get } }

    Objective C

    enum { NSDataWritingAtomic = 1UL << 0, NSDataWritingWithoutOverwriting = 1UL << 1, NSDataWritingFileProtectionNone = 0x10000000, NSDataWritingFileProtectionComplete = 0x20000000, NSDataWritingFileProtectionCompleteUnlessOpen = 0x30000000, NSDataWritingFileProtectionCompleteUntilFirstUserAuthentication = 0x40000000, NSDataWritingFileProtectionMask = 0xf0000000, }; typedef NSUInteger NSDataWritingOptions;

    Константы

    • DataWritingAtomic

      NSDataWritingAtomic

      Подсказка, чтобы записать данные во вспомогательный файл сначала и затем обмениваться файлами. Эта опция эквивалентна использованию метода записи, берущего параметр atomically:YES.

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

    • DataWritingWithoutOverwriting

      NSDataWritingWithoutOverwriting

      Подсказка к возврату предотвращает перезапись существующего файла. Не может быть объединен с NSDataWritingAtomic.

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

    • DataWritingFileProtectionNone

      NSDataWritingFileProtectionNone

      Подсказка для установки атрибута защиты содержания файла при выписывании его. В этом случае, в то время как устройство разблокировано, файл не хранится в зашифрованном формате и может быть получен доступ во время начальной загрузки и.

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

    • DataWritingFileProtectionComplete

      NSDataWritingFileProtectionComplete

      Подсказка для установки атрибута защиты содержания файла при выписывании его. В этом случае файл хранится в зашифрованном формате и может быть считан из или записан в только, в то время как разблокировано устройство. Во все другие времена, попытки читать и записать результат файла в отказе.

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

    • DataWritingFileProtectionCompleteUnlessOpen

      NSDataWritingFileProtectionCompleteUnlessOpen

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

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

    • DataWritingFileProtectionCompleteUntilFirstUserAuthentication

      NSDataWritingFileProtectionCompleteUntilFirstUserAuthentication

      Подсказка для установки атрибута защиты содержания файла при выписывании его. В этом случае файл может быть считан или записан в то, в то время как устройство заблокировано, но в то время как это загружается, у них есть защита, эквивалентная NSDataWritingFileProtectionComplete.

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

    • DataWritingFileProtectionMask

      NSDataWritingFileProtectionMask

      Маска для использования при определении опций защиты файла присвоилась к данным.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Устаревшие опции записи

    устаревшие (deprecated) имена для записи опций. Не используйте эти имена, используйте новые замены вместо этого.

    Объявление

    Swift

    struct NSDataWritingOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var DataWritingAtomic: NSDataWritingOptions { get } static var DataWritingWithoutOverwriting: NSDataWritingOptions { get } static var DataWritingFileProtectionNone: NSDataWritingOptions { get } static var DataWritingFileProtectionComplete: NSDataWritingOptions { get } static var DataWritingFileProtectionCompleteUnlessOpen: NSDataWritingOptions { get } static var DataWritingFileProtectionCompleteUntilFirstUserAuthentication: NSDataWritingOptions { get } static var DataWritingFileProtectionMask: NSDataWritingOptions { get } static var AtomicWrite: NSDataWritingOptions { get } }

    Objective C

    enum { NSAtomicWrite = NSDataWritingAtomic };

    Константы

    • AtomicWrite

      NSAtomicWrite

      Осуждаемое имя для NSDataWritingAtomic.

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

  • NSDataSearchOptions

    Опции для метода раньше искали NSData объекты. Эти опции используются с rangeOfData:options:range: метод.

    Объявление

    Swift

    struct NSDataSearchOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Backwards: NSDataSearchOptions { get } static var Anchored: NSDataSearchOptions { get } }

    Objective C

    enum { NSDataSearchBackwards = 1UL << 0, NSDataSearchAnchored = 1UL << 1 }; typedef NSUInteger NSDataSearchOptions;

    Константы

    • Backwards

      NSDataSearchBackwards

      Поиск от конца NSData объект.

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

    • Anchored

      NSDataSearchAnchored

      Поиск ограничивается для запуска (или конец, если NSDataSearchBackwards) из NSData объект.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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