Instance Method インスタンスメソッド

read(from:options:documentAttributes:error:)

Sets the contents of attributed string to the contents of the specified file. 属性付き文字列の内容をこの指定されたファイルの内容に設定します。

Declaration 宣言

iOS, iPadOS, Mac Catalyst, tvOS, watchOS

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

macOS

func read(from url: URL, 
  options opts: [NSAttributedString.DocumentReadingOptionKey : Any] = [:], 
documentAttributes dict: AutoreleasingUnsafeMutablePointer<NSDictionary?>?, 
    error: ()) throws

Parameters パラメータ

url

The URL of the file to read. 読み出すことになるファイルのURL。

opts

The option keys for importing the document. For a list of possible values, see “Option keys for importing documents” in NSAttributedString. 書類のインポートに対するオプションキー。可能な値の一覧として、“Option keys for importing documents” をNSAttributedStringで見てください。

dict

On return, contains the document attributes. For a list of possible values, see “Document Attributes” in NSAttributedString. 戻りでは、書類属性を含みます。可能な値の一覧として、 “Document Attributes” をNSAttributedStringで見てください。

error

Upon return, if an error occurs, contains an NSError object that describes the problem. If you are not interested in possible errors, pass in NULL. 戻りでは、エラーが発生するならば、問題を記述するNSErrorオブジェクトを含みます。あなたが起こりうるエラーに興味がないならば、NULLを渡してください。

Return Value 戻り値

true if the attributed string is created successfully or false if it was not. 属性付き文字列がうまく作成されるならばtrueまたはそうでなかったならばfalse。

Discussion 議論

Filter services can be used to convert the contents of the URL into a format recognized by Cocoa. フィルタサービスは、URLの内容をCocoaによって認識される形式へと変換するために使われることができます。

For RTF formatted files, the contents of the file are appended to the previous string instead of replacing the previous string. Therefore, when using this method with existing content it's best to clear the content away explicitly. RTF形式ファイルに対して、ファイルの内容は以前の文字列へ追加されます、以前の文字列を置き換える代わりに。それゆえに、このメソッドを内容が存在する状態で使う時は、その内容を明示的に消去するのが最善です。

See Also 参照

Reading Content

func read(from: Data, options: [NSAttributedString.DocumentReadingOptionKey : Any], documentAttributes: AutoreleasingUnsafeMutablePointer<NSDictionary?>?)
Sets the contents of the receiver from the stream at data. レシーバの内容をdataでのストリームから設定します。