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

range(of: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 宣言 

func range(of searchString: String, 
   options mask: NSString.CompareOptions = [], 
     range rangeOfReceiverToSearch: NSRange, 
    locale: Locale?) -> NSRange

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 rangeException if aRange is invalid. rangeExceptionを引き起こします、もしaRangeが無効ならば。

locale

The locale to use when comparing the receiver with aString. To use the current locale, pass [NSLocale current]. To use the system locale, pass nil. レシーバをaStringと比較する時に使うロケール。現在のロケールを使うには、[NSLocale current]を渡してください。システムロケールを使うには、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以降に対して結び付けられるアプリケーションに対して、このエラーは例外をもたらします；以前のリリースに関連するアプリケーションに対して、このエラーは警告をもたらします、それはアプリケーション例外ごとに一度だけ表示されます。

See Also 参照

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

func contains(String) -> Bool
Returns a Boolean value indicating whether the string contains a given string by performing a case-sensitive, locale-unaware search. あるブール値を返します、文字列がある与えられた文字列を含んでいるかどうか、ケース考慮する、ロケールを意識しない検索を実行することによって指し示します。
func localizedCaseInsensitiveContains(String) -> Bool
Returns a Boolean value indicating whether the string contains a given string by performing a case-insensitive, locale-aware search. あるブール値を返します、文字列がある与えられた文字列を含んでいるかどうか、ケース考慮しない、ロケールを意識する検索を実行することによって指し示します。
func localizedStandardContains(String) -> Bool
Returns a Boolean value indicating whether the string contains a given string by performing a case and diacritic insensitive, locale-aware search. あるブール値を返します、文字列がある与えられた文字列を含んでいるかどうか、ケースおよび区分摘発音符を考慮しない、ロケールを意識する検索を実行することによって指し示します。
func rangeOfCharacter(from: CharacterSet) -> NSRange
Finds and returns the range in the string of the first character from a given character set. ある与えられた文字集合からの最初の文字の、この文字列における範囲を発見して返します。
func rangeOfCharacter(from: CharacterSet, options: NSString.CompareOptions) -> NSRange
Finds and returns the range in the string of the first character, using given options, from a given character set. 与えられたオプションを使って、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。
func rangeOfCharacter(from: CharacterSet, options: NSString.CompareOptions, range: NSRange) -> NSRange
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. 与えられたオプションを使って、ある与えられた範囲において見つけられた、ある与えられた文字集合からの最初の文字の文字列における範囲を発見して返します。
func range(of: String) -> NSRange
Finds and returns the range of the first occurrence of a given string within the string. 文字列内部である与えられた文字列の最初の出現の範囲を発見して返します。
func range(of: String, options: NSString.CompareOptions) -> NSRange
Finds and returns the range of the first occurrence of a given string within the string, subject to given options. 文字列内部である与えられた文字列の最初の出現の範囲を発見して返します、与えられたオプションを条件とします。
func range(of: String, options: NSString.CompareOptions, range: NSRange) -> NSRange
Finds and returns the range of the first occurrence of a given string, within the given range of the string, subject to given options. ある与えられた文字列の最初の出現の範囲を発見して返します、与えられた範囲の文字列内部で、与えられたオプションを条件とします。
func localizedStandardRange(of: String) -> NSRange
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. 文字列内部である与えられた文字列の最初の出現の範囲を発見して返します、ケースと区別的発音符を考慮しない、ロケール対応検索によって。
func enumerateLines((String, UnsafeMutablePointer<ObjCBool>) -> Void)
Enumerates all the lines in the string. 文字列の中の行を全て列挙します。
func enumerateSubstrings(in: NSRange, options: NSString.EnumerationOptions, using: (String?, NSRange, NSRange, UnsafeMutablePointer<ObjCBool>) -> Void)
Enumerates the substrings of the specified type in the specified range of the string. 文字列のこの指定された範囲の中の指定された型の下位文字列を列挙します。