enumerateMatches(in:options:range:using:)

func enumerateMatches(in string: String, 
              options: NSRegularExpression.MatchingOptions = [], 
                range: NSRange, 
                using block: (NSTextCheckingResult?, NSRegularExpression.MatchingFlags, UnsafeMutablePointer<ObjCBool>) -> Void)

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 true. The stop argument is an out-only argument. You should only ever set this Boolean to true within the Block. 初期状態では、「ブロック」イテレータ・メソッドは「ブロック」を、非nilのresultと適切なflagsとともに、各マッチに対して正確に一度だけ呼びます。クライアントは、それからstopの内容をtrueに設定することによって操作を止めることができます。stop引数は、ひとつの退出専用引数です。あなたは、「ブロック」内でこのブールをtrueに設定できるだけであるべきです。

If the reportProgress matching option is specified, the Block will also be called periodically during long-running match operations, with nil result and progress 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 true. reportProgressマッチング・オプションが指定されるならば、「ブロック」はまた長く実行されているマッチ操作の間に定期的に呼ばれることもします、そしてnilの結果でそしてprogressマッチングフラグが「ブロック」のflagsパラメータにおいて設定されると、その時点でクライアントはstopの内容をtrueに設定することによって再び操作を止めることができます。

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

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

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

The NSRegularExpression.MatchingFlags 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. マッチングが全ての検索範囲を調べることなく内部エラー（例えば急激に増すメモリ割当てを必要としているある表現）のために失敗するならば、NSRegularExpression.MatchingFlagsマッチングフラグがブロックに渡されるflagsで設定されます。

The anchored, withTransparentBounds, and withoutAnchoringBounds 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プロパティにおいて指定される、anchored、withTransparentBounds、そしてwithoutAnchoringBounds正規表現オプションは、あらゆるマッチまたは置換メソッドに適用されます。

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

If withTransparentBounds 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. withTransparentBoundsマッチングオプションが指定されるならば、語境界検出、先読み検索、などのような目的のために、マッチングは検索範囲の境界を越えて、文字列の一部を調べるかもしれません。

If withoutAnchoringBounds 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. withoutAnchoringBoundsマッチングオプションが指定されるならば、^と$は自動的に検索範囲の始めと終わりにマッチしません、しかし依然として文字列全体の始めと終わりにマッチします。

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