Language Reference - Revision history

UberFoX: /* Operator ^= */

2015-09-27T11:57:03Z

Operator ^=

← Older revision		Revision as of 11:57, 27 September 2015
Line 2,414:		Line 2,414:

	<pre>		<pre>
−	$var \| 2;	+	$var ^ 2;
	</pre>		</pre>

UberFoX: /* Operator ^= */

2015-09-27T11:16:50Z

Operator ^=

← Older revision		Revision as of 11:16, 27 September 2015
Line 2,256:		Line 2,256:

	<pre>		<pre>
−	$var \|= 2;	+	$var ^= 2;
	</pre>		</pre>

UberFoX: /* Casting */

2015-09-26T23:01:05Z

Casting

← Older revision		Revision as of 23:01, 26 September 2015
Line 1,307:		Line 1,307:
	$a = "Hello World";		$a = "Hello World";
	printr( $a ~~ Array ? $a : (array)$a );		printr( $a ~~ Array ? $a : (array)$a );
−	~~</syntaxhighlight>~~
−
−	~~A rather hidden cast is the char* it can be used to get a pointer to a strings physical memory address example~~
−	~~<syntaxhighlight lang="sputnik">~~
−	~~$a = "Testy";~~
−	~~$p = (char*)$a;~~
−	~~printf("Address is %p and value is %s\n", (IntPtr)$p, (string)$p);~~
−	~~// Warning when you do (char*) it will forcefully~~
−	~~// convert the variable to a string if it is not~~
−	~~// already a string~~
−	~~// If you desire a less forceful way check out the Fixed() statement~~
	</syntaxhighlight>		</syntaxhighlight>

UberFoX: /* Enum */

2015-09-26T18:20:18Z

Enum

← Older revision		Revision as of 18:20, 26 September 2015
Line 1,117:		Line 1,117:
	</syntaxhighlight>		</syntaxhighlight>

−	You can also define an enum as an ~~override~~ that will replace an existing enum with the same name example	+	You can also define an enum as an replacement that will replace an existing enum with the same name example
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	enum Cat		enum Cat
Line 1,125:		Line 1,125:
	};		};

−	[~~Override~~("true")]	+	[Replace("true")]
	enum Cat		enum Cat
	{		{
Line 1,136:		Line 1,136:
	</syntaxhighlight>		</syntaxhighlight>

−	You can define an enum with AddOnce so if another enum using same name tries to get added no error will be shown but it will reject it (~~override~~ takes precedence over AddOnce)	+	You can define an enum with AddOnce so if another enum using same name tries to get added no error will be shown but it will reject it (Replace takes precedence over AddOnce)

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">

UberFoX: /* Arrays */

2015-09-26T18:07:15Z

Arrays

← Older revision		Revision as of 18:07, 26 September 2015
Line 796:		Line 796:
	// Reverse of above		// Reverse of above
	if ($firstarray !== $secondarray)		if ($firstarray !== $secondarray)
−	// Compare the full array and all elements requiring a perfect match	+	// (As string) Compare the full array and all elements requiring a perfect match
	if ($firstarray eq $secondarray)		if ($firstarray eq $secondarray)
−	// Reverse of above	+	// (As string) Reverse of above
	if ($firstarray neq $secondarray)		if ($firstarray neq $secondarray)
−	// Compare the full array and all elements requiring a perfect match (case insensitive)	+	// (As string) Compare the full array and all elements requiring a perfect match (case insensitive)
	if ($firstarray eqi $secondarray)		if ($firstarray eqi $secondarray)
−	// Reverse of above	+	// (As string) Reverse of above
	if ($firstarray neqi $secondarray)		if ($firstarray neqi $secondarray)
−	// Compare if first is lower than second	+	// (As string) Compare if first is lower than second
	if ($firstarray lt $secondarray)		if ($firstarray lt $secondarray)
−	// Compare if first is greater than second	+	// (As string) Compare if first is greater than second
	if ($firstarray gt $secondarray)		if ($firstarray gt $secondarray)
−	// Compare if first is lower than or equal to second	+	// (As string) Compare if first is lower than or equal to second
	if ($firstarray le $secondarray)		if ($firstarray le $secondarray)
−	// Compare if first is greater than or equal to second	+	// (As string) Compare if first is greater than or equal to second
	if ($firstarray ge $secondarray)		if ($firstarray ge $secondarray)
−	// Compare if first is lower than second (case insensitive)	+	// (As string) Compare if first is lower than second (case insensitive)
	if ($firstarray lti $secondarray)		if ($firstarray lti $secondarray)
−	// Compare if first is lower than or equal to second (case insensitive)	+	// (As string) Compare if first is lower than or equal to second (case insensitive)
	if ($firstarray gti $secondarray)		if ($firstarray gti $secondarray)
−	// Compare if first is lower than or equal to second (case insensitive)	+	// (As string) Compare if first is lower than or equal to second (case insensitive)
	if ($firstarray lei $secondarray)		if ($firstarray lei $secondarray)
−	// Compare if first is greater than second (case insensitive)	+	// (As string) Compare if first is greater than second (case insensitive)
	if ($firstarray gei $secondarray)		if ($firstarray gei $secondarray)
−	// Compare if first is lower or greater than second	+	// (As string) Compare if first is lower or greater than second
	if ($firstarray lg $secondarray)		if ($firstarray lg $secondarray)
−	// Compare if first is lower or greater than second (case insensitive)	+	// (As string) Compare if first is lower or greater than second (case insensitive)
	if ($firstarray lgi $secondarray)		if ($firstarray lgi $secondarray)
−		+	// (As string) Tests if two arrays are lower(-1), equal (0) or higher (1)
−	// ~~Note~~ if ~~you use < > <= >= <> etc~~	+	if ($firstarray cmp $secondarray)
−	// ~~the~~ arrays ~~will be converted into their index size~~	+	// (As string) Tests if two arrays are lower(-1), equal (0) or higher (1) (case insensitive)
−	// ~~so a 10 element array becomes the number 10 in such an IF~~	+	if ($firstarray cmpi $secondarray)
−	// ~~only the~~ =~~= etc can be used~~ to ~~compare the whole array~~	+	// (As string) Compare if first is lower than second
		+	if ($firstarray < $secondarray)
		+	// (As string) Compare if first is greater than second
		+	if ($firstarray > $secondarray)
		+	// (As string) Compare if first is lower than or equal to second
		+	if ($firstarray <= $secondarray)
		+	// (As string) Compare if first is greater than or equal to second
		+	if ($firstarray >= $secondarray)
		+	// (As string) Compare if first is lower or greater than second
		+	if ($firstarray <> $secondarray)
	</syntaxhighlight>		</syntaxhighlight>

UberFoX: /* Arrays */

2015-09-26T17:40:40Z

Arrays

← Older revision		Revision as of 17:40, 26 September 2015
Line 789:		Line 789:
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	// Compare the full array and all elements requiring a perfect match		// Compare the full array and all elements requiring a perfect match
−	if($firstarray == $secondarray)	+	if ($firstarray == $secondarray)
	// Reverse of above		// Reverse of above
−	if($firstarray != $secondarray)	+	if ($firstarray != $secondarray)
	// Compare the full array and all elements requiring a even more perfect match		// Compare the full array and all elements requiring a even more perfect match
−	if($firstarray === $secondarray)	+	if ($firstarray === $secondarray)
	// Reverse of above		// Reverse of above
−	if($firstarray !== $secondarray)	+	if ($firstarray !== $secondarray)
	// Compare the full array and all elements requiring a perfect match		// Compare the full array and all elements requiring a perfect match
−	if($firstarray eq $secondarray)	+	if ($firstarray eq $secondarray)
	// Reverse of above		// Reverse of above
−	if($firstarray neq $secondarray)	+	if ($firstarray neq $secondarray)
	// Compare the full array and all elements requiring a perfect match (case insensitive)		// Compare the full array and all elements requiring a perfect match (case insensitive)
−	if($firstarray eqi $secondarray)	+	if ($firstarray eqi $secondarray)
	// Reverse of above		// Reverse of above
−	if($firstarray neqi $secondarray)	+	if ($firstarray neqi $secondarray)
		+	// Compare if first is lower than second
		+	if ($firstarray lt $secondarray)
		+	// Compare if first is greater than second
		+	if ($firstarray gt $secondarray)
		+	// Compare if first is lower than or equal to second
		+	if ($firstarray le $secondarray)
		+	// Compare if first is greater than or equal to second
		+	if ($firstarray ge $secondarray)
		+	// Compare if first is lower than second (case insensitive)
		+	if ($firstarray lti $secondarray)
		+	// Compare if first is lower than or equal to second (case insensitive)
		+	if ($firstarray gti $secondarray)
		+	// Compare if first is lower than or equal to second (case insensitive)
		+	if ($firstarray lei $secondarray)
		+	// Compare if first is greater than second (case insensitive)
		+	if ($firstarray gei $secondarray)
		+	// Compare if first is lower or greater than second
		+	if ($firstarray lg $secondarray)
		+	// Compare if first is lower or greater than second (case insensitive)
		+	if ($firstarray lgi $secondarray)

	// Note if you use < > <= >= <> etc		// Note if you use < > <= >= <> etc

UberFoX: /* Arrays */

2015-09-26T17:32:48Z

Arrays

← Older revision		Revision as of 17:32, 26 September 2015
Line 751:		Line 751:
	$a = array( 1, $b, 3, 4 );		$a = array( 1, $b, 3, 4 );

−	# So $a becomes array( 1, "cat", "dog", 3, 4 );	+	# So $a becomes array( 1, array( "cat" => "meow", "dog" => "woof" ), 3, 4 );
	# If we didnt include the [<>] then $b itself would		# If we didnt include the [<>] then $b itself would
	# be inserted directly into $a rather than just copying		# be inserted directly into $a rather than just copying

UberFoX: /* Arrays */

2015-09-26T17:27:05Z

Arrays

← Older revision		Revision as of 17:27, 26 September 2015
Line 660:		Line 660:
	println("lol[98] :" . $lol[98]);		println("lol[98] :" . $lol[98]);
	println("lol[99] :" . $lol[99]);		println("lol[99] :" . $lol[99]);
		+	</syntaxhighlight>
		+
		+
		+	In the above example you can see simply typing $var[index] = will cause it to create that index (part of the array) and fill it with what you type, The array will create the new keys (indexes) as you use them you will notice that index 4 to 98 are missing? This is because Sputnik arrays only create keys if they need to and will never fill in gaps for you.
		+
		+	You can of course force it to fix the array indexes so it goes from 0 upwards properly like:
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Create a simple array with 4 elements
		+	my $array = array(1, 2, 3, 4);
		+	// Modify it
		+	$array[2] = "Hello";
		+	$array[1] = "hmmm";
		+	$array[99] = "hi there!";
		+	// Print the details of the array
		+	order $array; // Smooth out the array
		+	printr $array;
		+	// PRINTS
		+	// Array
		+	// (
		+	// [0] => 1
		+	// [1] => hmmm
		+	// [2] => Hello
		+	// [3] => 4
		+	// [4] => hi there!
		+	// )
	</syntaxhighlight>		</syntaxhighlight>

Line 705:		Line 731:
	println( "lol[1][3][0] :" . $lol[1][3][0] );		println( "lol[1][3][0] :" . $lol[1][3][0] );
	println( "lol[1][3][1] :" . $lol[1][3][1] );		println( "lol[1][3][1] :" . $lol[1][3][1] );
−	~~</syntaxhighlight>~~
−
−	In the above example you can see simply typing $var[index] = will cause it to create that index (part of the array) and fill it with what you type, The array will create the new keys (indexes) as you use them you will notice that index 4 to 98 are missing? This is because Sputnik arrays only create keys if they need to and will never fill in gaps for you.
−
−	~~You can of course force it to fix the array indexes so it goes from 0 upwards properly like:~~
−
−	~~<syntaxhighlight lang="sputnik">~~
−	~~// Create a simple array with 4 elements~~
−	~~my $array = array(1, 2, 3, 4);~~
−	~~// Modify it~~
−	~~$array[2] = "Hello";~~
−	~~$array[1] = "hmmm";~~
−	~~$array[99] = "hi there!";~~
−	~~// Print the details of the array~~
−	~~order $array; // Smooth out the array~~
−	~~printr $array;~~
−	~~// PRINTS~~
−	~~// Array~~
−	~~// (~~
−	~~// [0] => 1~~
−	~~// [1] => hmmm~~
−	~~// [2] => Hello~~
−	~~// [3] => 4~~
−	~~// [4] => hi there!~~
−	~~// )~~
	</syntaxhighlight>		</syntaxhighlight>

UberFoX: /* Arrays */

2015-09-26T17:26:38Z

Arrays

← Older revision		Revision as of 17:26, 26 September 2015
Line 689:		Line 689:
	printr($lol);		printr($lol);
	</syntaxhighlight>		</syntaxhighlight>
−
−	In the above example you can see simply typing $var[index] = will cause it to create that index (part of the array) and fill it with what you type, The array will be automatically expanded to the size you request all the elements in the gap that it fills in will be empty strings ready for use (As seen in index 98).

	Example of Multi-dimensional array		Example of Multi-dimensional array
Line 707:		Line 705:
	println( "lol[1][3][0] :" . $lol[1][3][0] );		println( "lol[1][3][0] :" . $lol[1][3][0] );
	println( "lol[1][3][1] :" . $lol[1][3][1] );		println( "lol[1][3][1] :" . $lol[1][3][1] );
		+	</syntaxhighlight>
		+
		+	In the above example you can see simply typing $var[index] = will cause it to create that index (part of the array) and fill it with what you type, The array will create the new keys (indexes) as you use them you will notice that index 4 to 98 are missing? This is because Sputnik arrays only create keys if they need to and will never fill in gaps for you.
		+
		+	You can of course force it to fix the array indexes so it goes from 0 upwards properly like:
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Create a simple array with 4 elements
		+	my $array = array(1, 2, 3, 4);
		+	// Modify it
		+	$array[2] = "Hello";
		+	$array[1] = "hmmm";
		+	$array[99] = "hi there!";
		+	// Print the details of the array
		+	order $array; // Smooth out the array
		+	printr $array;
		+	// PRINTS
		+	// Array
		+	// (
		+	// [0] => 1
		+	// [1] => hmmm
		+	// [2] => Hello
		+	// [3] => 4
		+	// [4] => hi there!
		+	// )
	</syntaxhighlight>		</syntaxhighlight>

UberFoX: /* Strings */

2015-09-26T15:11:50Z

Strings

← Older revision		Revision as of 15:11, 26 September 2015
Line 200:		Line 200:

	Accessing a strings raw memory and finding the null terminator is not as simple as reading the string with $var[] since that will only go to length of the string (minus the null terminator) and even a foreach loop will not hit the null terminator either.		Accessing a strings raw memory and finding the null terminator is not as simple as reading the string with $var[] since that will only go to length of the string (minus the null terminator) and even a foreach loop will not hit the null terminator either.
−
−	~~To access the raw memory of a string and physically see its null terminator you must use the Fixed() statement or cast the string as a char* the same as in C here is an example.~~
−
−	~~<syntaxhighlight lang="sputnik">~~
−	~~$str = "Hello World!";~~
−	~~// Create a pointer to the strings~~
−	~~// physical memory and place it in~~
−	~~// $p~~
−	~~fixed( $p = $str )~~
−	{
−	~~// Loop through each character in the string~~
−	~~// until the null terminator is hit then stop~~
−	~~while( (my $c = (char)*$p++) != @'\0' )~~
−	{
−	~~printf("Character '%c' as decimal '%d' as hex '%x'\n", $c, $c, $c);~~
−	}
−	~~// The fact that it actually stops is proof~~
−	~~// the null terminator exists~~
−	}
−	~~// Prints~~
−	~~// Character 'H' as decimal '72' as hex '48'~~
−	~~// Character 'e' as decimal '101' as hex '65'~~
−	~~// Character 'l' as decimal '108' as hex '6c'~~
−	~~// Character 'l' as decimal '108' as hex '6c'~~
−	~~// Character 'o' as decimal '111' as hex '6f'~~
−	~~// Character ' ' as decimal '32' as hex '20'~~
−	~~// Character 'W' as decimal '87' as hex '57'~~
−	~~// Character 'o' as decimal '111' as hex '6f'~~
−	~~// Character 'r' as decimal '114' as hex '72'~~
−	~~// Character 'l' as decimal '108' as hex '6c'~~
−	~~// Character 'd' as decimal '100' as hex '64'~~
−	~~// Character '!' as decimal '33' as hex '21'~~
−	~~</syntaxhighlight>~~

	Variables can go directly inside strings like so		Variables can go directly inside strings like so