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

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

Declaration 宣言

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

Parameters パラメータ

aString: 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をこれらオプションの詳細として見てください。
aRange: The range within the receiver for which to search for aString. それに対してaStringを求めて検索をすることになるレシーバ内の範囲。

Raises an NSRangeException if aRange is invalid. NSRangeExceptionを引き起こします、もしaRangeが無効ならば。
locale: The locale to use when comparing the receiver with aString. To use the current locale, pass [NSLocale currentLocale]. To use the system locale, pass nil. レシーバをaStringと比較する時に使うロケール。現在のロケールを使うには、[NSLocale currentLocale]を渡してください。システムロケールを使うには、nilを渡してください。

The locale argument affects the equality checking algorithm. For example, for the Turkish locale, case-insensitive compare matches “I” to “ı” (U+0131 LATIN SMALL DOTLESS I), not the normal “i” character. ロケール引数は、同等性検査アルゴリズムに影響を与えます。例えば、トルコ語ロケールに対して、ケースを考慮しない比較は “I” を “ı”（U+0131 LATIN SMALL DOTLESS I）に合致させます、通常の “i” 文字でなく。

Return Value 戻り値

An NSRange structure giving the location and length in the receiver of aString within aRange 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 aString is not found or is empty (""). あるNSRange構造体、このレシーバの中のaRange内のaStringのレシーバにおける位置と長さを与えています、maskでのオプションをモジュロします。返される範囲は、文字列の始まりに相対的です、渡される範囲にではなく。{NSNotFound, 0}を返します、もしaStringが見つけられないまたは空（""）ならば。

Discussion 議論

NSString objects are compared by checking the Unicode canonical equivalence of their code point sequences. The length of the returned range and that of aString may differ if equivalent composed character sequences are matched. NSStringオブジェクトは、それらのコード点シーケンスをユニコード正準同等性を調べることによって比較されます。返される範囲の長さとaStringのそれは、異なるかもしれません、もし同等な結合文字列が合致するならば。

Special Considerations 特別な注意事項

This method detects all invalid ranges (including those with negative lengths). For applications linked against macOS 10.6 and later, this error causes an exception; for applications linked against earlier releases, this error causes a warning, which is displayed just once per application execution. このメソッドは、すべての無効な範囲を検知します（負の長さでのそれらを含めて）。macOS 10.6以降に対して結び付けられるアプリケーションに対して、このエラーは例外をもたらします；以前のリリースに関連するアプリケーションに対して、このエラーは警告をもたらします、それはアプリケーション例外ごとに一度だけ表示されます。