TYPE

TYPE definitions are used to create variables that can hold more than one element.

Syntax

TYPE typename element-name1 AS type element-name2 AS type . . . element-nameN AS type END TYPE

TYPE typename AS type element-list1 AS type element-list2 . . . AS type element-listN END TYPE

Description

• Typename is an undefined type name holder as it can hold any variable types.
• TYPE definitions are usually placed in the main module before the start of the program code execution.
• TYPE definitions cam also be placed in SUB or FUNCTION procedures.
• TYPE definitions cannot contain Array variables. Arrays can be DIMensioned as a TYPE definition.
• TYPE definitions cannot be inside of another TYPE definition, but variables can be defined AS another type.(See Example 4)
• TYPE definitions must be ended with END TYPE.
• A TYPE variable must be assigned to the type after it is defined. Array variables are allowed.
• Type variables must be defined in every SUB or FUNCTION unless the type variable is DIMensioned as SHARED.
• Type variables use DOT variable names to read or write specific values. They do not use type suffixes as they can hold ANY variable type values! The name before the dot is the one you defined after the type definition and the name after is the variable name used inside of the TYPE. The name of the dimensioned type variable alone can be used to PUT # or GET # all of the data at once!
• Once the TYPE variable is created you can find the record or byte size by using LEN(typevariable).
• TYPE definitions can also be placed in $INCLUDE .BI text files such as QB.BI is used by INTERRUPT and INTERRUPTX.
• You can mix the element-name AS type syntax with the AS type element-list syntax in the same TYPE block.
• _BIT is not supported in User Defined TYPEs.

Numerical Types

Type Name	Symbol	Minimum Value	Maximum Value
_BIT	`	-1	0
_BIT * n	`n	-128	127
_UNSIGNED _BIT	~`	0	1
_BYTE	%%	-128	127
_UNSIGNED _BYTE	~%%	0	255
INTEGER	%	-32,768	32,767
_UNSIGNED INTEGER	~%	0	65,535
LONG	&	-2,147,483,648	2,147,483,647
_UNSIGNED LONG	~&	0	4,294,967,295
_INTEGER64	&&	-9,223,372,036,854,775,808	9,223,372,036,854,775,807
_UNSIGNED _INTEGER64	~&&	0	18,446,744,073,709,551,615
SINGLE	! or none	-2.802597E-45	+3.402823E+38
DOUBLE	#	-4.490656458412465E-324	+1.797693134862310E+308
_FLOAT	##	-1.18E−4932	+1.18E+4932
_OFFSET	%&	-9,223,372,036,854,775,808	9,223,372,036,854,775,807
_UNSIGNED _OFFSET	~%&	0	18,446,744,073,709,551,615
_MEM	none	combined memory variable type	N/A

Note: For the floating-point numeric types SINGLE (default when not assigned), DOUBLE and _FLOAT, the minimum values represent the smallest values closest to zero, while the maximum values represent the largest values closest to ±infinity. OFFSET dot values are used as a part of the _MEM variable type in QB64 to return or set the position in memory.

String Text Type

Type Name	Symbol	Minimum Length	Maximum Length
STRING	$	0	2,147,483,647
STRING * n	$n	1	2,147,483,647

Note: For the fixed-length string type STRING * n, where n is an integer length value from 1 (one) to 2,147,483,647.

Examples