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.
与えられたオプションを使って、ある与えられた範囲において見つけられた、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。
Parameters
パラメータ
aSet
A character set. This value must not be nil
.
ある文字集合。この値は、nil
ではいけません。
Raises an NSInvalidArgumentException
if aSet
is nil
.
NSInvalidArgumentException
を引き起こします、もしaSet
がnil
ならば。
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
演算子で結合することによって指定されるかもしれません:NSAnchoredSearch
、NSBackwardsSearch
。
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
文字と下位文字列を発見する
- containsString:
Returns a Boolean value indicating whether the string contains a given string by performing a case-sensitive, locale-unaware search.
あるブール値を返します、文字列がある与えられた文字列を含んでいるかどうか、ケース考慮する、ロケールを意識しない検索を実行することによって指し示します。
- localizedCaseInsensitiveContainsString:
Returns a Boolean value indicating whether the string contains a given string by performing a case-insensitive, locale-aware search.
あるブール値を返します、文字列がある与えられた文字列を含んでいるかどうか、ケース考慮しない、ロケールを意識する検索を実行することによって指し示します。
- localizedStandardContainsString:
Returns a Boolean value indicating whether the string contains a given string by performing a case and diacritic insensitive, locale-aware search.
あるブール値を返します、文字列がある与えられた文字列を含んでいるかどうか、ケースおよび区分摘発音符を考慮しない、ロケールを意識する検索を実行することによって指し示します。
- rangeOfCharacterFromSet:
Finds and returns the range in the string of the first character from a given character set.
ある与えられた文字集合からの最初の文字の、この文字列における範囲を発見して返します。
- rangeOfCharacterFromSet:options:
Finds and returns the range in the string of the first character, using given options, from a given character set.
与えられたオプションを使って、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。
- rangeOfString:
Finds and returns the range of the first occurrence of a given string within the string.
文字列内部である与えられた文字列の最初の出現の範囲を発見して返します。
- rangeOfString:options:
Finds and returns the range of the first occurrence of a given string within the string, subject to given options.
文字列内部である与えられた文字列の最初の出現の範囲を発見して返します、与えられたオプションを条件とします。
- rangeOfString:options:range:
Finds and returns the range of the first occurrence of a given string, within the given range of the string, subject to given options.
ある与えられた文字列の最初の出現の範囲を発見して返します、与えられた範囲の文字列内部で、与えられたオプションを条件とします。
- rangeOfString:options:range:locale:
Finds and returns the range of the first occurrence of a given string within a given range of the string, subject to given options, using the specified locale, if any.
ある与えられた文字列の最初の出現の範囲を発見して返します、与えられた範囲の文字列内部で、与えられたオプションを条件とします、指定されたロケールを使います、もしあれば。
- localizedStandardRangeOfString:
Finds and returns the range of the first occurrence of a given string within the string by performing a case and diacritic insensitive, locale-aware search.
文字列内部である与えられた文字列の最初の出現の範囲を発見して返します、ケースと区別的発音符を考慮しない、ロケール対応検索によって。