Replace (String function) - Revision history

Dme: /* Examples */

2018-12-07T19:19:15Z

Examples

← Older revision		Revision as of 19:19, 7 December 2018
Line 55:		Line 55:
	%out is How much would achuck chuck		%out is How much would achuck chuck
	</p>		</p>
			The following example shows how to remove blanks:
			<!--SOUL.DME.276.QA in QASHR-->
			<p class="code">begin
			%x is longstring
			%x = 'a spaced out woodchuck'
			printText /{%x:replace(' ', '')}/
			end
			</p>
			The result is:
			<p class="output">/aspacedoutwoodchuck/</p>

	==See also==		==See also==
	{{Template:String:Replace footer}}		{{Template:String:Replace footer}}

JAL: /* Examples */

2012-11-05T21:05:10Z

Examples

← Older revision		Revision as of 21:05, 5 November 2012
Line 32:		Line 32:

	==Examples==		==Examples==
	~~<ol><li>~~The following request shows two examples of <var>Replace</var> calls against the same input string: the first call replaces two occurrences of a specified <var class="term">substring</var>; the second removes all occurrences of a different <var class="term">substring</var>.		The following request shows two examples of <var>Replace</var> calls against the same input string: the first call replaces two occurrences of a specified <var class="term">substring</var>; the second removes all occurrences of a different <var class="term">substring</var>.
	<p class="code">begin		<p class="code">begin
	%x is longstring		%x is longstring
Line 54:		Line 54:
	<p class="output">%out is How much ?od ?uld a ?odchuck chuck		<p class="output">%out is How much ?od ?uld a ?odchuck chuck
	%out is How much would achuck chuck		%out is How much would achuck chuck
	</p~~></ol~~>		</p>

	==See also==		==See also==
	{{Template:String:Replace footer}}		{{Template:String:Replace footer}}

JAL: /* Syntax terms */

2012-11-05T21:04:41Z

Syntax terms

← Older revision		Revision as of 21:04, 5 November 2012
Line 8:		Line 8:
	<tr><th>%outString</th>		<tr><th>%outString</th>
	<td>A string variable to receive the modified input <var class="term">string</var>.</td></tr>		<td>A string variable to receive the modified input <var class="term">string</var>.</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>The <var class="term">string</var> to which the method is applied.</td></tr>		<td>The <var class="term">string</var> to which the method is applied.</td></tr>

	<tr><th>substring</th>		<tr><th>substring</th>
	<td>The <var class="term">substring</var> that the method attempts to replace in the input <var class="term">string</var>. If <var class="term">string</var> contains no occurrences of <var class="term">substring</var>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>. If <var class="term">substring</var> is null or longer than 255 characters, the request is cancelled.</td></tr>		<td>The <var class="term">substring</var> that the method attempts to replace in the input <var class="term">string</var>. If <var class="term">string</var> contains no occurrences of <var class="term">substring</var>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>. If <var class="term">substring</var> is null or longer than 255 characters, the request is cancelled.</td></tr>

	<tr><th>replacement</th>		<tr><th>replacement</th>
	<td>A string that contains the characters that replace the specified <var class="term">substring</var>. If <var class="term">replacement</var> is:<ul><li><b><i>not specified</i></b>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>;<li><b><i>longer than 255 characters</i></b>, the request is cancelled;<li><b><i>null</i></b>, the <var class="term">substring</var> characters are removed from <var class="term">string</var>.</ul></td></tr>		<td>A string that contains the characters that replace the specified <var class="term">substring</var>. If <var class="term">replacement</var> is:<ul><li><b><i>not specified</i></b>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>;<li><b><i>longer than 255 characters</i></b>, the request is cancelled;<li><b><i>null</i></b>, the <var class="term">substring</var> characters are removed from <var class="term">string</var>.</ul></td></tr>

	<tr><th><var>Count</var></th>		<tr><th><var>Count</var></th>
	<td>An optional, but ~~<var>~~[[~~Methods~~#Named parameters\|~~NameRequired~~]]~~</var>~~, argument that is the number of occurrences of <var class="term">substring</var> to replace. Only values greater than 0 are valid. If <var class="term">count</var> is:<ul><li><b><i>less</i></b> than the number of occurrences of the <var class="term">substring</var>, only the first <var class="term">count</var> occurrences are substituted;<li><b><i>greater</i></b> than or <b><i>equal</i></b> to the number of occurrences of the <var class="term">substring</var>, all occurrences of the given <var class="term">substring</var> are substituted;<li><b><i>not specified</i></b>, all occurrences are substituted.</ul></td></tr>		<td>An optional, but [[Notation conventions for methods#Named parameters\|name required]], argument that is the number of occurrences of <var class="term">substring</var> to replace. Only values greater than 0 are valid. If <var class="term">count</var> is:
			<ul>
			<li><b><i>less</i></b> than the number of occurrences of the <var class="term">substring</var>, only the first <var class="term">count</var> occurrences are substituted.
			<li><b><i>greater</i></b> than or <b><i>equal</i></b> to the number of occurrences of the <var class="term">substring</var>, all occurrences of the given <var class="term">substring</var> are substituted.
			<li><b><i>not specified</i></b>, all occurrences are substituted.</ul></td></tr>
	</table>		</table>

Goff at 11:27, 10 May 2011

2011-05-10T11:27:06Z

← Older revision		Revision as of 11:27, 10 May 2011
Line 1:		Line 1:
	{{Template:String:Replace subtitle}}		{{Template:String:Replace subtitle}}

	The <var>Replace</var> [[Intrinsic classes\|intrinsic]] function replaces one, or multiple, occurrences of a substring within the method object input string with a substitute string, returning the modified version of the input string.		The <var>Replace</var> [[Intrinsic classes\|intrinsic]] function replaces one, or multiple, occurrences of a substring within the method object input string with a substitute string, returning the modified version of the input string.

Goff at 01:10, 10 May 2011

2011-05-10T01:10:06Z

← Older revision		Revision as of 01:10, 10 May 2011
Line 1:		Line 1:
	{{Template:String:Replace subtitle}}		{{Template:String:Replace subtitle}}

	Th <var>Replace</var> [[Intrinsic classes\|intrinsic]] function replaces one, or multiple, occurrences of a substring within the method object input string with a substitute string, returning the modified version of the input string.		The <var>Replace</var> [[Intrinsic classes\|intrinsic]] function replaces one, or multiple, occurrences of a substring within the method object input string with a substitute string, returning the modified version of the input string.

	==Syntax==		==Syntax==

JALWiccan: 1 revision

2011-05-04T17:46:27Z

1 revision

← Older revision	Revision as of 17:46, 4 May 2011
(No difference)

JALWiccan: 1 revision

2011-05-04T17:46:25Z

1 revision

← Older revision		Revision as of 17:46, 4 May 2011
Line 22:		Line 22:
	<ul><li>The search for the target <var class="term">substring</var> is context sensitive; <b><i>case matters</i></b> in the attempt to find, as well as in the replacement of, the target characters.		<ul><li>The search for the target <var class="term">substring</var> is context sensitive; <b><i>case matters</i></b> in the attempt to find, as well as in the replacement of, the target characters.
	<li>Calling <var>Replace</var> with an empty replacement string argument is equivalent to using <var>[[Remove (String function)\|Remove]]</var>.		<li>Calling <var>Replace</var> with an empty replacement string argument is equivalent to using <var>[[Remove (String function)\|Remove]]</var>.
	<li><var>Replace</var> is available as of <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.3.</ul>		<li><var>Replace</var> is available as of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3.</ul>

	==Examples==		==Examples==

JALWiccan: 1 revision

2011-04-13T00:21:18Z

1 revision

← Older revision	Revision as of 00:21, 13 April 2011
(No difference)

Goff: printtext and fix number -> count in syntax terms

2011-04-13T00:21:16Z

printtext and fix number -> count in syntax terms

← Older revision		Revision as of 00:21, 13 April 2011
Line 15:		Line 15:
	<tr><th>replacement</th>		<tr><th>replacement</th>
	<td>A string that contains the characters that replace the specified <var class="term">substring</var>. If <var class="term">replacement</var> is:<ul><li><b><i>not specified</i></b>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>;<li><b><i>longer than 255 characters</i></b>, the request is cancelled;<li><b><i>null</i></b>, the <var class="term">substring</var> characters are removed from <var class="term">string</var>.</ul></td></tr>		<td>A string that contains the characters that replace the specified <var class="term">substring</var>. If <var class="term">replacement</var> is:<ul><li><b><i>not specified</i></b>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>;<li><b><i>longer than 255 characters</i></b>, the request is cancelled;<li><b><i>null</i></b>, the <var class="term">substring</var> characters are removed from <var class="term">string</var>.</ul></td></tr>
	<tr><th>Count</th>		<tr><th><var>Count</var></th>
	<td>An optional, but <var>[[Methods#Named parameters\|NameRequired]]</var>, argument that is the number of occurrences of <var class="term">substring</var> to replace. Only values greater than 0 are valid. If <var class="term">count</var> is:<ul><li><b><i>less</i></b> than the number of occurrences of the <var class="term">substring</var>, only the first <var class="term">count</var> occurrences are substituted;<li><b><i>greater</i></b> than or <b><i>equal</i></b> to the number of occurrences of the <var class="term">substring</var>, all occurrences of the given <var class="term">substring</var> are substituted;<li><b><i>not specified</i></b>, all occurrences are substituted.</ul></td></tr>		<td>An optional, but <var>[[Methods#Named parameters\|NameRequired]]</var>, argument that is the number of occurrences of <var class="term">substring</var> to replace. Only values greater than 0 are valid. If <var class="term">count</var> is:<ul><li><b><i>less</i></b> than the number of occurrences of the <var class="term">substring</var>, only the first <var class="term">count</var> occurrences are substituted;<li><b><i>greater</i></b> than or <b><i>equal</i></b> to the number of occurrences of the <var class="term">substring</var>, all occurrences of the given <var class="term">substring</var> are substituted;<li><b><i>not specified</i></b>, all occurrences are substituted.</ul></td></tr>
	</table>		</table>

Goff: printtext and fix number -> count in syntax terms

2011-02-23T09:08:44Z

printtext and fix number -> count in syntax terms

← Older revision		Revision as of 09:08, 23 February 2011
Line 16:		Line 16:
	<td>A string that contains the characters that replace the specified <var class="term">substring</var>. If <var class="term">replacement</var> is:<ul><li><b><i>not specified</i></b>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>;<li><b><i>longer than 255 characters</i></b>, the request is cancelled;<li><b><i>null</i></b>, the <var class="term">substring</var> characters are removed from <var class="term">string</var>.</ul></td></tr>		<td>A string that contains the characters that replace the specified <var class="term">substring</var>. If <var class="term">replacement</var> is:<ul><li><b><i>not specified</i></b>, <var class="term">%outstring</var> is set to a copy of <var class="term">string</var>;<li><b><i>longer than 255 characters</i></b>, the request is cancelled;<li><b><i>null</i></b>, the <var class="term">substring</var> characters are removed from <var class="term">string</var>.</ul></td></tr>
	<tr><th>Count</th>		<tr><th>Count</th>
	<td>An optional, but <var>[[Methods#Named parameters\|NameRequired]]</var>, argument that is the number of occurrences of <var class="term">substring</var> to replace. Only values greater than 0 are valid. If <i>~~number~~</i> is:<ul><li><b><i>less</i></b> than the number of occurrences of the <var class="term">substring</var>, only the first <i>~~number~~</i> of occurrences are substituted;<li><b><i>greater</i></b> than or <b><i>equal</i></b> to the number of occurrences of the <var class="term">substring</var>, all occurrences of the given <var class="term">substring</var> are substituted;<li><b><i>not specified</i></b>, all occurrences are substituted.</ul></td></tr>		<td>An optional, but <var>[[Methods#Named parameters\|NameRequired]]</var>, argument that is the number of occurrences of <var class="term">substring</var> to replace. Only values greater than 0 are valid. If <var class="term">count</var> is:<ul><li><b><i>less</i></b> than the number of occurrences of the <var class="term">substring</var>, only the first <var class="term">count</var> occurrences are substituted;<li><b><i>greater</i></b> than or <b><i>equal</i></b> to the number of occurrences of the <var class="term">substring</var>, all occurrences of the given <var class="term">substring</var> are substituted;<li><b><i>not specified</i></b>, all occurrences are substituted.</ul></td></tr>
	</table>		</table>

Line 22:		Line 22:
	<ul><li>The search for the target <var class="term">substring</var> is context sensitive; <b><i>case matters</i></b> in the attempt to find, as well as in the replacement of, the target characters.		<ul><li>The search for the target <var class="term">substring</var> is context sensitive; <b><i>case matters</i></b> in the attempt to find, as well as in the replacement of, the target characters.
	<li>Calling <var>Replace</var> with an empty replacement string argument is equivalent to using <var>[[Remove (String function)\|Remove]]</var>.		<li>Calling <var>Replace</var> with an empty replacement string argument is equivalent to using <var>[[Remove (String function)\|Remove]]</var>.
	<li><var>Replace</var> is available as of <var class="product">[[Sirius Mods]]</var> Version 7.3.</ul>		<li><var>Replace</var> is available as of <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.3.</ul>

	==Examples==		==Examples==
Line 36:		Line 36:
	%repl = '?'		%repl = '?'
	%out = %x:replace(%substr, %repl, Count=2)		%out = %x:replace(%substr, %repl, Count=2)
	printText {~} is {%out}		[[PrintText statement\|printText]] {~} is {%out}

	%substr = ' wood'		%substr = ' wood'
Line 50:		Line 50:

	==See also==		==See also==
	~~<ul><li>For details of the <var>printtext</var> statement, please see <var>[[Intrinsic classes#printtext\|printText]]</var>.</ul>~~
	{{Template:String:Replace footer}}		{{Template:String:Replace footer}}