Core Function UBound - Revision history

UberFoX: 1 revision

2015-06-14T12:38:09Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:30Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX at 15:12, 19 August 2013

2013-08-19T15:12:46Z

← Older revision		Revision as of 15:12, 19 August 2013
Line 33:		Line 33:
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	$array = array ("One", "Two", "Three");		$array = array ("One", "Two", "Three");
−	println("~~Size~~ is: " . UBound($array) );	+	println("Highest index is: " . UBound($array) );
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX at 15:12, 19 August 2013

2013-08-19T15:12:12Z

← Older revision		Revision as of 15:12, 19 August 2013
Line 5:		Line 5:
	=== Description ===		=== Description ===

−	Returns the ~~size~~ of array ~~(How many elements it currently has stored)~~.	+	Returns the index of the highest element in an array .

	=== Parameters ===		=== Parameters ===
Line 19:		Line 19:
	=== Return Value ===		=== Return Value ===

−	Success - Returns the ~~current size of~~ the array/binary-array.	+	Success - Returns the highest index in the array/binary-array.

−	Failure - Returns ~~an empty array~~.	+	Failure - Returns -1.

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

−	~~Remember that the value returned by UBound is one greater than~~ the index ~~of an~~ array~~'s last element!~~	+	Although this gets the highest index it may not get how many items there are in the array use [[Core Function Count\|Count( <array/binary-array> )]] for that.

−	~~In Sputnik an array does not necessary start at~~ index ~~0 and move upwards infact an array can start at any number and jump all over place this all depends where the user has placed items into~~ the array.	+	If you want the lowest index instead of the highest use [[Core Function LBound\|LBound( <array/binary-array> )]] for that.
−		+
−	~~If the user uses push(~~) ~~then all items in array will be correct order~~.	+

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

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$~~arrayOLD~~ = array ~~( 10..15, 24..30 );~~	+	$array = array ("One", "Two", "Three");
−		+	println("Size is: " . UBound($array) );
−	~~$i = 0;~~	+
−	~~Foreach( $arrayOLD as $j )~~	+
−	{	+
−	~~println~~("~~Element ($i) is:~~ " ~~. $j);~~	+
−	~~$i++;~~	+
−	}	+
−		+
−	~~println(~~"~~Size is: " . UBound($arrayOLD) ); // Prints 13~~	+
−	~~</syntaxhighlight>~~	+
−		+
−	~~Heres an example of getting the size of binary data :~~	+
−		+
−	~~<syntaxhighlight lang="sputnik">~~	+
−	~~$binary = Pack("z0~~", "~~Hello World!~~");	+
−	~~// Yes you can get the size of the binary byte array by using UBound just like with arrays~~	+
−	println("~~The binary size~~ is: " . UBound($~~binary~~) );	+
−	~~Foreach ( $binary as $i )~~	+
−	{	+
−	~~println( "Byte: " . $i . " \| Hex: " . Hex($i) . " \| Char: " . Chr($i) );~~	+
−	}	+
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX at 12:42, 28 January 2013

2013-01-28T12:42:11Z

← Older revision		Revision as of 12:42, 28 January 2013
Line 1:		Line 1:
	<pre>		<pre>
−	UBound( <array/binary-array~~>, <flag~~> )	+	UBound( <array/binary-array> )
	</pre>		</pre>

Line 16:		Line 16:

	The binary variable to use.		The binary variable to use.
−
−	~~==== flag ====~~
−
−	~~For use with arrays.~~
−	~~<pre>~~
−	~~0 = Normal just count the array size (Default)~~
−	~~1 = Count the array and the hash size~~
−	~~2 = Count just the hash size~~
−	~~</pre>~~

	=== Return Value ===		=== Return Value ===
Line 36:		Line 27:
	Remember that the value returned by UBound is one greater than the index of an array's last element!		Remember that the value returned by UBound is one greater than the index of an array's last element!

−	~~So if theres only 5 element in the~~ array ~~UBound will return 5 however there is no element~~ at index ~~5 since elements begin~~ at ~~index 0~~ this ~~means~~ the ~~first item in~~ the array ~~is index 0 even though you might think of it as being index 1~~.	+	In Sputnik an array does not necessary start at index 0 and move upwards infact an array can start at any number and jump all over place this all depends where the user has placed items into the array.

−	~~Warning - Arrays in Sputnik do not have a fixed size it will suddenly increase in size if you try access an element of the array for example;~~ If ~~you have an array with only 3 elements and you try access element 77~~ the array ~~will instantly increase in size to 77 and anything that was added as a result of this~~ will be ~~empty strings making element 77 an empty string~~.	+	If the user uses push() then all items in array will be correct order.

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

UberFoX: /* Example */

2013-01-28T12:35:01Z

Example

← Older revision		Revision as of 12:35, 28 January 2013
Line 48:		Line 48:
	Foreach( $arrayOLD as $j )		Foreach( $arrayOLD as $j )
	{		{
−	println("Element ($i) is: " . $i);	+	println("Element ($i) is: " . $j);
	$i++;		$i++;
	}		}

UberFoX: /* flag */

2012-04-28T03:40:52Z

flag

← Older revision		Revision as of 03:40, 28 April 2012
Line 21:		Line 21:
	For use with arrays.		For use with arrays.
	<pre>		<pre>
−	0 = Normal just count the array size	+	0 = Normal just count the array size (Default)
	1 = Count the array and the hash size		1 = Count the array and the hash size
	2 = Count just the hash size		2 = Count just the hash size

UberFoX at 16:34, 22 April 2012

2012-04-22T16:34:30Z

← Older revision		Revision as of 16:34, 22 April 2012
Line 1:		Line 1:
	<pre>		<pre>
−	UBound( <array/binary-array> )	+	UBound( <array/binary-array>, <flag> )
	</pre>		</pre>

Line 16:		Line 16:

	The binary variable to use.		The binary variable to use.
		+
		+	==== flag ====
		+
		+	For use with arrays.
		+	<pre>
		+	0 = Normal just count the array size
		+	1 = Count the array and the hash size
		+	2 = Count just the hash size
		+	</pre>

	=== Return Value ===		=== Return Value ===

UberFoX: /* Example */

2011-11-29T12:11:11Z

Example

← Older revision		Revision as of 12:11, 29 November 2011
Line 34:		Line 34:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$arrayOLD = array ( 10..15, 24..30 )	+	$arrayOLD = array ( 10..15, 24..30 );

−	$i = 0	+	$i = 0;
−	~~For $j In~~ $arrayOLD	+	Foreach( $arrayOLD as $j )
−	println("Element ($i) is: " . $i)	+	{
−	$i++	+	println("Element ($i) is: " . $i);
−	~~Next~~	+	$i++;
		+	}

−	println("Size is: " . UBound($arrayOLD) ) ; Prints 13	+	println("Size is: " . UBound($arrayOLD) ); // Prints 13
	</syntaxhighlight>		</syntaxhighlight>

Line 48:		Line 49:

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	$binary = Pack("z0", "Hello World!")	+	$binary = Pack("z0", "Hello World!");
−	; Yes you can get the size of the binary byte array by using UBound just like with arrays	+	// Yes you can get the size of the binary byte array by using UBound just like with arrays
−	println("The binary size is: " . UBound($binary) )	+	println("The binary size is: " . UBound($binary) );
−	~~For $i In~~ $binary	+	Foreach ( $binary as $i )
−	println( "Byte: " . $i . " \| Hex: " . Hex($i) . " \| Char: " . Chr($i) )	+	{
−	~~Next~~	+	println( "Byte: " . $i . " \| Hex: " . Hex($i) . " \| Char: " . Chr($i) );
		+	}
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX at 00:10, 12 November 2011

2011-11-12T00:10:05Z

← Older revision		Revision as of 00:10, 12 November 2011
Line 1:		Line 1:
	<pre>		<pre>
−	UBound( <array> )	+	UBound( <array/binary-array> )
	</pre>		</pre>

Line 9:		Line 9:
	=== Parameters ===		=== Parameters ===

−	==== array ====	+	==== array/binary-array ====

	The array to use.		The array to use.
		+
		+	OR
		+
		+	The binary variable to use.

	=== Return Value ===		=== Return Value ===

−	Success - Returns the current size of the array.	+	Success - Returns the current size of the array/binary-array.

	Failure - Returns an empty array.		Failure - Returns an empty array.
Line 39:		Line 43:

	println("Size is: " . UBound($arrayOLD) ) ; Prints 13		println("Size is: " . UBound($arrayOLD) ) ; Prints 13
		+	</syntaxhighlight>
		+
		+	Heres an example of getting the size of binary data :
		+
		+	<syntaxhighlight lang="sputnik">
		+	$binary = Pack("z0", "Hello World!")
		+	; Yes you can get the size of the binary byte array by using UBound just like with arrays
		+	println("The binary size is: " . UBound($binary) )
		+	For $i In $binary
		+	println( "Byte: " . $i . " \| Hex: " . Hex($i) . " \| Char: " . Chr($i) )
		+	Next
	</syntaxhighlight>		</syntaxhighlight>

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