The documentation merely "assumes" that you know what the compiler-term lvalue means. What it means is what has been done here. Another useful technique is to use the optional fourth-argument of the substr() function to perform the substitution while returning what used to be there ... very handy if for any reason you need to know what it is you just substituted.
Comment on Re: How do you perform this substitution?