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

firstMatch(in:options:range:)

Returns the first match of the regular expression within the specified range of the string. この文字列の指定の範囲内における正規表現の最初のマッチを返します。

Declaration 宣言 

func firstMatch(in string: String, 
        options: NSRegularExpression.MatchingOptions = [], 
          range: NSRange) -> NSTextCheckingResult?

Parameters パラメータ

string

The string to search. 捜す文字列。

options オプション

The matching options to use. See NSRegularExpression.MatchingOptions for possible values. 使用するマッチング・オプション。NSRegularExpression.MatchingOptionsを可能な値のために見てください。

range

The range of the string to search. 捜す文字列の範囲。

Return Value 戻り値

An NSTextCheckingResult object. This result gives the overall matched range via its range property, and the range of each individual capture group via its range(at:) method. The range {NSNotFound, 0} is returned if one of the capture groups did not participate in this particular match. NSTextCheckingResultオブジェクト。この結果は、そのrangeプロパティ経由で全体的なマッチされた範囲を、そしてそのrange(at:)メソッドによって捕獲グループそれぞれの範囲を提供します。捕獲グループの１つがこの特定のマッチに関与しないならば、範囲 {NSNotFound, 0} が返されます。

Discussion 議論

This is a convenience method that calls enumerateMatches(in:options:range:using:). これは、enumerateMatches(in:options:range:using:)を呼び出す、便宜メソッドです。

See Also 参照

Searching Strings Using Regular Expressions 正規表現を使った文字列検索

func numberOfMatches(in: String, options: NSRegularExpression.MatchingOptions, range: NSRange) -> Int
Returns the number of matches of the regular expression within the specified range of the string. この文字列の指定の範囲内における正規表現のマッチ数を返します。
func enumerateMatches(in: String, options: NSRegularExpression.MatchingOptions, range: NSRange, using: (NSTextCheckingResult?, NSRegularExpression.MatchingFlags, UnsafeMutablePointer<ObjCBool>) -> Void)
Enumerates the string allowing the Block to handle each regular expression match. 文字列を、「ブロック」に各正規表現マッチを取り扱わせて、列挙します。
func matches(in: String, options: NSRegularExpression.MatchingOptions, range: NSRange) -> [NSTextCheckingResult]
Returns an array containing all the matches of the regular expression in the string. 文字列中のその正規表現の全てのマッチを含んでいる配列を返します。
func rangeOfFirstMatch(in: String, options: NSRegularExpression.MatchingOptions, range: NSRange) -> NSRange
Returns the range of the first match of the regular expression within the specified range of the string. この文字列の指定の範囲内における正規表現の最初のマッチの範囲を返します。