writer
6,694
edits
Changes
no edit summary
=SUBSTITUTE(txt, otext, ntext, instnum)=
<div style="font-size:30px">'''SUBSTITUTE (Text,OldText,NewText,InstanceNumber) '''</div><br/>
where
where
*<math>txt</math> is the text or reference to cell containing text, from which certain string is to be substituted,
*<math>Text</math> is the text or reference to cell containing text, from which certain string is to be substituted,
*<math>otext</math> is the old text to be replaced,
*<math>OldText</math> is the old text to be replaced,
*<math>ntext</math> is the new text that replaces the characters in old text,
*<math>NewText</math> is the new text that replaces the characters in old text,
*<math>instnum</math> is the instance number that specifies which occurrence needs to be replaced.
*<math>InstanceNumber</math> is the instance number that specifies which occurrence needs to be replaced.
**SUBSTITUTE(), substitutes specific instances of old text with new text in a text string.
== Description ==
== Description ==
SUBSTITUTE (Text,OldText,NewText,InstanceNumber)
SUBSTITUTE(txt, otext, ntext, instnum)
For Example,
For Example,
SUBSTITUTE("WELCOME", "COME", "DONE", 1) returns ''WELDONE''
SUBSTITUTE("WELCOME", "COME", "DONE", 1) returns ''WELDONE''
In above example, first instance of old text is replaced with new text.
In above example, first occurrence of original text is replaced with new text.
*SUBSTITUTE function can be used to replace specific occurrences of the text.
*SUBSTITUTE function can be used to replace specific occurrences of the text.
*If <math>txt</math> is entered directly as a part of argument, it should be enclosed in quotation marks (e.g. "TEXT").
*If <math>Text</math> is entered directly as a part of argument, it should be enclosed in quotation marks (e.g. "TEXT").
*<math>otext</math> and <math>ntext</math> should be enclosed in quotation marks (e.g. "TEXT").
*<math>OldText</math> and <math>NewText</math> should be enclosed in quotation marks (e.g. "TEXT").
*If string specified in <math>otext</math> is not part of the reference string <math>txt</math>, Calci returns the original string <math>txt</math> as a result.
*If string specified in <math>OldText</math> is not part of the reference string <math>Text</math>, Calci returns the original string <math>Text</math> as a result.
*Argument <math>instnum</math> is optional. If omitted, all instances mentioned in old text are replaced by new text.
*Argument <math>InstanceNumber</math> is optional. If omitted, all instances mentioned in old text are replaced by new text.
*<math>instnum</math> should be positive integer greater than zero, else Calci displays #NULL error message.
*<math>InstanceNumber</math> should be an integer > 0, else Calci displays #NULL error message.
== Examples ==
== Examples ==
|}
|}
=SUBSTITUTE(A1,"TUTE", "TUTION",1) : Replaces first instance of old text with new text. Returns '''SUBSTITUTION''' as output.
=SUBSTITUTE(A1,"TUTE", "TUTION",1) : Replaces first instance of old text with new text. <br />Returns '''SUBSTITUTION''' as output.
=SUBSTITUTE(A2,"123","888",2) :Replaces second instance of old text with new text. Returns '''abc123abc888''' as output.
=SUBSTITUTE(A2,"123","888",2) :Replaces second instance of old text with new text. <br />Returns '''abc123abc888''' as output.
=SUBSTITUTE(A2,"123","888") : Replaces all instances of old text with new text. Returns '''abc888abc888''' as output.
=SUBSTITUTE(A2,"123","888") : Replaces all instances of old text with new text. <br />Returns '''abc888abc888''' as output.
=SUBSTITUTE(A3,"Cost", "Selling") : Returns '''Selling Price''' as output.
=SUBSTITUTE(A3,"Cost", "Selling") : Returns '''Selling Price''' as output.
==Related Videos==
{{#ev:youtube|YvHrFS-sfiU|280|center|SUBSTITUTE}}
== See Also ==
== See Also ==
*[http://en.wikipedia.org/wiki/Autocorrection Find and Replace]
*[http://en.wikipedia.org/wiki/Autocorrection Find and Replace]
*[http://en.wikipedia.org/wiki/String_operations#String_substitution String Substitution]
*[http://en.wikipedia.org/wiki/String_operations#String_substitution String Substitution]
*[[Z_API_Functions | List of Main Z Functions]]
*[[ Z3 | Z3 home ]]