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

replaceOccurrences(of:with:options:range:)

Replaces all occurrences of a given string in a given range with another given string, returning the number of replacements. ある与えられた文字列の全ての発生をある与えられた範囲において別の与えられた文字列で置き換えます、置き換えの数を返します。

Declaration 宣言

func replaceOccurrences(of target: String, 
                   with replacement: String, 
                options: NSString.CompareOptions = [], 
                  range searchRange: NSRange) -> Int

Parameters パラメータ

target: The string to replace. 置き換える文字列。

Important 重要

Raises an NSInvalidArgumentException if target is nil. NSInvalidArgumentExceptionを引き起こします、もしtargetがnilであるならば。
replacement: The string with which to replace target. この文字列でtargetを置き換えることになります。

Important 重要

Raises an NSInvalidArgumentException if replacement is nil. NSInvalidArgumentExceptionを引き起こします、もしreplacementがnilであるならば。
opts: A mask specifying search options. See String Programming Guide for details. 検索オプションを指定するマスク。String Programming Guideを詳細として見てください。

If opts is NSBackwardsSearch, the search is done from the end of the range. If opts is NSAnchoredSearch, only anchored (but potentially multiple) instances are replaced. NSLiteralSearch and NSCaseInsensitiveSearch also apply. optsがNSBackwardsSearchであるならば、検索は範囲の終わりから行われます。optsがNSAnchoredSearchであるならば、ただ固定地点だけの（しかし潜在的に複数の）実例が置き換えられます。NSLiteralSearchとNSCaseInsensitiveSearchもまた適用します。
searchRange: The range of characters to replace. aRange must not exceed the bounds of the receiver. Specify searchRange as NSMakeRange(0, [receiver length]) to process the entire string. 置き換える文字範囲。aRangeは、レシーバの境界を越えてはいけません。searchRangeをNSMakeRange(0, [receiver length])として指定することで、文字列全体を処理してください。

Important 重要

Raises an NSRangeException if any part of searchRange lies beyond the end of the receiver. NSRangeExceptionを引き起こします、もしsearchRangeの何らかの部分がレシーバの終わりを越えているならば。

Return Value 戻り値

The number of replacements made. なされた置き換えの数。

Discussion 議論

This method treats the length of the string as a valid range value that returns an empty string. このメソッドは、文字列の長さをある有効な範囲値として扱います、それは空文字列を返します。