$substitute()
DESCRIPTION
in a string, replace a substring with another substring at the
specified instance of the first substring
or:
in a string, replace every instance of a substring with another substring
SYNOPSIS
$substitute(s1,s2,s3,i)
or:
$substitute(s1,s2,s3)
ARGUMENTS
s1 - a quoted string, or string expression
s2 - a quoted string, or string expression
s3 - a quoted string, or string expression
i - a positive integer, or integer expression, greater than or equal to one
or:
s1 - a quoted string, or string expression
s2 - a quoted string, or string expression
s3 - a quoted string, or string expression
EXAMPLES
# pikt +C 'output $substitute("she loves me yeah yeah yeah","yeah","no",1)'
she loves me no yeah yeah
# pikt +C 'output $substitute("she loves me yeah yeah yeah","yeah","no",2)'
she loves me yeah no yeah
# pikt +C 'output $substitute("she loves me yeah yeah yeah","yeah","no",3)'
she loves me yeah yeah no
# pikt +C 'output $substitute("she loves me yeah yeah yeah","yeah","no",4)'
she loves me yeah yeah yeah
# pikt +C 'output $substitute("she loves me yeah yeah yeah","yeah","no")'
she loves me no no no
# pikt +C 'output $substitute("she loves me yeah yeah yeah","yeah","")'
she loves me
# pikt +C 'output $substitute($substitute("she loves me yeah yeah yeah","yeah",""),"loves","hates",1)'
she hates me
SEE ALSO
$replace()
String Functions
Numerical Functions
