Function: Length
Function: Length

Function: Length

Length ( VALUE )

Returns the length of a value. Behavior varies based on type.

Parameters

Parameter Type Description
VALUE VALUE The input value (any type).

Returns

VALUE(INTEGER) The length of the input value.

What It Does

This function returns the length of the input value, which is different depending on the value type.

  • If the value is numeric or boolean, this returns 1.
  • If the value is a string, this returns the amount of characters in the string.
  • If the value is a list, this returns the amount of elements in the list.

Example

Length Example


world
{
	start()
	{
		textln("length(\"\") = "+length(""));
		textln("length(\"apple\") = "+length("apple"));
		textln("length(\"123456\") = "+length("123456"));
		textln("length(\"            \") = "+length("          "));
		textln("length(true) = "+length(true));
		textln("length(false) = "+length(false));
		textln("length(0) = "+length(0));
		
		local a;
		a = [1, 2, 3, 4, 5];
		textln("length("+a+") = "+length(a));
		a = [[1, 2, 3], [4, 5, 6, 7, 8]];
		textln("length("+a+") = "+length(a));
		textln("length(a[0]) = "+length(a[0]));
		textln("length(a[1]) = "+length(a[1]));
		quit;
	}
}

Example Result Table

Value Result
BOOLEAN[false] > LENGTH > INTEGER[1]
BOOLEAN[true] > LENGTH > INTEGER[1]
FLOAT[Infinity] > LENGTH > INTEGER[1]
FLOAT[-Infinity] > LENGTH > INTEGER[1]
FLOAT[NaN] > LENGTH > INTEGER[1]
INTEGER[0] > LENGTH > INTEGER[1]
FLOAT[0.0] > LENGTH > INTEGER[1]
INTEGER[10] > LENGTH > INTEGER[1]
INTEGER[3] > LENGTH > INTEGER[1]
FLOAT[10.0] > LENGTH > INTEGER[1]
FLOAT[3.0] > LENGTH > INTEGER[1]
FLOAT[10.5] > LENGTH > INTEGER[1]
FLOAT[3.5] > LENGTH > INTEGER[1]
INTEGER[-10] > LENGTH > INTEGER[1]
INTEGER[-3] > LENGTH > INTEGER[1]
FLOAT[-10.0] > LENGTH > INTEGER[1]
FLOAT[-3.0] > LENGTH > INTEGER[1]
FLOAT[-10.5] > LENGTH > INTEGER[1]
FLOAT[-3.5] > LENGTH > INTEGER[1]
STRING[] > LENGTH > INTEGER[0]
STRING[ ] > LENGTH > INTEGER[1]
STRING[0] > LENGTH > INTEGER[1]
STRING[0.0] > LENGTH > INTEGER[3]
STRING[10] > LENGTH > INTEGER[2]
STRING[3] > LENGTH > INTEGER[1]
STRING[10.0] > LENGTH > INTEGER[4]
STRING[3.0] > LENGTH > INTEGER[3]
STRING[10.5] > LENGTH > INTEGER[4]
STRING[3.5] > LENGTH > INTEGER[3]
STRING[-10] > LENGTH > INTEGER[3]
STRING[-3] > LENGTH > INTEGER[2]
STRING[-10.0] > LENGTH > INTEGER[5]
STRING[-3.0] > LENGTH > INTEGER[4]
STRING[-10.5] > LENGTH > INTEGER[5]
STRING[-3.5] > LENGTH > INTEGER[4]
STRING[apple] > LENGTH > INTEGER[5]
STRING[banana] > LENGTH > INTEGER[6]
STRING[NaN] > LENGTH > INTEGER[3]
STRING[infinity] > LENGTH > INTEGER[8]
LIST[[]] > LENGTH > INTEGER[0]
LIST[[BOOLEAN[true], INTEGER[3], FLOAT[5.0], STRING[orange]]] > LENGTH > INTEGER[4]
×

Modal Header