Type Method 型メソッド

dataWithContentsOfURL:options:error:

Creates a data object containing the data from the location specified by a given URL. 与えられたURLによって指定される位置からのデータを含んでいるデータオブジェクト。

Declaration 宣言 

+ (instancetype)dataWithContentsOfURL:(NSURL *)url 
                              options:(NSDataReadingOptions)readOptionsMask 
                                error:(NSError * _Nullable *)errorPtr;

Parameters パラメータ

aURL

The URL from which to read data. それからデータを読み出すことになるURL。

mask

A mask that specifies options for reading the data. Constant components are described in NSDataReadingOptions. データ読み出しに対するオプションを指定するあるマスク。定数構成要素それらは、NSDataReadingOptionsにおいて記述されます。

errorPtr

If there is an error reading in the data, upon return contains an error object that describes the problem. データ読み込みでエラーがあるならば、戻りでは問題を記述するエラーオブジェクトを含みます。

Discussion 議論

Use this method to convert data:// URLs to NSData objects. You can also use it to read short files synchronously. If you need to read potentially large files, use inputStreamWithURL: to open a stream, then read the file incrementally. あなたが潜在的に大きなファイルを読み出す必要があるならば、inputStreamWithURL:を使ってあるストリームを開いて、その後でファイルを徐々に読み出してください。

This method may fail and return nil for various reasons, like bad URLs and file-not-found errors. In this case, the reason for error is indicated by errorPtr. このメソッドは、不正なURLそしてファイルが見つからないエラーのような、さまざまな理由のために失敗して、nilを返すかもしれません。この場合には、エラーの理由はerrorPtrによって指し示されます。

See Also 参照

Reading Data from a File ファイルからデータを読み出す

+ dataWithContentsOfFile:
Creates a data object by reading every byte from the file at a given path. データオブジェクトを、ある与えられたパスでのファイルからあらゆるバイトを読み出すことによって作成します。
+ dataWithContentsOfFile:options:error:
Creates a data object by reading every byte from the file at a given path. データオブジェクトを、ある与えられたパスでのファイルからあらゆるバイトを読み出すことによって作成します。
+ dataWithContentsOfURL:
Creates a data object containing the data from the location specified by a given URL. 与えられたURLによって指定される位置からのデータを含んでいるデータオブジェクト。
- initWithContentsOfFile:
Initializes a data object with the content of the file at a given path. あるデータオブジェクトをある与えられたパスでのファイルの内容で初期化します。
- initWithContentsOfFile:options:error:
Initializes a data object with the content of the file at a given path. あるデータオブジェクトをある与えられたパスでのファイルの内容で初期化します。
- initWithContentsOfURL:
Initializes a data object with the data from the location specified by a given URL. あるデータオブジェクトをある与えられたURLによって指定される場所からのデータで初期化します。
- initWithContentsOfURL:options:error:
Initializes a data object with the data from the location specified by a given URL. あるデータオブジェクトをある与えられたURLによって指定される場所からのデータで初期化します。
NSDataReadingOptions
Options for methods used to read data objects. データオブジェクトの読み出しに使用されるメソッドに対するオプション。
- initWithContentsOfMappedFile:
Initializes a data object with the contents of the mapped file specified by a given path. あるデータオブジェクトをある与えられたパスによって指定されるマップファイルの内容で初期化します。
Deprecated 非推奨
+ dataWithContentsOfMappedFile:
Creates a data object from the mapped file at a given path. 与えられたパスでのマップファイルからデータオブジェクトを作成します。
Deprecated 非推奨