Core Function SubStr - Revision history

UberFoX: 1 revision

2015-06-14T12:38:44Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

2014-08-11T21:40:39Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

2014-08-10T17:42:56Z

← Older revision		Revision as of 17:42, 10 August 2014
Line 32:		Line 32:

	Optional; If you set this parameter the substring will be replaced instead of returned so you will receive a new string with the substring replaced with the replacement text.		Optional; If you set this parameter the substring will be replaced instead of returned so you will receive a new string with the substring replaced with the replacement text.
−
−	~~If you use the ->> you can force the original string to be modified see example below.~~
−
−	~~If the replacement and the part to be replaced are the same size it wont even need to reconstruct the string it can just edit it directly in ram.~~

	=== Return Value ===		=== Return Value ===
Line 68:		Line 64:
	# Prints		# Prints
	# UberFoX!		# UberFoX!
−	~~</syntaxhighlight>~~
−
−	~~Using replacement and modifying the original string in place~~
−
−	~~<syntaxhighlight lang="sputnik">~~
−	~~# Normally when you do replacement on SubStr it returns the string~~
−	~~# with the changes made to it and leaves the original unchanged~~
−	~~# but when you use ->> you can force the original to be changed~~
−	~~# and have the replaced part returned instead example~~
−	~~$str = "UberCat!";~~
−	~~print "String: $str\n";~~
−	~~$rep = $str->>substr(4, 3, "FoX");~~
−	~~print "Replaced: $rep\n";~~
−	~~print "String: $str\n";~~
−	~~# String: UberCat!~~
−	~~# Replaced: Cat~~
−	~~# String: UberFoX!~~
	</syntaxhighlight>		</syntaxhighlight>

2014-08-06T19:45:58Z

← Older revision		Revision as of 19:45, 6 August 2014
Line 27:		Line 27:
	If count is given and is negative, then that many characters will be omitted from the end of string (after the start position has been calculated when a start is negative). If start denotes the position of this truncation or beyond, empty string will be returned.		If count is given and is negative, then that many characters will be omitted from the end of string (after the start position has been calculated when a start is negative). If start denotes the position of this truncation or beyond, empty string will be returned.

−	(Note - If you wish to extract from a start to a end position instead of from start to a number of characters you should see ~~StrSub~~())	+	(Note - If you wish to extract from a start to a end position instead of from start to a number of characters you should see Sub())

	==== replacement ====		==== replacement ====

2014-08-06T19:13:22Z

count

← Older revision		Revision as of 19:13, 6 August 2014
Line 26:		Line 26:

	If count is given and is negative, then that many characters will be omitted from the end of string (after the start position has been calculated when a start is negative). If start denotes the position of this truncation or beyond, empty string will be returned.		If count is given and is negative, then that many characters will be omitted from the end of string (after the start position has been calculated when a start is negative). If start denotes the position of this truncation or beyond, empty string will be returned.
		+
		+	(Note - If you wish to extract from a start to a end position instead of from start to a number of characters you should see StrSub())

	==== replacement ====		==== replacement ====

2014-08-06T19:01:02Z

Example

← Older revision		Revision as of 19:01, 6 August 2014
Line 71:		Line 71:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	# Normally when you do replacement on SubStr is returns the string	+	# Normally when you do replacement on SubStr it returns the string
	# with the changes made to it and leaves the original unchanged		# with the changes made to it and leaves the original unchanged
	# but when you use ->> you can force the original to be changed		# but when you use ->> you can force the original to be changed

2014-08-06T18:50:26Z

← Older revision		Revision as of 18:50, 6 August 2014
Line 31:		Line 31:
	Optional; If you set this parameter the substring will be replaced instead of returned so you will receive a new string with the substring replaced with the replacement text.		Optional; If you set this parameter the substring will be replaced instead of returned so you will receive a new string with the substring replaced with the replacement text.

−	If you use the -> you can force the original string to be modified see example below.	+	If you use the ->> you can force the original string to be modified see example below.

	If the replacement and the part to be replaced are the same size it wont even need to reconstruct the string it can just edit it directly in ram.		If the replacement and the part to be replaced are the same size it wont even need to reconstruct the string it can just edit it directly in ram.
Line 73:		Line 73:
	# Normally when you do replacement on SubStr is returns the string		# Normally when you do replacement on SubStr is returns the string
	# with the changes made to it and leaves the original unchanged		# with the changes made to it and leaves the original unchanged
−	# but when you use -> you can force the original to be changed	+	# but when you use ->> you can force the original to be changed
	# and have the replaced part returned instead example		# and have the replaced part returned instead example
	$str = "UberCat!";		$str = "UberCat!";

2014-08-06T18:28:43Z

← Older revision		Revision as of 18:28, 6 August 2014
Line 1:		Line 1:
	<pre>		<pre>
−	SubStr( <expression>, <start>, <~~end~~>, <replacement> )	+	SubStr( <expression>, <start>, <count>, <replacement> )
	</pre>		</pre>

2014-08-06T18:26:36Z

Example

2014-05-29T23:50:58Z

Example

← Older revision		Revision as of 23:50, 29 May 2014
Line 95:		Line 95:
	say substr($str, $arr); // Prints "quick"		say substr($str, $arr); // Prints "quick"

−	// Slghtly better than doing substr($str, $arr[0], $arr[1]);	+	# Slghtly better than doing substr($str, $arr[0], $arr[1]);
	</syntaxhighlight>		</syntaxhighlight>

	[[Category:Core Function]]		[[Category:Core Function]]