# BASIC-256 Documentation

en:constants

## Constants

### Numeric Constants

Numeric constants are any numeric characters, preceded by an optional minus sign to indicate negative numbers, and an optional decimal followed by more numeric characters to indicate floating point values. Numbers come in two types: 1) integers and 2) decimal numbers.

Examples include:

Integer Numbers
10
-2345
0

Positive integer values may also be expressed in binary (base 2), octal (base 8), and hexadecimal (base 16). Precede binary values with 0b (0b1110 = 14), octal with 0o (0o177 = 127), and hexadecimal with 0x (0xff = 255).

Decimal Numbers
-234.567
56.87
0.0123
PI

Very large and small numbers may also be represented in scientific E notation (added in version 0.9.9.46). http://en.wikipedia.org/wiki/Scientific_notation

Scientific E Notation
E NotationDecimal Number
2e02
3e2300
1.234e1012340000000
-5.3e4-53000
2e-10.2
5.12e-90.00000000512
2016/01/01 22:41

### String Constants

String constants are zero or more characters enclosed by either double quotation marks(“) or single quotation marks (').

#### Examples

 'I said “Hello.”' “Tuesday Rocks” '123' “it is Smith's”
2016/01/01 22:42

### Boolean Constants

Boolean values represent the two values of True and false. There are defined constants true and false that represent the value 1 and 0 respectively.

#### Examples

True ValuesFalse Values
TRUEFALSE
10
-560.0
9.9'“
“something”
2016/08/09 09:54 ·

#### Color Constants and RGB values

These values are used by the Color statement, can be created with the RGB, and are returned by the GetBrushColor, GetColor, and pixel functions.

Color Constant (Name)ARGB ValuesInteger
BLACK255, 0, 0, 04278190080
WHITE255, 255, 255, 2554294506744
RED255, 255, 0, 04294901760
DARKRED255, 128, 0, 04286578688
GREEN255, 0, 255, 04278255360
DARKGREEN255, 0, 128, 04278222848
BLUE255, 0, 0, 2554278190335
DARKBLUE255, 0, 0, 1284278190208
CYAN255, 0, 255, 2554278255615
DARKCYAN255, 0, 128, 1284278222976
PURPLE255, 255, 0, 2554294902015
DARKPURPLE255, 128, 0, 1284286578816
YELLOW255, 255, 255, 04294967040
DARKYELLOW255, 128, 128 ,04286611456
ORANGE255, 255, 102, 04294927872
DARKORANGE255, 176, 61 ,04289344256
GREY255, 164, 164 ,1644288980132
DARKGREY255, 128, 128 ,1284286611584
CLEAR0, 0, 0, 00
2016/08/12 20:00 ·

#### Variable and Expression Types

These constants can be used to represent the numeric values returned by the TypeOf function.

Return Values
ConstantValueType
TYPE_UNASSIGNED0Unassigned Variable
TYPE_INT1Integer
TYPE_FLOAT2Decimal Number
TYPE_STRING3String
TYPE_ARRAY4Array Variable
TYPE_REF5Variable Reference
2016/08/13 13:25 ·

#### Error Codes and Constants

This is a list of runtime error code numbers returned by the LastError function and text error messages returned by the LastErrorMessage function.

##### Non Trappable Errors
 Error # Error Description -1 ERROR_NOSUCHLABEL No such label %VARNAME% -2 ERROR_NEXTNOFOR Next without FOR -3 ERROR_NOTARRAY Variable %VARNAME% is not an array -5 ERROR_ARGUMENTCOUNT Number of arguments passed does not match FUNCTION/SUBROUTINE definition -6 ERROR_MAXRECURSE Maximum levels of recursion exceeded -7 ERROR_STACKUNDERFLOW Stack Underflow Error -8 ERROR_BADCALLFUNCTION Function was not called correctly -9 ERROR_BADCALLSUBROUTINE Subroutine was not called correctly
##### Trappable Errors
 Error # Error Description 5 ERROR_FILENUMBER Invalid File Number 6 ERROR_FILEOPEN Unable to open file 7 ERROR_FILENOTOPEN File not open 8 ERROR_FILEWRITE Unable to write to file 9 ERROR_FILERESET Unable to reset file 10 ERROR_ARRAYSIZELARGE Array %VARNAME% dimension too large 11 ERROR_ARRAYSIZESMALL Array %VARNAME% dimension too small 13 ERROR_VARNOTASSIGNED Variable %VARNAME% has not been assigned a value 14 ERROR_ARRAYNITEMS Array %VARNAME% rows must have the same number of items 15 ERROR_ARRAYINDEX Array %VARNAME% index out of bounds 17 ERROR_STRSTART Starting position less than zero 20 ERROR_RGB RGB Color values must be in the range of 0 to 255 21 ERROR_PUTBITFORMAT String input to putbit incorrect 23 ERROR_POLYPOINTS Not enough points in array for poly()/stamp() 24 ERROR_IMAGEFILE Unable to load image file 25 ERROR_SPRITENUMBER Sprite number out of range 26 ERROR_SPRITENA Sprite has not been assigned 27 ERROR_SPRITESLICE Unable to slice image 28 ERROR_FOLDER Invalid directory name 29 ERROR_INFINITY Operation returned infinity 30 ERROR_DBOPEN Unable to open SQLITE database 31 ERROR_DBQUERY Database query error (message follows) 32 ERROR_DBNOTOPEN Database must be opened first 33 ERROR_DBCOLNO Column number out of range or column name not in data set 34 ERROR_DBNOTSET Record set must be opened first 35 ERROR_TYPECONV Unable to convert string to number 36 ERROR_NETSOCK Error opening network socket 37 ERROR_NETHOST Error finding network host 38 ERROR_NETCONN Unable to connect to network host 39 ERROR_NETREAD Unable to read from network connection 40 ERROR_NETNONE Network connection has not been opened 41 ERROR_NETWRITE Unable to write to network connection 42 ERROR_NETSOCKOPT Unable to set network socket options 43 ERROR_NETBIND Unable to bind network socket 44 ERROR_NETACCEPT Unable to accept network connection 45 ERROR_NETSOCKNUMBER Invalid Socket Number 46 ERROR_PERMISSION You do not have permission to use this statement/function 47 ERROR_IMAGESAVETYPE Invalid image save type 50 ERROR_DIVZERO Division by zero 51 ERROR_BYREF Function/Subroutine expecting variable reference in call 53 ERROR_FREEFILE There are no free file numbers to allocate 54 ERROR_FREENET There are no free network connections to allocate 55 ERROR_FREEDB There are no free database connections to allocate 56 ERROR_DBCONNNUMBER Invalid Database Connection Number 57 ERROR_FREEDBSET There are no free data sets to allocate for that database connection 58 ERROR_DBSETNUMBER Invalid data set number 59 ERROR_DBNOTSETROW You must advance the data set using DBROW before you can read data from it 60 ERROR_PENWIDTH Drawing pen width must be a non-negative number 62 ERROR_ARRAYINDEXMISSING Array variable %VARNAME% has no value without an index 63 ERROR_IMAGESCALE Image scale must be greater than or equal to zero 64 ERROR_FONTSIZE Font size, in points, must be greater than or equal to zero 65 ERROR_FONTWEIGHT Font weight must be greater than or equal to zero 66 ERROR_RADIXSTRING Unable to convert radix string back to a decimal number 67 ERROR_RADIX Radix conversion base muse be between 2 and 36 68 ERROR_LOGRANGE Unable to calculate the logarithm or root of a negative number 69 ERROR_STRINGMAXLEN String exceeds maximum length of 16,777,216 characters 71 ERROR_PRINTERNOTON Printer is not on 72 ERROR_PRINTERNOTOFF Printing is already on 73 ERROR_PRINTEROPEN Unable to open printer 74 ERROR_WAVFILEFORMAT Media file does not exist or in an unsupported format 75 ERROR_WAVNOTOPEN Media file not open 76 ERROR_WAVNOTSEEKABLE 77 ERROR_WAVNODURATION 78 ERROR_FILEOPERATION Can not perform that operation on a Serial Port 79 ERROR_SERIALPARAMETER Invalid serial port parameter 80 ERROR_LONGRANGE Number exceeds long integer range () 81 ERROR_INTEGERRANGE Number exceeds integer range () 65535 ERROR_NOTIMPLEMENTED “Feature not implemented in this environment.”
##### Warnings
 Error # Error Description 65536+ERROR_TYPECONV WARNING_TYPECONV Unable to convert string to number, zero used 65536+ERROR_WAVNOTSEEKABLE WARNING_WAVNOTSEEKABLE Media file is not seekable 65536+ERROR_WAVNODURATION WARNING_WAVNODURATION Duration is not available for media file 65536+ERROR_VARNOTASSIGNED WARNING_VARNOTASSIGNED Variable %VARNAME% has not been assigned a value 65536+ERROR_LONGRANGE WARNING_LONGRANGE Number exceeds long integer range () 65536+ERROR_INTEGERRANGE WARNING_INTEGERRANGE Number exceeds integer range ()
2016/01/01 22:40

#### Mouse Button Constants

These constants can be used to represent the numeric values returned by the Clickb and Mouseb functions. If a user has pressed more than one button the values will be added together when returned.

#### Image Save Type Constants

These constants can be used to tell the ImgSave statement which format to save the graphics window into.

Return Values
ConstantValue
IMAGETYPE_BMP“BMP”
IMAGETYPE_JPG“JPG”
IMAGETYPE_PNG“BMP”
2016/08/14 14:42 ·

#### Operating System Type Constants

These constants can be used to represent the numeric values returned by the OsType function.

Return Values
ConstantValue
OSTYPE_WINDOWS0
OSTYPE_LINUX1
OSTYPE_MACINTOSH2
OSTYPE_ANDROID3
2016/08/14 14:45 ·

#### GetSlice Constants

These constants can be used to specify the action of the GetSlice statement.

Graphics Layers Values
ConstantValue
SLICE_ALL0
SLICE_PAINT1
SLICE_SPRITE2
2016/09/08 10:55 ·