# strreplace

Replaces a string, with another string.

## Format

    strreplace <strvar> <index> <regex> <newstr>

## Remarks

Replaces a specified <regex> string in the string variable <strvar> beginning at a specified position <index>(1-origin), with another specified <newstr> string.
If the <newstr> is ''(empty), the <regex> string is removed from <strvar>.

When the replacing succeeds, the result variable is 1 and the matched string by the <regex> is stored into the matchstr variable.
When the replacing fails, the result variable is 0.

When a user searches the multi-byte string like as Japanese, the user must configure the regular encoding by using the regexoption previously.

NOTE: When this macro command is performed, the groupmatchstr system variable is cleared.

## Example

    src='linux.txt'
    strreplace src 1 '\.txt' '.doc'
    messagebox src 'result'          ; linux.doc

    src='I can do it.'
    strreplace src 1 'can\s' ''
    messagebox src 'result'     ; 'I do it.'

    src='Microsoft Windows XP [Version 5.1.2600]'
    strmatch src '(Version \d+.\d+.)\d+'

    int2str s result
    messagebox s groupmatchstr1
    pos=result                ; 23
    mstr=groupmatchstr1       ; Version 5.1.

    strreplace src pos mstr 'Build '
    if result=1 then
    	messagebox src 'result'   ; Microsoft Windows XP [Build 2600]
    endif

## Reference

Oniguruma Regular Expressions
regexoption
strmatch
strinsert
strremove