Initializer

init(fileURL:options:documentAttributes:)

Initializes a new attributed string object from the data at the specified URL. 指定されたURLでのデータから新しい属性付文字列オブジェクトを初期化します。

Declaration 宣言

init(fileURL url: URL, 
options: [AnyHashable : Any] = [:], 
documentAttributes dict: AutoreleasingUnsafeMutablePointer<NSDictionary?>?) throws

Parameters パラメータ

url

An NSURL object specifying the document to load. ロードする書類を指定しているNSURLオブジェクト。

options オプション

Document attributes for interpreting the document contents. documentType, characterEncoding, and defaultAttributes are supported option keys. If not specified, the method examines the data to attempt to determine the appropriate attributes. 書類内容を解釈するための書類属性。documentType, characterEncoding、そしてdefaultAttributesが、サポートされるオプションキーです。指定されないならば、メソッドはデータを検査して、適切な属性を決定しようと試みます。

dict

If non-NULL, returns a dictionary with various document-wide attributes accessible via document attribute keys. NULLならば、書類属性キー経由でアクセス可能ないろいろの書類全体属性を持つ辞書を返します。

error

An in-out variable containing an encountered error, if any. もしあれば、出くわしたエラーを含んでいるインアウト変数。

Return Value 戻り値

Returns an initialized attributed string object, or nil if the data can’t be decoded. 初期化された属性付文字列オブジェクトを、またはnilをデータがデコードできないならば返します。

Discussion 議論

The HTML importer should not be called from a background thread (that is, the options dictionary includes documentType with a value of html). It will try to synchronize with the main thread, fail, and time out. Calling it from the main thread works (but can still time out if the HTML contains references to external resources, which should be avoided at all costs). The HTML import mechanism is meant for implementing something like markdown (that is, text styles, colors, and so on), not for general HTML import. HTMLインポーターは、バックグラウンドスレッドから呼び出されるべきではありません(すなわち、options辞書はdocumentTypehtmlの値で含みます)。それは、メインスレッドと同期することを試みて、失敗、そして時間切れで中断になるでしょう。それをメインスレッドから呼び出すことは機能します(しかし依然として時間切れで中断になる可能性があります、もしHTMLが外部リソースへの参照を含むならば、それはどんなに犠牲を払っても防がれるべきです)。HTMLインポート機構は、マークダウンのような何かの実装に向けたものです(すなわち、テキストスタイル、カラー、など)、全般的なHTMLインポートにではなく。

See Also 参照

Deprecated Initializers 非推奨イニシャライザ