Initializer

init(data:options:documentAttributes:)

Creates an attributed string from the data in the specified data object. 属性付き文字列をこの指定されたデータオブジェクトの中のデータから作成します。

Declaration 宣言

init(data: Data, 
options: [NSAttributedString.DocumentReadingOptionKey : Any] = [:], 
documentAttributes dict: AutoreleasingUnsafeMutablePointer<NSDictionary?>?) throws

Parameters パラメータ

data: The data from which to create the string. それから文字列を作成することになるデータ。
options オプション: Document attributes for interpreting the document contents. documentType, characterEncoding, and defaultAttributes are supported option keys. If you pass an empty dictionary, the method examines the data to attempt to determine the appropriate attributes. 書類内容を解釈するための書類属性。documentType, characterEncoding、そしてdefaultAttributesが、サポートされるオプションキーです。あなたが空の辞書を渡すならば、このメソッドはデータを検査することで、適切な属性を特定しようと試みます。
dict: An in-out dictionary containing document-level attributes described in NSAttributedString.DocumentAttributeKey. May be nil, in which case no document attributes are returned. NSAttributedString.DocumentAttributeKeyにおいて記述される書類レベルの属性を含んでいるインアウト辞書。nilかもしれません、その場合には書類属性は返されません。
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辞書はdocumentTypeをhtmlの値で含みます）。それは、メインスレッドと同期することを試みて、失敗、そして時間切れで中断になるでしょう。それをメインスレッドから呼び出すことは機能します（しかし依然として時間切れで中断になる可能性があります、もしHTMLが外部リソースへの参照を含むならば、それはどんなに犠牲を払っても防がれるべきです）。HTMLインポート機構は、マークダウンのような何かの実装に向けたものです（すなわち、テキストスタイル、カラー、など）、全般的なHTMLインポートにではなく。

Handling Errors in Swift: Swiftでのエラー処理：

In Swift, this API is imported as an initializer and is marked with the throws keyword to indicate that it throws an error in cases of failure. Swiftでは、このAPIはイニシャライザとしてインポートされてthrowsキーワードで印されることで、それが様々な失敗においてエラーをスローすることを指し示します。

You call this method in a try expression and handle any errors in the catch clauses of a do statement, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters. あなたはこのメソッドをtry式の中で呼び出して、あらゆるエラーをdo文のcatch節で取り扱います、The Swift Programming Languageのエラー処理そしてインポートされるCocoaエラーパラメータについてで記述されるように。

See Also 参照

Creating an Attributed String 属性付き文字列を作成する

init(string: String)

Creates an attributed string with the characters of the specified string and no attribute information. 属性付き文字列をこの指定された文字列の文字それらと属性情報なしで作成します。

init(string: String, attributes: [NSAttributedString.Key : Any]?)

Creates an attributed string with the specified string and attributes. 属性付き文字列をこの指定された文字列と属性で作成します。

init(attributedString: NSAttributedString)

Creates an attributed string with the characters and attributes of the specified attributed string. 属性付き文字列をこの指定された属性付き文字列の文字と属性で作成します。

init?(docFormat: Data, documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string from Microsoft Word format data in the specified data object. 属性付き文字列をこの指定されたデータオブジェクトの中のMicrosoft Word形式データから作成します。

init?(html: Data, documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string from the HTML in the specified data object. 属性付き文字列をこの指定されたデータオブジェクトの中のHTMLから作成します。

init?(html: Data, baseURL: URL, documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string from the HTML in the specified data object and base URL. 属性付き文字列をこの指定されたデータオブジェクトの中のHTMLとベースURLから作成します。

init?(html: Data, options: [NSAttributedString.DocumentReadingOptionKey : Any], documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string from the HTML in the specified data object. 属性付き文字列をこの指定されたデータオブジェクトの中のHTMLから作成します。

init?(rtf: Data, documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string by decoding the stream of RTF commands and data in the specified data object. 属性付き文字列をRTFコマンドそれらからなるストリームと指定されたデータオブジェクトの中のデータをデコードすることによって作成します。

init?(rtfd: Data, documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string by decoding the stream of RTFD commands and data in the specified data object. 属性付き文字列をRTFDコマンドそれらからなるストリームと指定されたデータオブジェクトの中のデータをデコードすることによって作成します。

init?(rtfdFileWrapper: FileWrapper, documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string from the specified file wrapper that contains an RTFD document. 属性付き文字列をRTFD書類を含む指定されたファイルラッパーから作成します。

init(url: URL, options: [NSAttributedString.DocumentReadingOptionKey : Any], documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

Creates an attributed string from the contents of the specified URL. 属性付き文字列をこの指定されたURLの内容から作成します。

init(attachment: NSTextAttachment)

Creates an attributed string with an attachment. 属性付文字列を添付書類付で作成します。