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

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. ある与えられた文字列の最初の出現の範囲を発見して返します、与えられた範囲の文字列内部で、与えられたオプションを条件とします。

Declaration 宣言

- (NSRange)rangeOfString:(NSString *)searchString 
                 options:(NSStringCompareOptions)mask 
                   range:(NSRange)rangeOfReceiverToSearch;

Parameters パラメータ

searchString: The string for which to search. この文字列を求めて検索をすることになります。
mask: A mask specifying search options. The following options may be specified by combining them with the C bitwise OR operator: NSCaseInsensitiveSearch, NSLiteralSearch, NSBackwardsSearch, and NSAnchoredSearch. See String Programming Guide for details on these options. 検索オプションを指定するマスク。以下のオプションは、Cビット単位OR演算子：NSCaseInsensitiveSearch、NSLiteralSearch、NSBackwardsSearch、そしてNSAnchoredSearchで、それらを結合することによって指定されるかもしれません。String Programming Guideをこれらオプションの詳細として見てください。
rangeOfReceiverToSearch: The range within the receiver for which to search for aString. それに対してaStringを求めて検索をすることになるレシーバ内の範囲。

Raises an NSRangeException if NSRangeExceptionを引き起こします、もし

rangeOfReceiverToSearch

is invalid. が無効ならば。

Return Value 戻り値

An NSRange structure giving the location and length in the receiver of あるNSRange構造体で、レシーバの中の位置と長さを与えています

searchString

within

rangeOfReceiverToSearch

in the receiver, modulo the options in mask. The range returned is relative to the start of the string, not to the passed-in range. Returns {NSNotFound, 0} if レシーバにおいて、maskの中のオプションをモジュロします。返される範囲は、文字列の始まりに相対的です、渡される範囲にではなく。{NSNotFound, 0}を返します、もし

searchString

is not found or is empty (""). が見つけられないまたは空（""）ならば。

Discussion 議論

NSString objects are compared by checking the Unicode canonical equivalence of their code point sequences. NSStringオブジェクトは、それらのコード点シーケンスをユニコード正準同等性を調べることによって比較されます。 T

he length of the returned range and that of 返される範囲の長さと

searchString

may differ if equivalent composed character sequences are matched. のそれは、異なるかもしれません、もし同等の合成文字列が照合されるならば。

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. 与えられたオプションを使って、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。

- 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. 与えられたオプションを使って、ある与えられた範囲において見つけられた、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。

- 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: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. 文字列内部である与えられた文字列の最初の出現の範囲を発見して返します、ケースと区別的発音符を考慮しない、ロケール対応検索によって。

- enumerateLinesUsingBlock:

Enumerates all the lines in the string. 文字列の中の行を全て列挙します。

- enumerateSubstringsInRange:options:usingBlock:

Enumerates the substrings of the specified type in the specified range of the string. 文字列のこの指定された範囲の中の指定された型の下位文字列を列挙します。