enumerateMatchesInString:options:range:usingBlock:

- (void)enumerateMatchesInString:(NSString *)string 
                         options:(NSMatchingOptions)options 
                           range:(NSRange)range 
                      usingBlock:(void (^)(NSTextCheckingResult *result, NSMatchingFlags flags, BOOL *stop))block;

Discussion 議論

This method is the fundamental matching method for regular expressions and is suitable for overriding by subclassers. There are additional convenience methods for returning all the matches as an array, the total number of matches, the first match, and the range of the first match. このメソッドは、基本的なマッチング・メソッドであって、サブクラス作成者によってオーバーライドするのに適したものです。全てのマッチの配列、マッチの総数、最初のマッチ、そして最初のマッチの範囲を返す、いっそう便利なメソッドもあります。

By default, the Block iterator method calls the Block precisely once for each match, with a non-nil result and the appropriate flags. The client may then stop the operation by setting the contents of stop to YES. The stop argument is an out-only argument. You should only ever set this Boolean to YES within the Block. 初期状態では、「ブロック」イテレータ・メソッドは「ブロック」を、非nilのresultと適切なflagsとともに、各マッチに対して正確に一度だけ呼びます。クライアントは、それからstopの内容をYESに設定することによって操作を止めることができます。stop引数は、ひとつの退出専用引数です。あなたは、常に「ブロック」内部でこのブールをYESに設定できるだけであるべきです。

If the NSMatchingReportProgress matching option is specified, the Block will also be called periodically during long-running match operations, with nil result and NSMatchingProgress matching flag set in the Block’s flags parameter, at which point the client may again stop the operation by setting the contents of stop to YES. NSMatchingReportProgressマッチング・オプションが指定されるならば、「ブロック」はまた長く実行されているマッチ操作の間に定期的に呼ばれることもします、そしてnilの結果でそしてNSMatchingProgressマッチングフラグが「ブロック」のflagsパラメータにおいて設定されると、その時点でクライアントはstopの内容をYESに設定することによって再び操作を止めることができます。

If the NSMatchingReportCompletion matching option is specified, the Block object will be called once after matching is complete, with nil result and the NSMatchingCompleted matching flag is set in the flags passed to the Block, plus any additional relevant NSMatchingFlags from among NSMatchingHitEnd, NSMatchingRequiredEnd, or NSMatchingInternalError. NSMatchingReportCompletionマッチング・オプションが指定されるならば、「ブロック」オブジェクトがマッチングが完了した後に一度だけ呼ばれます、nilの結果とNSMatchingCompletedマッチングフラグが「ブロック」に渡されるflagsにおいて設定されると、何らかの追加の関連したNSMatchingFlagsをNSMatchingHitEnd、NSMatchingRequiredEnd、またはNSMatchingInternalErrorの中から加えます。

NSMatchingProgress and NSMatchingCompleted matching flags have no effect for methods other than this method. NSMatchingProgressとNSMatchingCompletedマッチングフラグは、このメソッド以外のメソッドには効果がありません。

The NSMatchingHitEnd matching flag is set in the flags passed to the Block if the current match operation reached the end of the search range. The NSMatchingRequiredEnd matching flag is set in the flags passed to the Block if the current match depended on the location of the end of the search range. 現在のマッチ操作が検索範囲の終端に達するならば、NSMatchingHitEndマッチングフラグが「ブロック」に渡されるflagsにおいて設定されます。現在のマッチが検索範囲の終端の場所に依存するならば、NSMatchingRequiredEndマッチングフラグが「ブロック」に渡されるflagsにおいて設定されます。

The NSMatchingFlags matching flag is set in the flags passed to the block if matching failed due to an internal error (such as an expression requiring exponential memory allocations) without examining the entire search range. マッチングが全ての検索範囲を調べることなく内部エラー（例えば急激に増すメモリ割当てを必要としているある表現）のために失敗するならば、NSMatchingFlagsマッチングフラグがブロックに渡されるflagsで設定されます。

The NSMatchingAnchored, NSMatchingWithTransparentBounds, and NSMatchingWithoutAnchoringBounds regular expression options, specified in the options property specified when the regular expression instance is created, can apply to any match or replace method. 正規表現インスタンスがつくられる時に指定されるoptionsプロパティにおいて指定される、NSMatchingAnchored、NSMatchingWithTransparentBounds、そしてNSMatchingWithoutAnchoringBounds正規表現オプションは、あらゆるマッチまたは置換メソッドに適用できます。

If NSMatchingAnchored matching option is specified, matches are limited to those at the start of the search range. NSMatchingAnchoredマッチング・オプションが指定されるならば、マッチは検索範囲の始まりでのそれらに限られます。

If NSMatchingWithTransparentBounds matching option is specified, matching may examine parts of the string beyond the bounds of the search range, for purposes such as word boundary detection, lookahead, etc. NSMatchingWithTransparentBoundsマッチング・オプションが指定されるならば、語境界検出、先読み検索、などのような目的のために、マッチングは検索範囲の境界を越えて、文字列の一部を調べるかもしれません。

If NSMatchingWithoutAnchoringBounds matching option is specified, ^ and $ will not automatically match the beginning and end of the search range, but will still match the beginning and end of the entire string. NSMatchingWithoutAnchoringBoundsマッチング・オプションが指定されるならば、^と$は自動的に検索範囲の始めと終わりにマッチしません、しかし依然として文字列全体の始めと終わりにマッチします。

NSMatchingWithTransparentBounds and NSMatchingWithoutAnchoringBounds matching options have no effect if the search range covers the entire string. 検索範囲が全文字列をカバーするならば、マッチング・オプションNSMatchingWithTransparentBoundsとNSMatchingWithoutAnchoringBoundsは効果がありません。