STD.Uni.LocaleFindAtStrengthReplace( source, target, replacement, locale, strength )
| source | A string containing the data to search. |
| target | A string containing the substring to search for. |
| replacement | A string containing the replacement data. |
| locale | A null-terminated string containing the language and country code to use to determine correct sort order and other operations. |
| strength | An integer value indicating how to compare. Valid values are: |
| 1 ignores accents and case, differentiating only between letters. | |
| 2 ignores case but differentiates between accents. | |
| 3 differentiates between accents and case but ignores e.g. differences between Hiragana and Katakana | |
| 4 differentiates between accents and case and e.g. Hiragana/Katakana, but ignores e.g. Hebrew cantellation marks | |
| 5 differentiates between all strings whose canonically decomposed forms (NFD--Normalization Form D) are non-identical | |
| Return: | FindAtStrengthReplace returns a UNICODE value. |
The FindAtStrengthReplace functions return the source string with the replacement string substituted for all instances of the target string. If the target string is not in the source string, it returns the source string unaltered.
Example:
STD.Uni.LocaleFindAtStrengthReplace(u'e\u00E8E\u00C9eE', u'e\u00E9', u'xyz', 'fr', 1) = u'xyzxyzxyz'; STD.Uni.LocaleFindAtStrengthReplace(u'e\u00E8E\u00C9eE', u'e\u00E9', u'xyz', 'fr', 2) = u'e\u00E8xyzeE'; STD.Uni.LocaleFindAtStrengthReplace(u'e\u00E8E\u00C9eE', u'e\u00E9', u'xyz', 'fr', 3) = u'e\u00E8E\u00C9eE';