Core Function GSub - Revision history

UberFoX: 2 revisions

2015-06-14T12:37:47Z

2 revisions

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: /* Example */

2014-12-12T05:30:04Z

Example

← Older revision		Revision as of 05:30, 12 December 2014
Line 121:		Line 121:
	// Prints		// Prints
	// h-he-el-ll-lo-o S-Sp-pu-ut-tn-ni-ik-k!		// h-he-el-ll-lo-o S-Sp-pu-ut-tn-ni-ik-k!
−	// Count: ~~@GSubCount~~	+	// Count: 12
	</syntaxhighlight>		</syntaxhighlight>

Line 132:		Line 132:
	// Prints		// Prints
	// Hello		// Hello
−	// Count: ~~@GSubCount~~	+	// Count: 1
	</syntaxhighlight>		</syntaxhighlight>

UberFoX: 1 revision

2014-08-11T21:41:08Z

1 revision

← Older revision

Revision as of 21:41, 11 August 2014

UberFoX: /* Remarks */

2014-08-07T06:32:18Z

Remarks

← Older revision		Revision as of 06:32, 7 August 2014
Line 58:		Line 58:

	You can however get the second value from GSub() from using the @GSubCount macro immediately after calling GSub().		You can however get the second value from GSub() from using the @GSubCount macro immediately after calling GSub().
−

	==== @GSubCount ====		==== @GSubCount ====

UberFoX: /* Remarks */

2014-08-07T06:32:09Z

Remarks

← Older revision		Revision as of 06:32, 7 August 2014
Line 52:		Line 52:

	This is because in Sputnik chars in a string start at 0 not 1.		This is because in Sputnik chars in a string start at 0 not 1.
		+
		+	In LUA GSub() also returns, as its second value, the total number of substitutions made.
		+
		+	However in Sputnik this second value is not returned since that would involve returning an ARRAY and that is something I don't want to do instead I want GSub() to return strings only.
		+
		+	You can however get the second value from GSub() from using the @GSubCount macro immediately after calling GSub().
		+

	==== @GSubCount ====		==== @GSubCount ====

UberFoX: /* Return Value */

2014-08-07T06:31:59Z

Return Value

← Older revision		Revision as of 06:31, 7 August 2014
Line 45:		Line 45:
	=== Return Value ===		=== Return Value ===

−	Returns a copy of String in which all occurrences of the pattern have been replaced by a replacement string specified by repl, which may be a String, an Array, or a Function.	+	Returns a string which is a copy of String in which all occurrences of the pattern have been replaced by a replacement string specified by repl, which may be a String, an Array, or a Function.
−		+
−	~~In LUA GSub() also returns, as its second value, the total number of substitutions made.~~	+
−		+
−	~~However in Sputnik this second value is not returned since that would involve returning an ARRAY and that is something I don't want to do instead I want GSub() to return strings only.~~	+
−		+
−	~~You can however get the second value from GSub() from using the @GSubCount macro immediately after calling GSub()~~.	+

	=== Remarks ===		=== Remarks ===

UberFoX: /* Return Value */

2014-08-07T06:31:14Z

Return Value

← Older revision		Revision as of 06:31, 7 August 2014
Line 47:		Line 47:
	Returns a copy of String in which all occurrences of the pattern have been replaced by a replacement string specified by repl, which may be a String, an Array, or a Function.		Returns a copy of String in which all occurrences of the pattern have been replaced by a replacement string specified by repl, which may be a String, an Array, or a Function.

−	GSub() also returns, as its second value, the total number of substitutions made.	+	In LUA GSub() also returns, as its second value, the total number of substitutions made.
		+
		+	However in Sputnik this second value is not returned since that would involve returning an ARRAY and that is something I don't want to do instead I want GSub() to return strings only.
		+
		+	You can however get the second value from GSub() from using the @GSubCount macro immediately after calling GSub().

	=== Remarks ===		=== Remarks ===

UberFoX: /* repl */

2014-08-06T20:37:47Z

repl

← Older revision		Revision as of 20:37, 6 August 2014
Line 26:		Line 26:

	If repl is a Function, then this function is called every time a match occurs, with all captured substrings passed as arguments, in order; if the pattern specifies no captures, then the whole match is passed as a sole argument.		If repl is a Function, then this function is called every time a match occurs, with all captured substrings passed as arguments, in order; if the pattern specifies no captures, then the whole match is passed as a sole argument.
		+
		+	If repl is a Call to a function such as say(), then this function is called every time a match occurs, with all captured substrings passed as arguments, in order (after the arguments you place in the call if you type say("test") then you capture two groups they will come after the "test" when calling the function); if the pattern specifies no captures, then the whole match is passed as a sole argument.

	Default: An empty string		Default: An empty string

UberFoX: /* Example */

2014-08-06T20:36:05Z

Example

← Older revision		Revision as of 20:36, 6 August 2014
Line 320:		Line 320:
	while($theSplitStart)		while($theSplitStart)
	{		{
−	$outResults[] = ~~strsub~~( $string, $theStart, $theSplitStart-1 );	+	$outResults[] = sub( $string, $theStart, $theSplitStart-1 );
	$theStart = $theSplitEnd + 1;		$theStart = $theSplitEnd + 1;
	List ( $theSplitStart, $theSplitEnd ) = find( $string, $inSplitPattern, $theStart );		List ( $theSplitStart, $theSplitEnd ) = find( $string, $inSplitPattern, $theStart );
	}		}
−	$outResults[] = ~~strsub~~( $string, $theStart );	+	$outResults[] = sub( $string, $theStart );
	return $outResults;		return $outResults;
	}		}
Line 386:		Line 386:
	// no sea takimata sanctus est Lorem		// no sea takimata sanctus est Lorem
	// ipsum dolor sit amet.		// ipsum dolor sit amet.
		+	</syntaxhighlight>
		+
		+	Format as “Title Case” in this example the function name is used as the replacement instead of function() {} it is a shorthand for it
		+
		+	<syntaxhighlight lang="sputnik">
		+	// A function to Title Case
		+	Function TitleCase( $first, $rest )
		+	{
		+	return uc($first) . lc($rest);
		+	}
		+	// Set a name to try change into Title Case
		+	my $Name = "Obi-waN kEnObi";
		+	// Use the TitleCase() function with gsub()
		+	// Notice no arguments are given to the function?
		+	// gsub() will automatically give it all the captured
		+	// groups you only need your function definition to
		+	// handle them not the call to it
		+	$Name = gsub( $Name, "(%a)([%w_']*)", titleCase() );
		+	// Print the result
		+	say $Name;
		+	// Prints
		+	// Obi-Wan Kenobi
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX: /* Example */

2014-08-06T19:17:19Z

Example

← Older revision		Revision as of 19:17, 6 August 2014
Line 306:		Line 306:
	// Prints		// Prints
	// Number of vowels: 5		// Number of vowels: 5
		+	</syntaxhighlight>
		+
		+	A custom function to Split strings made with GSub()
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Create a function that can Split strings up
		+	// when it finds the split pattern
		+	function SplitStr( $string, $inSplitPattern, $outResults )
		+	{
		+	my $outResults = array();
		+	my $theStart = 0;
		+	my List ( $theSplitStart, $theSplitEnd ) = find( $string, $inSplitPattern, $theStart );
		+	while($theSplitStart)
		+	{
		+	$outResults[] = strsub( $string, $theStart, $theSplitStart-1 );
		+	$theStart = $theSplitEnd + 1;
		+	List ( $theSplitStart, $theSplitEnd ) = find( $string, $inSplitPattern, $theStart );
		+	}
		+	$outResults[] = strsub( $string, $theStart );
		+	return $outResults;
		+	}
		+
		+	// Print on each , delim
		+	printr SplitStr("the,quickish,bown,fox,k", ',');
		+	// Prints
		+	// Array
		+	// (
		+	// [0] => the
		+	// [1] => quickish
		+	// [2] => bown
		+	// [3] => fox
		+	// [4] => k
		+	// )
		+	// Print at each sequence of numbers
		+	printr SplitStr("the111quickish22bown3333333fox444k", '%d+');
		+	// Prints
		+	// Array
		+	// (
		+	// [0] => the
		+	// [1] => quickish
		+	// [2] => bown
		+	// [3] => fox
		+	// [4] => k
		+	// )
	</syntaxhighlight>		</syntaxhighlight>