Initializer

init(url:options:documentAttributes:)

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

Declaration 宣言

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

Parameters パラメータ

url: An NSURL object specifying the document to load. ロードする書類を指定しているNSURLオブジェクト。
options オプション: Specifies how the document should be loaded. Contains values described in NSAttributedStringDocumentReadingOptionKey. どのように書類がロードされるべきかを指定してください。NSAttributedStringDocumentReadingOptionKeyで記述される値を含めて下さい。
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 parameter that returns an error if the method returns nil. メソッドがnilを返すならばエラーを返すインアウトパラメータ。

Return Value 戻り値

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

Discussion 議論

Filter services can be used to convert the file into a format recognized by Cocoa. The options dictionary specifies how the document should be loaded and can contain the values described in NSAttributedStringDocumentReadingOptionKey. フィルタサービスは、ファイルをCocoaによって認識される形式へと変換するために使われることができます。options辞書は、どのように書類がロードされるべきかを指定します、そしてNSAttributedStringDocumentReadingOptionKeyで記述される値を含むことができます。

If documentType is specified, the document is treated as being in the specified format. If documentType is not specified, the method examines the document and loads it using whatever format it seems to contain. documentTypeが指定されるならば、書類は指定された形式であるとして扱われます。documentTypeが指定されないならば、メソッドは書類を調査して、それが含むように思われる形式は何でも使ってそれをロードします。

Also returns by reference in dict a dictionary containing document-level attributes described in NSAttributedString.DocumentAttributeKey. The dict parameter may be nil, in which case no document attributes are returned. Returns an initialized object, or nil if the file at url can’t be decoded, after setting error to point to an NSError object that encapsulates the reason why the attributed string object could not be created. またdictにおいて、NSAttributedString.DocumentAttributeKeyにおいて記述される書類レベルの属性を含んでいる辞書を参照によって返します。dictパラメータはnilであるかもしれません、その場合には書類属性は返されません。初期化されたオブジェクトを返してください、またはnilをurlでのファイルがデコードできないならば、errorを NSErrorオブジェクトを指し示すように設定した後で、それはなぜ属性付き文字列オブジェクトが作成されることができなかったか理由をカプセル化します。

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(data: Data, options: [NSAttributedString.DocumentReadingOptionKey : Any], documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)

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

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(attachment: NSTextAttachment)

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