Difference between revisions of "Documentation/How Tos/Calc: SUBSTITUTE function"
From Apache OpenOffice Wiki
< Documentation | How Tos
(Initial content) |
m (→Syntax:) |
||
Line 6: | Line 6: | ||
=== Syntax: === | === Syntax: === | ||
<tt>'''SUBSTITUTE(originaltext; oldtext; newtext; which)'''</tt> | <tt>'''SUBSTITUTE(originaltext; oldtext; newtext; which)'''</tt> | ||
− | : | + | : In <tt>'''originaltext'''</tt>, removes <tt>'''oldtext'''</tt>, inserts <tt>'''newtext'''</tt> in its place, and returns the result. <tt>'''oldtext'''</tt> and <tt>'''newtext'''</tt> can have different lengths. |
: <tt>'''which'''</tt> (optional) is a number which specifies which occurrence of <tt>'''oldtext'''</tt> to replace (counting from the left). If omitted, <u>all</u> occurrences are replaced. | : <tt>'''which'''</tt> (optional) is a number which specifies which occurrence of <tt>'''oldtext'''</tt> to replace (counting from the left). If omitted, <u>all</u> occurrences are replaced. |
Revision as of 08:04, 25 January 2008
SUBSTITUTE
Substitutes new text for old text in a text string.
Syntax:
SUBSTITUTE(originaltext; oldtext; newtext; which)
- In originaltext, removes oldtext, inserts newtext in its place, and returns the result. oldtext and newtext can have different lengths.
- which (optional) is a number which specifies which occurrence of oldtext to replace (counting from the left). If omitted, all occurrences are replaced.
Example:
SUBSTITUTE("castle"; "stl"; "v")
- returns cave.
SUBSTITUTE("a red red rose"; "red"; "white")
- returns a white white rose. All occurrences of red are replaced if which is omitted.
SUBSTITUTE("a red red rose"; "red"; "and white"; 2)
- returns a red and white rose. The second occurrence of red is replaced.