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

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

Разработчик

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

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

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

NSFileHandle

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

Большинство методов создания для NSFileHandle вызовите объект дескриптора файла взять владение связанного дескриптора файла. Это означает, что дескриптор файла возражает, и создает дескриптор файла и ответственен за закрытие его позже, обычно когда освобожден сам объект дескриптора файла. Если Вы хотите использовать объект дескриптора файла с дескриптором файла, который Вы создали, используйте initWithFileDescriptor: метод или использование initWithFileDescriptor:closeOnDealloc: метод и передача NOfalse для flag параметр.

Выполненные соображения цикла

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

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

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Получение дескриптора файла
  • init (forReadingAtPath:) + fileHandleForReadingAtPath:

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

    Объявление

    Swift

    convenience init?(forReadingAtPath path: String)

    Objective C

    + (instancetype)fileHandleForReadingAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу, устройству или названному сокету к доступу.

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

    Инициализированный дескриптор файла возражает или nil если никакой файл не существует в path.

    Обсуждение

    Указатель файла установлен в начало файла. Вы не можете записать данные в возвращенный объект дескриптора файла. Используйте readDataToEndOfFile или readDataOfLength: методы для чтения данных из него.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData
    – initWithFileDescriptor:
    – readDataOfLength:
    – readDataToEndOfFile

  • init (forReadingFromURL:error:) + fileHandleForReadingFromURL:error:

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

    Объявление

    Swift

    convenience init?(forReadingFromURL url: NSURL, error error: NSErrorPointer)

    Objective C

    + (instancetype)fileHandleForReadingFromURL:(NSURL *)url error:(NSError **)error

    Параметры

    url

    URL файла, устройства или названного сокета к доступу.

    error

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

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

    Инициализированный дескриптор файла возражает или nil если никакой файл не существует в url.

    Обсуждение

    Указатель файла установлен в начало файла. Вы не можете записать данные в возвращенный объект дескриптора файла. Используйте readDataToEndOfFile или readDataOfLength: методы для чтения данных из него.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData
    – initWithFileDescriptor:
    – readDataOfLength:
    – readDataToEndOfFile

  • init (forWritingAtPath:) + fileHandleForWritingAtPath:

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

    Объявление

    Swift

    convenience init?(forWritingAtPath path: String)

    Objective C

    + (instancetype)fileHandleForWritingAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу, устройству или названному сокету к доступу.

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

    Инициализированный дескриптор файла возражает или nil если никакой файл не существует в path.

    Обсуждение

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

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithFileDescriptor:
    – writeData:

  • init (forWritingToURL:error:) + fileHandleForWritingToURL:error:

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

    Объявление

    Swift

    convenience init?(forWritingToURL url: NSURL, error error: NSErrorPointer)

    Objective C

    + (instancetype)fileHandleForWritingToURL:(NSURL *)url error:(NSError **)error

    Параметры

    url

    URL файла, устройства или названного сокета к доступу.

    error

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

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

    Инициализированный дескриптор файла возражает или nil если никакой файл не существует в url.

    Обсуждение

    Указатель файла установлен в начало файла. Возвращенный объект отвечает только на writeData:.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithFileDescriptor:
    – writeData:

  • init (forUpdatingAtPath:) + fileHandleForUpdatingAtPath:

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

    Объявление

    Swift

    convenience init?(forUpdatingAtPath path: String)

    Objective C

    + (instancetype)fileHandleForUpdatingAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу, устройству или названному сокету к доступу.

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

    Инициализированный дескриптор файла возражает или nil если никакой файл не существует в path.

    Обсуждение

    Указатель файла установлен в начало файла. Возвращенный объект реагирует на обоих read... сообщения и writeData:.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData
    – initWithFileDescriptor:
    – readDataOfLength:
    – readDataToEndOfFile

  • init (forUpdatingURL:error:) + fileHandleForUpdatingURL:error:

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

    Объявление

    Swift

    convenience init?(forUpdatingURL url: NSURL, error error: NSErrorPointer)

    Objective C

    + (instancetype)fileHandleForUpdatingURL:(NSURL *)url error:(NSError **)error

    Параметры

    url

    URL файла, устройства или названного сокета к доступу.

    error

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

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

    Инициализированный дескриптор файла возражает или nil если никакой файл не существует в url.

    Обсуждение

    Указатель файла установлен в начало файла. Возвращенный объект реагирует на обоих NSFileHandleread... сообщения и writeData:.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData
    – initWithFileDescriptor:
    – readDataOfLength:
    – readDataToEndOfFile
    – writeData:

  • fileHandleWithStandardError () + fileHandleWithStandardError

    Возвращает дескриптор файла, связанный с файлом стандартной погрешности.

    Объявление

    Swift

    class func fileHandleWithStandardError() -> NSFileHandle

    Objective C

    + (NSFileHandle *)fileHandleWithStandardError

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

    Дескриптор совместно используемого файла связался с файлом стандартной погрешности.

    Обсуждение

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

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + fileHandleWithNullDevice
    – initWithFileDescriptor:

  • fileHandleWithStandardInput () + fileHandleWithStandardInput

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

    Объявление

    Swift

    class func fileHandleWithStandardInput() -> NSFileHandle

    Objective C

    + (NSFileHandle *)fileHandleWithStandardInput

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

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

    Обсуждение

    Традиционно это - оконечное устройство, в которое пользователь вводит поток данных. Существует один стандартный входной дескриптор файла для каждого процесса; это - совместно используемый экземпляр.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + fileHandleWithNullDevice
    – initWithFileDescriptor:

  • fileHandleWithStandardOutput () + fileHandleWithStandardOutput

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

    Объявление

    Swift

    class func fileHandleWithStandardOutput() -> NSFileHandle

    Objective C

    + (NSFileHandle *)fileHandleWithStandardOutput

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

    Дескриптор совместно используемого файла связался с файлом стандартного вывода.

    Обсуждение

    Традиционно это - оконечное устройство, получающее поток данных из программы. Существует один дескриптор файла стандартного вывода для каждого процесса; это - совместно используемый экземпляр.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + fileHandleWithNullDevice
    – initWithFileDescriptor:

  • fileHandleWithNullDevice () + fileHandleWithNullDevice

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

    Объявление

    Swift

    class func fileHandleWithNullDevice() -> NSFileHandle

    Objective C

    + (NSFileHandle *)fileHandleWithNullDevice

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

    Дескриптор файла связался с нулевым устройством.

    Обсуждение

    Можно использовать дескрипторы нулевого файла устройств в качестве «заполнителей» для дескрипторов файлов стандартного устройства или в объектах коллекции для предотвращения исключений и других ошибок, следующих из сообщений, отправляемых в недопустимые дескрипторы файла. Читайте сообщения, отправленные в дескриптор нулевого файла устройств, возвращают индикатор конца файла (пустое NSData объект), а не повышение исключение. Запишите, что сообщения без операций в секунду, тогда как fileDescriptor возвращает недопустимое значение. Другие методы без операций в секунду или возвращают «разумные» значения.

    При использовании этого метода для создания объекта дескриптора файла дескриптор файла владеет своим связанным дескриптором файла и ответственен за закрытие его.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithFileDescriptor:

Создание дескриптора файла
  • init (fileDescriptor:) - initWithFileDescriptor:

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

    Объявление

    Swift

    convenience init(fileDescriptor fileDescriptor: Int32)

    Objective C

    - (instancetype)initWithFileDescriptor:(int)fileDescriptor

    Параметры

    fileDescriptor

    Дескриптор файла POSIX, с которым можно инициализировать дескриптор файла. Этот дескриптор представляет открытый файл, или снабдите это сокетом, Вы создали ранее. Например, при создании дескриптора файла для сокета, Вы передали бы значение, возвращенное socket функция.

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

    Дескриптор файла, инициализированный с fileDescriptor.

    Обсуждение

    Дескриптор файла, в котором Вы передаете этому методу, не принадлежит объекту дескриптора файла. Поэтому Вы ответственны за закрытие дескриптора файла в некоторый момент после избавления от объекта дескриптора файла.

    Можно создать дескриптор файла для сокета при помощи результата a socket вызовите как fileDescriptor.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – closeFile

  • init (fileDescriptor:closeOnDealloc:) - initWithFileDescriptor:closeOnDealloc: Определяемый инициализатор

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

    Объявление

    Swift

    init(fileDescriptor fileDescriptor: Int32, closeOnDealloc flag: Bool)

    Objective C

    - (instancetype)initWithFileDescriptor:(int)fileDescriptor closeOnDealloc:(BOOL)flag

    Параметры

    fileDescriptor

    Дескриптор файла POSIX, с которым можно инициализировать дескриптор файла.

    flag

    YEStrue если возвращенный объект дескриптора файла должен взять владение дескриптора файла и закрыть его для Вас или NOfalse если Вы хотите поддержать владение дескриптора файла.

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

    Инициализированный объект дескриптора файла.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – closeFile

Получение дескриптора файла
  • fileDescriptor fileDescriptor Свойство

    Дескриптор файла POSIX связался с получателем. (только для чтения)

    Объявление

    Swift

    var fileDescriptor: Int32 { get }

    Objective C

    @property(readonly) int fileDescriptor

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithFileDescriptor:

Чтение от дескриптора файла
  • availableData availableData Свойство

    Данные, в настоящее время доступные в получателе. (только для чтения)

    Объявление

    Swift

    @NSCopying var availableData: NSData { get }

    Objective C

    @property(readonly, copy) NSData *availableData

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – readDataOfLength:
    – readDataToEndOfFile

  • readDataToEndOfFile () - readDataToEndOfFile

    Синхронно считывает доступные данные до конца номера документа или максимального количества байтов.

    Объявление

    Swift

    func readDataToEndOfFile() -> NSData

    Objective C

    - (NSData *)readDataToEndOfFile

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

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

    Обсуждение

    Этот метод вызывает readDataOfLength: как часть его реализации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData

  • readDataOfLength (_:) - readDataOfLength:

    Синхронно считывает данные до конкретного количества байтов.

    Объявление

    Swift

    func readDataOfLength(_ length: Int) -> NSData

    Objective C

    - (NSData *)readDataOfLength:(NSUInteger)length

    Параметры

    length

    Число байтов для чтения из получателя.

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData
    – readDataToEndOfFile

Запись в дескриптор файла
  • writeData (_:) - writeData:

    Синхронно пишет указанные данные в получатель.

    Объявление

    Swift

    func writeData(_ data: NSData)

    Objective C

    - (void)writeData:(NSData *)data

    Параметры

    data

    Данные, которые будут записаны.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – availableData
    – readDataOfLength:
    – readDataToEndOfFile

Чтение и запись Используя блоки
  • readabilityHandler readabilityHandler Свойство

    Блок для использования для чтения содержания дескриптора файла асинхронно.

    Объявление

    Swift

    var readabilityHandler: ((NSFileHandle!) -> Void)?

    Objective C

    @property(copy) void (^readabilityHandler)( NSFileHandle *)

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • writeabilityHandler writeabilityHandler Свойство

    Блок для использования для записи содержания дескриптора файла асинхронно.

    Объявление

    Swift

    var writeabilityHandler: ((NSFileHandle!) -> Void)?

    Objective C

    @property(copy) void (^writeabilityHandler)( NSFileHandle *)

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Передача асинхронно
  • acceptConnectionInBackgroundAndNotify () - acceptConnectionInBackgroundAndNotify

    Принимает сокетное соединение (только для сокетов потокового типа) в фоновом режиме и создает дескриптор файла для «близкого» (клиент) конец канала передачи.

    Объявление

    Swift

    func acceptConnectionInBackgroundAndNotify()

    Objective C

    - (void)acceptConnectionInBackgroundAndNotify

    Обсуждение

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

    Необходимо вызвать этот метод от потока, имеющего активный цикл выполнения.

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

    Получатель должен быть создан initWithFileDescriptor: сообщение, берущее в качестве параметра сокет потокового типа, создаваемый надлежащей системной подпрограммой, и на этом слушают. Другими словами, Вы должны bind() сокет, и гарантирует, что сокету определили задолженность соединения listen().

    Объект, который запишет данные в возвращенный дескриптор файла, должен добавить себя как наблюдатель NSFileHandleConnectionAcceptedNotification.

    Обратите внимание на то, что этот метод не продолжает прислушиваться к запросам на установление соединения после того, как он отправит NSFileHandleConnectionAcceptedNotification. Если Вы хотите продолжить уведомляться, необходимо вызвать acceptConnectionInBackgroundAndNotify снова в Вашем методе наблюдателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    enqueueNotification:postingStyle:coalesceMask:forModes: (NSNotificationQueue)
    – readInBackgroundAndNotify
    – readToEndOfFileInBackgroundAndNotify

  • acceptConnectionInBackgroundAndNotifyForModes (_:) - acceptConnectionInBackgroundAndNotifyForModes:

    Принимает сокетное соединение (только для сокетов потокового типа) в фоновом режиме и создает дескриптор файла для «близкого» (клиент) конец канала передачи.

    Объявление

    Swift

    func acceptConnectionInBackgroundAndNotifyForModes(_ modes: [AnyObject])

    Objective C

    - (void)acceptConnectionInBackgroundAndNotifyForModes:(NSArray *)modes

    Параметры

    modes

    runloop режимы, в которых соединение приняло уведомление, могут быть отправлены.

    Обсуждение

    Посмотрите acceptConnectionInBackgroundAndNotify для подробных данных того, как работает этот метод. Этот метод отличается от acceptConnectionInBackgroundAndNotify в этом modes указывает режим цикла выполнения (или режимы) в который NSFileHandleConnectionAcceptedNotification может быть отправлен.

    Необходимо вызвать этот метод от потока, имеющего активный цикл выполнения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    enqueueNotification:postingStyle:coalesceMask:forModes: (NSNotificationQueue)
    – readInBackgroundAndNotifyForModes:
    – readToEndOfFileInBackgroundAndNotifyForModes:

  • readInBackgroundAndNotify () - readInBackgroundAndNotify

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

    Объявление

    Swift

    func readInBackgroundAndNotify()

    Objective C

    - (void)readInBackgroundAndNotify

    Обсуждение

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

    Длина данных ограничивается размером буфера базовой операционной системы. Уведомление включает a userInfo словарь, содержащий чтение данных; получите доступ к этому объекту с помощью NSFileHandleNotificationDataItem ключ.

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – acceptConnectionInBackgroundAndNotify
    – readToEndOfFileInBackgroundAndNotifyForModes:
    enqueueNotification:postingStyle:coalesceMask:forModes: (NSNotificationQueue)

  • readInBackgroundAndNotifyForModes (_:) - readInBackgroundAndNotifyForModes:

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

    Объявление

    Swift

    func readInBackgroundAndNotifyForModes(_ modes: [AnyObject])

    Objective C

    - (void)readInBackgroundAndNotifyForModes:(NSArray *)modes

    Параметры

    modes

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

    Обсуждение

    Посмотрите readInBackgroundAndNotify для подробных данных того, как работает этот метод. Этот метод отличается от readInBackgroundAndNotify в этом modes указывает режим цикла выполнения (или режимы) в который NSFileHandleReadCompletionNotification может быть отправлен.

    Необходимо вызвать этот метод от потока, имеющего активный цикл выполнения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – acceptConnectionInBackgroundAndNotifyForModes:
    enqueueNotification:postingStyle:coalesceMask:forModes: (NSNotificationQueue)

  • readToEndOfFileInBackgroundAndNotify () - readToEndOfFileInBackgroundAndNotify

    Чтения до конца файла от файла или канала передачи в фоновом режиме и сообщений уведомление по окончании.

    Объявление

    Swift

    func readToEndOfFileInBackgroundAndNotify()

    Objective C

    - (void)readToEndOfFileInBackgroundAndNotify

    Обсуждение

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

    Уведомление включает a userInfo словарь, содержащий чтение данных; получите доступ к этому объекту с помощью NSFileHandleNotificationDataItem ключ.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – acceptConnectionInBackgroundAndNotify
    – readToEndOfFileInBackgroundAndNotifyForModes:
    enqueueNotification:postingStyle:coalesceMask:forModes: (NSNotificationQueue)

  • readToEndOfFileInBackgroundAndNotifyForModes (_:) - readToEndOfFileInBackgroundAndNotifyForModes:

    Чтения до конца файла от файла или канала передачи в фоновом режиме и сообщений уведомление по окончании.

    Объявление

    Swift

    func readToEndOfFileInBackgroundAndNotifyForModes(_ modes: [AnyObject])

    Objective C

    - (void)readToEndOfFileInBackgroundAndNotifyForModes:(NSArray *)modes

    Параметры

    modes

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

    Обсуждение

    Посмотрите readToEndOfFileInBackgroundAndNotify для подробных данных работы этого метода. Метод отличается от readToEndOfFileInBackgroundAndNotify в этом modes указывает режим цикла выполнения (или режимы) в который NSFileHandleReadToEndOfFileCompletionNotification может быть отправлен.

    Необходимо вызвать этот метод от потока, имеющего активный цикл выполнения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – acceptConnectionInBackgroundAndNotifyForModes:
    enqueueNotification:postingStyle:coalesceMask:forModes: (NSNotificationQueue)

  • waitForDataInBackgroundAndNotify () - waitForDataInBackgroundAndNotify

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

    Объявление

    Swift

    func waitForDataInBackgroundAndNotify()

    Objective C

    - (void)waitForDataInBackgroundAndNotify

    Обсуждение

    Когда данные становятся доступными, этот метод отправляет a NSFileHandleDataAvailableNotification уведомление на текущем потоке.

    Необходимо вызвать этот метод от потока, имеющего активный цикл выполнения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – waitForDataInBackgroundAndNotifyForModes:

  • waitForDataInBackgroundAndNotifyForModes (_:) - waitForDataInBackgroundAndNotifyForModes:

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

    Объявление

    Swift

    func waitForDataInBackgroundAndNotifyForModes(_ modes: [AnyObject])

    Objective C

    - (void)waitForDataInBackgroundAndNotifyForModes:(NSArray *)modes

    Параметры

    modes

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

    Обсуждение

    Когда данные становятся доступными, этот метод отправляет a NSFileHandleDataAvailableNotification уведомление на текущем потоке. Этот метод отличается от waitForDataInBackgroundAndNotify в этом modes указывает режим цикла выполнения (или режимы) в который NSFileHandleDataAvailableNotification может быть отправлен.

    Необходимо вызвать этот метод от потока, имеющего активный цикл выполнения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – waitForDataInBackgroundAndNotify

Поиск в файле
  • offsetInFile offsetInFile Свойство

    Позиция указателя файла в файле представлена получателем. (только для чтения)

    Объявление

    Swift

    var offsetInFile: UInt64 { get }

    Objective C

    @property(readonly) unsigned long long offsetInFile

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – seekToEndOfFile
    – seekToFileOffset:

  • seekToEndOfFile () - seekToEndOfFile

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

    Объявление

    Swift

    func seekToEndOfFile() -> UInt64

    Objective C

    - (unsigned long long)seekToEndOfFile

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

    Файловое смещение с указателем файла в конце файла. Это поэтому равно размеру файла.

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

    Если сообщение отправляется в, повышает исключение NSFileHandle объект, представляющий канал или сокет или если закрывается дескриптор файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – offsetInFile

  • seekToFileOffset (_:) - seekToFileOffset:

    Перемещает указатель файла на указанное смещение в файле, представленном получателем.

    Объявление

    Swift

    func seekToFileOffset(_ offset: UInt64)

    Objective C

    - (void)seekToFileOffset:(unsigned long long)offset

    Параметры

    offset

    Смещение для поиска на.

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

    Если сообщение отправляется в, повышает исключение NSFileHandle объект, представляющий канал или сокет, если дескриптор файла закрывается, или если ошибка происходит в поиске.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – offsetInFile

Работа на файле
  • closeFile () - closeFile

    Запрещает дальнейший доступ к представленному файлу или каналу передачи и сигнализирует конец файла на каналах передачи та запись разрешения.

    Объявление

    Swift

    func closeFile()

    Objective C

    - (void)closeFile

    Обсуждение

    Если объекту дескриптора файла принадлежит его дескриптор файла, он автоматически закрывает тот дескриптор, когда он освобожден. Если Вы инициализировали объект дескриптора файла использование initWithFileDescriptor: метод, или Вы инициализировали его с помощью initWithFileDescriptor:closeOnDealloc: и передал NOfalse для flag параметр, можно использовать этот метод для закрытия дескриптора файла; иначе, необходимо закрыть дескриптор файла сами.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • synchronizeFile () - synchronizeFile

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

    Объявление

    Swift

    func synchronizeFile()

    Objective C

    - (void)synchronizeFile

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • truncateFileAtOffset (_:) - truncateFileAtOffset:

    Усекает или расширяет файл, представленный получателем указанному смещению в файле, и помещает указатель файла в ту позицию.

    Объявление

    Swift

    func truncateFileAtOffset(_ offset: UInt64)

    Objective C

    - (void)truncateFileAtOffset:(unsigned long long)offset

    Параметры

    offset

    Смещение в файле, который отметит новый конец файла.

    Обсуждение

    Если файл расширяется (если offset вне текущего конца файла), добавленные символы являются нулевыми байтами.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Константы
  • Ключи для уведомления словарь UserInfo

    Строки, использующиеся в качестве ключей в userinfo словаре в уведомлении дескриптора файла.

    Объявление

    Swift

    let NSFileHandleNotificationFileHandleItem: NSString! let NSFileHandleNotificationDataItem: NSString!

    Objective C

    NSString * const NSFileHandleNotificationFileHandleItem; NSString * const NSFileHandleNotificationDataItem;

    Константы

    • NSFileHandleNotificationFileHandleItem

      NSFileHandleNotificationFileHandleItem

      Ключ в userinfo словаре в уведомлении NSFileHandleConnectionAcceptedNotification.

      Соответствующее значение NSFileHandle объект, представляющий «близкий» конец сокетного соединения.

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

    • NSFileHandleNotificationDataItem

      NSFileHandleNotificationDataItem

      Ключ в userinfo словаре в NSFileHandleReadCompletionNotification и NSFileHandleReadToEndOfFileCompletionNotification.

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

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

  • Имена исключения

    Постоянный, который определяет имя исключения работы файла.

    Объявление

    Swift

    let NSFileHandleOperationException: NSString!

    Objective C

    extern NSString *NSFileHandleOperationException;

    Константы

    • NSFileHandleOperationException

      NSFileHandleOperationException

      Повышенный NSFileHandle если попытки определить дескриптор файла вводят сбой или если попытки читать из сбоя канала или файла.

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

  • Неиспользованная константа

    Постоянный, который в настоящее время не использован.

    Объявление

    Objective C

    NSString * const NSFileHandleNotificationMonitorModes;

    Константы

    • NSFileHandleNotificationMonitorModes

      NSFileHandleNotificationMonitorModes

      В настоящее время неиспользованный.

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

      Осуждаемый в OS X v10.7.

Уведомления
  • NSFileHandleConnectionAcceptedNotification NSFileHandleConnectionAcceptedNotification

    Это уведомление отправляется когда NSFileHandle объект устанавливает сокетное соединение между двумя процессами, создает NSFileHandle объект для одного конца соединения, и делает этот объект доступным для наблюдателей, вставляя его userInfo словарь. Для порождения регистрации этого уведомления необходимо отправить также acceptConnectionInBackgroundAndNotify или acceptConnectionInBackgroundAndNotifyForModes: к NSFileHandle объект, представляющий сокет потокового типа сервера.

    Объект уведомления NSFileHandle возразите, что отправил уведомление. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    NSFileHandleNotificationFileHandleItem

    NSFileHandle объект, представляющий «близкий» конец сокетного соединения

    @"NSFileHandleError"

    NSNumber объект, содержащий целое число, представляющее произошедшую ошибку типа UNIX

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • NSFileHandleDataAvailableNotification NSFileHandleDataAvailableNotification

    Это уведомление отправляется, когда дескриптор файла решает, что данные в настоящее время доступны для чтения в файле или в канале передачи. Наблюдатели могут тогда выпустить надлежащие сообщения, чтобы начать считывать данные. Для порождения регистрации этого уведомления необходимо отправить также waitForDataInBackgroundAndNotify или waitForDataInBackgroundAndNotifyForModes: к надлежащему NSFileHandle объект.

    Объект уведомления NSFileHandle возразите, что отправил уведомление. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • NSFileHandleReadCompletionNotification NSFileHandleReadCompletionNotification

    Когда дескриптор файла считывает данные, в настоящее время доступные в файле или в канале передачи, это уведомление отправляется. Это делает доступные данные наблюдателям, вставляя его userInfo словарь. Для порождения регистрации этого уведомления необходимо отправить также readInBackgroundAndNotify или readInBackgroundAndNotifyForModes: к надлежащему NSFileHandle объект.

    Объект уведомления NSFileHandle возразите, что отправил уведомление. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    NSFileHandleNotificationDataItem

    NSData объект, содержащий доступные данные, читал из сокетного соединения

    @"NSFileHandleError"

    NSNumber объект, содержащий целое число, представляющее произошедшую ошибку типа UNIX

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • NSFileHandleReadToEndOfFileCompletionNotification NSFileHandleReadToEndOfFileCompletionNotification

    Это уведомление отправляется, когда дескриптор файла считывает все данные в файле или, если канал передачи, пока другой процесс не сигнализирует конец данных. Это делает доступные данные наблюдателям, вставляя его userInfo словарь. Для порождения регистрации этого уведомления необходимо отправить также readToEndOfFileInBackgroundAndNotify или readToEndOfFileInBackgroundAndNotifyForModes: к надлежащему NSFileHandle объект.

    Объект уведомления NSFileHandle возразите, что отправил уведомление. userInfo словарь содержит следующую информацию:

    Ключ

    Значение

    NSFileHandleNotificationDataItem

    NSData объект, содержащий доступные данные, читал из сокетного соединения

    @"NSFileHandleError"

    NSNumber объект, содержащий целое число, представляющее произошедшую ошибку типа UNIX

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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