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

rangeOfCharacterFromSet:options:range:

Finds and returns the range in the string of the first character from a given character set found in a given range with given options. 与えられたオプションを使って、ある与えられた範囲において見つけられた、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。

Declaration 宣言

- (NSRange)rangeOfCharacterFromSet:(NSCharacterSet *)searchSet 
                           options:(NSStringCompareOptions)mask 
                             range:(NSRange)rangeOfReceiverToSearch;

Parameters パラメータ

aSet

A character set. This value must not be nil. ある文字集合。この値は、nilではいけません。

Raises an NSInvalidArgumentException if aSet is nil. NSInvalidArgumentExceptionを引き起こします、もしaSetnilならば。

mask

A mask specifying search options. The following options may be specified by combining them with the C bitwise OR operator: NSAnchoredSearch, NSBackwardsSearch. 検索オプションを指定するマスク。以下のオプションは、それらをCビット単位OR演算子で結合することによって指定されるかもしれません:NSAnchoredSearchNSBackwardsSearch

aRange

The range in which to search. aRange must not exceed the bounds of the receiver. 検索する範囲。aRangeは、レシーバの境界を越えてはいけません。

Raises an NSRangeException if aRange is invalid. NSRangeExceptionを引き起こします、もしaRangeが無効ならば。

Return Value 戻り値

The range in the receiver of the first character found from aSet within aRange. Returns a range of {NSNotFound, 0} if none of the characters in aSet are found. aRange内のaSetから見つけられた最初の文字のレシーバにおける範囲。{NSNotFound, 0}の範囲を返します、もしaSetの中の文字がひとつも見つけられないならば。

Discussion 議論

This method does not perform any Unicode normalization on the receiver, so canonically equivalent forms will not be matched. For example, searching the string “strüdel”—containing the decomposed characters “u” (U+0075 LATIN SMALL LETTER U) and “¨” (U+0308 COMBINING DIAERESIS)—with a character set containing the precomposed character “ü” (U+00FC LATIN SMALL LETTER U WITH DIAERESIS) would return the range {NSNotFound, 0}, because none of the characters in the set are found. このメソッドは、どんなユニコード正規化もレシーバ上で実行しません、それで正準的に同等の形式それらは一致しません。例えば、文字列 “strüdel” — 分解可能な文字 “u”(U+0075 LATIN SMALL LETTER U)と “¨”(U+0308 COMBINING DIAERESIS)を含んでいます — を合成済み文字 “ü”(U+00FC LATIN SMALL LETTER U WITH DIAERESIS)を含んでいる文字集合で捜すことは、範囲{NSNotFound, 0}を返します、なぜなら文字集合の中の文字はひとつも見つけられないからです。

See Also 参照

Finding Characters and Substrings 文字と下位文字列を発見する