It replaces all the found substrings of a string by a set sequence of symbols.
[in][out] The string in which you are going to replace substrings.
[in] The desired substring to replace.
[in] The string that will be inserted instead of the found one.
If the function has run successfully but no replacements have been made (the substring to replace was not found), it returns 0.
The error can result from incorrect str or find parameters (empty or non-initialized string, see StringInit() ). Besides, the error occurs if there is not enough memory to complete the replacement.