- enumerateAttributesInRange:options:usingBlock: Executes the specified block for each range of attributes in the attributed string.
指定されたブロックを、属性付文字列の中の属性の範囲それぞれに対して実行します。
The name of the attribute to enumerate. 列挙することになる属性の名前。
Instance Method
インスタンスメソッド
enumerate
enumerateAttribute:inRange:options:usingBlock:
Executes the specified block for each range of a particular attribute in the attributed string.
指定されたブロックを、属性付文字列の中のある特定の属性の範囲それぞれに対して実行します。
Availability 有効性
- iOS 4.0+
- iPadOS 4.0+
- macOS 10.6+
- Mac Catalyst 13.1+
- tvOS 9.0+
- watchOS 2.0+
Technology
- Foundation ファウンデーション
Declaration 宣言
- (void)enumerateAttribute:(NSAttributedStringKey )attrName
inRange:(NSRange)enumerationRange
options:(NSAttributedStringEnumerationOptions )opts
usingBlock:(void (^)(id value, NSRange range, BOOL *stop))block;
Parameters パラメータ
attrNameenumerationRangeThe range over which the attribute values are enumerated. それに対して属性値が列挙されるところの範囲。
optsThe options used by the enumeration. For possible values, see
NSAttributed. 列挙によって使われるオプション。可能な値として、String Enumeration Options NSAttributedを見てください。String Enumeration Options blockThe block to apply to ranges of the specified attribute in the attributed string. 属性付文字列の中のこの指定された属性の範囲に適用されるブロック。
The block takes three arguments: ブロックは、次の３つの引数をとります：
- value
The value for the specified attribute. 指定された属性に対する値。
- range
The range of the attribute value in the attributed string. 属性付文字列の中の属性値の範囲。
- stop 中止
A reference to a Boolean value. The block can set the value to
YESwithin the block to stop further processing of the attributed string. あるブール値への参照。ブロックは、値をYESにそのブロック内部で設定することで、それ以上の属性付き文字列の処理を止めることができます。
Discussion 議論
If this method is called by an instance of NSMutable, mutation (deletion, addition, or change) is allowed only if the mutation is within the range provided to the block. After a mutation, the enumeration continues with the range immediately following the processed range, adjusting for any change in length caused by the mutation. For example, if block is called with a range starting at location N, and the block deletes all the characters in the provided range, the next call will also pass N as the location of the range.
このメソッドがNSMutableのインスタンスによって呼び出されるならば、変化（削除、追加、または変更）は、その変化がブロックに提供される範囲内である場合にのみ許可されます。ある変化の後、列挙は処理された範囲にすぐに続く範囲で継続します、変化によってもたらされる長さでの如何なる変更も調整します。例えば、blockが位置Nで始まる範囲で呼び出される、そしてブロックは全ての文字を提供された範囲において削除するならば、次の呼び出しはまたNを範囲の位置として渡されるでしょう。