Core Foundation > CFAttributedStringGetAttributes(_:_:_:)
関数
CFAttributedStringGetAttributes(_:_:_:)
指定された場所にある属性付き文字列の属性を返します。
宣言
パラメータ
| str | 検査すべき属性付き文字列。 |
| loc | 属性を決定する str 内の位置。loc は str の範囲を超えてはいけません。 |
| effectiveRange | NULL でない場合、返る時に loc と完全に同じ属性セットが適用される loc を含む範囲が含まれます。 |
戻り値
指定された場所にある str の属性を含む辞書。所有権は 取得規則 に従います。
議論
パフォーマンス上の理由から、effectiveRange で返される範囲は必ずしも最大範囲ではありません。最大範囲が必要な場合は、CFAttributedStringGetAttributesAndLongestEffectiveRange(_:_:_:_:) を使用する必要があります。
返された属性辞書は、この呼び出し後に属性付き文字列が編集された場合、予期しない方法で変更される事があることに注意してください。辞書の状態を保持したい場合は、辞書を保持するのではなく、実際のコピーを作成する必要があります。さらに、この呼び出しによって返された実際の辞書と、辞書に格納された値が同一である (つまり、==) という事実以外の、属性の設定に元々使用されていた辞書の関係については、もともと指定したものと同一です。