Core Function StrIndex - Revision history

UberFoX at 09:49, 19 September 2015

2015-09-19T09:49:43Z

← Older revision		Revision as of 09:49, 19 September 2015
Line 29:		Line 29:
	Success: Returns the char at the given index IF only 2 params are used.		Success: Returns the char at the given index IF only 2 params are used.

−	Success: Returns ~~1 IF~~ 3 params are used.	+	Success: Returns TRUE if 3 params are used.

−	Failure: Returns ~~empty string IF only 2 params are used.~~	+	Failure: Returns NULL
−		+
−	~~Failure: Returns 0 IF 3 params are used.~~	+

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

2015-09-16T21:49:21Z

Example

← Older revision		Revision as of 21:49, 16 September 2015
Line 92:		Line 92:
	println( $a[$i] );		println( $a[$i] );
	}		}
		+	</syntaxhighlight>
		+
		+	Using a negative index
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Set a string
		+	$a = "Hello";
		+
		+	// This is one of the few functions
		+	// that will modify the value directly
		+	// rather than return it modified.
		+	StrIndex($a, -1, "C"); // Actually changes the char in the string
		+	StrIndex($a, 2, "a"); // Actually changes the char in the string
		+	StrIndex($a, 3, "t"); // Actually changes the char in the string
		+	// Note - StrIndex with 3 parms does not return a value
		+
		+	println($a); // Prints HeatC
	</syntaxhighlight>		</syntaxhighlight>

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

2015-09-16T21:47:40Z

index

← Older revision		Revision as of 21:47, 16 September 2015
Line 17:		Line 17:
	Index of the string to get/set data to/from.		Index of the string to get/set data to/from.

−	If index is ~~lower than 0 it becomes 0 and if its higher than strings length it becomes~~ the ~~strings length.~~	+	If the index is a negative value the character position will work backwards from the length of the string.
−		+
−	~~So it~~ will ~~always do something~~.	+

	==== value ====		==== value ====

2015-06-14T12:38:45Z

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

2013-01-28T21:50:07Z

Remarks

← Older revision		Revision as of 21:50, 28 January 2013
Line 40:		Line 40:

	When setting a char at a given Index it modifies the string in place and does not create a new one.		When setting a char at a given Index it modifies the string in place and does not create a new one.
		+
		+	Sputnik 0.10 added ability to set chars directly using the [] on strings.

	=== Example ===		=== Example ===

2013-01-28T21:49:42Z

Example

← Older revision		Revision as of 21:49, 28 January 2013
Line 67:		Line 67:

	// Print all chars using the []		// Print all chars using the []
−	// The $a[$i] works to GET ~~chars but it wont work to SET~~ chars	+	// The $a[$i] works to GET chars
−	/~~/ This is because~~ of ~~how strings are handled~~ in ~~Sputnik it~~	+	for($i = 0; $i < StrLen($a); $i++)
−	// ~~would simply become an array if you tried to set data to that position~~	+	{
−	// ~~but getting data from it is no problem~~	+	println( $a[$i] );
		+	}
		+	</syntaxhighlight>
		+
		+	Example of directly using the [] instead of StrIndex
		+	<syntaxhighlight lang="sputnik">
		+	// Set a string
		+	$a = "Hello";
		+
		+	$a[1] = "C"; // Actually changes the char in the string
		+	$a[2] = "a"; // Actually changes the char in the string
		+	$a[3] = "t"; // Actually changes the char in the string
		+
		+	println($a); // Prints HCato
		+
		+
		+	// Print all chars using the []
		+	// The $a[$i] works to GET chars too
	for($i = 0; $i < StrLen($a); $i++)		for($i = 0; $i < StrLen($a); $i++)
	{		{

2011-12-13T14:50:42Z

← Older revision		Revision as of 14:50, 13 December 2011
Line 29:		Line 29:
	=== Return Value ===		=== Return Value ===

−	Success: Returns the char the given index IF only 2 params are used.	+	Success: Returns the char at the given index IF only 2 params are used.
−	Success: Returns ~~nothing~~ IF 3 params are used.	+
		+	Success: Returns 1 IF 3 params are used.
		+
		+	Failure: Returns empty string IF only 2 params are used.
		+
		+	Failure: Returns 0 IF 3 params are used.
		+
		+	=== Remarks ===
		+
		+	When setting a char at a given Index it modifies the string in place and does not create a new one.

	=== Example ===		=== Example ===
Line 43:		Line 52:
	StrIndex($a, 1, "C"); // Actually changes the char in the string		StrIndex($a, 1, "C"); // Actually changes the char in the string
	StrIndex($a, 2, "a"); // Actually changes the char in the string		StrIndex($a, 2, "a"); // Actually changes the char in the string
−	~~$b =~~ StrIndex($a, 3, "t"); // Actually changes the char in the string	+	StrIndex($a, 3, "t"); // Actually changes the char in the string
	// Note - StrIndex with 3 parms does not return a value		// Note - StrIndex with 3 parms does not return a value

	println($a); // Prints HCato		println($a); // Prints HCato
−	~~println($b); // Does not print anything~~

	// Print all chars		// Print all chars

2011-11-29T15:05:41Z

Example

← Older revision		Revision as of 15:05, 29 November 2011
Line 66:		Line 66:
	{		{
	println( $a[$i] );		println( $a[$i] );
−	~~// StrIndex with 2 params only READS the strings chars~~
−	~~// It does not modify them~~
	}		}
	</syntaxhighlight>		</syntaxhighlight>

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

2011-11-29T14:57:36Z

Example

← Older revision		Revision as of 14:57, 29 November 2011
Line 55:		Line 55:
	// StrIndex with 2 params only READS the strings chars		// StrIndex with 2 params only READS the strings chars
	// It does not modify them		// It does not modify them
−	}~~$result = isEmpty("");~~	+	}
−	~~Println("Result:" , $result);~~	+
−	~~</syntaxhighlight>~~	+

−	~~Will return 0;~~	+
−	~~<syntaxhighlight lang="sputnik">~~	+	// Print all chars using the []
−	$~~result~~ = ~~isEmpty~~(~~"The fuzzy blue sweaters..."~~);	+	// The $a[$i] works to GET chars but it wont work to SET chars
−	~~Println~~(~~"Result:" ,~~ $~~result~~);	+	// This is because of how strings are handled in Sputnik it
		+	// would simply become an array if you tried to set data to that position
		+	// but getting data from it is no problem
		+	for($i = 0; $i < StrLen($a); $i++)
		+	{
		+	println( $a[$i] );
		+	// StrIndex with 2 params only READS the strings chars
		+	// It does not modify them
		+	}
	</syntaxhighlight>		</syntaxhighlight>

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