Variables and Arrays Definitions, Operation Related Commands

VAR Variable[=Expression][,Variable[=Expression]...]
DIM Variable[=Expression][,Variable[=Expression]...]

Define variables explicitly

・Either VAR or DIM can be used.
・Multiple variables can be defined simultaneously by separating them with commas.

Arguments

VariableNames

・Alphanumeric characters and underscores (_) can be used for variable names.
・You cannot use numbers at the beginning.

Expression

・The result of the expression becomes the initial value of the variable.
・If the expression is not specified, :Int type zero, #:Real type zero, $:empty string is set as the initial value by the type symbol (/#/$) at the end of the variable name.
・If the expression is not specified and the variable name has no type symbol, the default numeric type zero is set as the initial value.

Example

VAR A=0,B,C
DIM B$

VAR ArrayVariableName[[NumberOfElements[,NumberOfElements...]]]
DIM ArrayVariableName[[NumberOfElements[,NumberOfElements...]]]

Create an array and set it to a variable

・Either VAR or DIM can be used.

Arguments

ArrayVariableName

・If a type symbol (%/#/$) is added at the end of a variable name, an Int array, Real array, and string array are created respectively.
・If the type symbol is not specified, a default numeric type array is created.

NumberOfElements

・Specify the number of array elements to be secured with [].
・The number of elements can be created up to a 4D array by separating them with commas.
・If the number of elements is not specified, a 1D array with zero elements is created.

Example

VAR ATR[4]
VAR DX[5],DY[5],DZ[5]
DIM POS$[10,5]
DIM IMAGE[]

VAR ArrayVariableName[[NumberOfElements[,NumberOfElements...]]]=[Value1,Value2,...]
DIM ArrayVariableName[[NumberOfElements[,NumberOfElements...]]]=[Value1,Value2,...]

Create an array, set the value of the element in advance and set it to the variable

・Either VAR or DIM can be used.

Arguments

ArrayVariableName

・If a type symbol (%/#/$) is added at the end of a variable name, an Int array, Real array, and string array are created respectively.
・If the type symbol is not specified, a default numeric type array is created.

NumberOfElements

Specify the number of array elements to be secured with []

・The number of elements can be created up to a 4D array by separating them with commas.
・If the number of elements is not specified, a 1D array with zero elements is created.

Value

List of values to set as initial values for array elements

・If the number of elements is not specified, the number of values is a 1D array of the number of elements.

Example

VAR ATR[4]=[1,2,3,4]
DIM POS$[10,5]=["X","Y","Z","W"]
DIM IMAGE[]=[0,1,2,3,4]

Variable = Expression

Substitute the result of an expression into a variable

・If OPTION STRICT is not defined, the variable is automatically defined when trying to assign to an undefined variable.
・If OPTION STRICT is defined, an Undefined Variable error will occur when trying to assign to an undefined variable.

Example

A=10
B=A*6
C[4]=A+B

SWAP Variable1,Variable2

Exchange values in two variables

Argument

Variable1,Variable2

Two variables whose values are to be exchanged

Example

SWAP A,B
SWAP A[5],B[2]

INC Variable[,Expression]

Add the result of the expression to the value in the variable

Arguments

Variable

Variable to manipulate

Expression

The value to add

・If not specified, it's 1.

Example

INC X
INC X,3

DEC Variable[,Expression]

Subtract the result of the expression from the value in the variable

Arguments

Variable

Variable to subtract

Expression

The value to subtract

・If not specified, it's 1.

Example

DEC X
DEC X,3

COPY(CopySourceArray[,CopySourceOffset[,NumberOfCopyElements]])

Copy an array

Arguments

CopySourceArray

Copy source array

・Only 1D arrays can be specified.

CopySourceOffset

First element number of copy source

・If not specified, it's 0.

NumberOfCopyElements

Number of elements to copy

・If not specified, the number of elements in the copy source array minus the copy source offset is specified.

Return Value

Copy result array

・In the case of string array, the string of each element is also copied.

COPY(CopySourceString[,CopySourceOffset[,NumberOfCopyCharacters]])

Copy the string

Arguments

CopySourceString

Copy source string

CopySourceOffset

Copy source start position

・If not specified, it's 0.

NumberOfCopyCharacters

Number of characters to copy

・If not specified, the number of characters in the copy source string minus the copy source offset is specified.

Return Value

Copy result string

COPY CopyDestinationArray[,CopyDestinationOffset],CopySourceArray[[,CopySourceOffset],NumberOfCopyElements]

Copy the contents of an array to another array

・For 1D arrays only, if the copy destination array has fewer elements than the copy source array, it is automatically expanded.
・The dimensions of the array are ignored for both the copy source and the copy destination.

Arguments

CopyDestinationArray

Copy destination array

CopyDestinationOffset

First element number of the copy destination

・If not specified, it's 0.

CopySourceArray

Copy source array

CopySourceOffset

First element number of copy source

・If not specified, it's 0.

NumberOfCopyElements

Number of elements to copy

・If not specified, the number of elements in the copy source array minus the copy source offset is specified.

Example

DIM SRC[10],DST[10]
COPY DST,SRC

COPY CopyDestinationArray[,CopyDestinationOffset],LabelString[,NumberOfCopyData]

Read DATA column into array

・Read the data defined by the DATA statement into the array.
・If the number of array elements is less than the number of copy data, only 1D arrays are automatically expanded if the number of elements in the copy destination array is insufficient.

Arguments

CopyDestinationArray

Copy destination array

CopyDestinationOffset

First element number of the copy destination

・If not specified, it's 0.

LabelString

Label name string indicating the DATA statement you want to read

・Reading starts from the DATA statement that appears first after the label name.

NumberOfCopyData

Number of data to be read

・An error occurs if the number of data that can be read is less than the value specified here.
・If not specified, the number of elements in the copy destination array is specified.

Example

DIM DST[5]
COPY DST,"@SRC" 
@SRC
DATA 5,1,1,2,4

COPY CopyDestinationStringVariable[,CopyDestinationOffset],CopySourceString[[,CopySourceOffset],NumberOfCopyCharacters]

Copy part or all of a string to another string variable

Arguments

CopyDestinationStringVariable

Copy destination string variable

CopyDestinationOffset

Copy start position

・If not specified, it's 0.

CopySourceString

Copy source string

CopySourceOffset

Copy source start position

・If not specified, it's 0.

NumberOfCopyCharacters

Number of characters to copy

・If not specified, the number of characters in the copy source string minus the copy source offset is specified.

Example

COPY A$,"12345" 

RINGCOPY CopyDestinationArray,CopyDestinationOffset,CopySourceArray[[,CopySourceOffset],NumberOfCopyElements]
RINGCOPY CopyDestinationArray,CopyDestinationOffset,CopySourceArray[[,CopySourceOffset],NumberOfCopyElements] OUT Variable

Recognize array as ring buffer and copy data to it

・Similar to the COPY command, the value between arrays is copied, but even if the number of copy elements at the copy source is larger than the copy destination, the number of elements is not expanded and the data is copied by folding back to the beginning of the array.
・You can specify up to a 2D array for both the copy destination and copy source. When a 2D array is specified, it is handled as a multi-channel ring buffer (or data).
・If a 2D array is specified for both the copy destination and the copy source, the number of channels (number of elements in the first dimension) must be the same.
・When the copy destination is 2D and the copy source is a 1D array, the copy source data is copied to all channels of the copy destination in the same way.
・Operation is not guaranteed if the copy destination and copy source are the same array.

Arguments

CopyDestinationArray

Array treated as a copy destination ring buffer

CopyDestinationOffset

Copy start position at the copy destination

CopySourceArray

Copy source array

CopySourceOffset

Copy start position at the copy source

・0, if not specified.

NumberOfCopyElements

Number of elements to copy

・If not specified, it's the number of elements in the copy source array.

Return Value

End position of copied data

・When handled as a ring buffer, the returned value is the next copy destination offset.

SORT [StartPosition,NumberOfElements,]Array1[,Array2,...]

Sort the array in ascending order

Arguments

StartPosition

Position to start sorting in Array1

・0, if not specified.

NumberOfElements

Number of elements to sort

・If not specified, it's the number of elements in Array1.

Array1

An array containing the numbers to sort

Array2

Array to be sorted in conjunction with the sorting result of Array1.

・Array 2 to 8 can be omitted.
・Array 2 to 8 can be string arrays.

Example

DIM WORK[10]
SORT 0,10,WORK

RSORT [StartPosition,NumberOfElements,]Array1[,Array2,...]

Sort the array in descending order

Arguments

StartPosition

Sort start position in Array1

・0, if not specified.

NumberOfElements

Number of elements to sort

・If not specified, it's the number of elements in Array1.

Array1

An array containing the numbers to sort

Array2

Array to be sorted in conjunction with the sorting result of Array1.

・Array 2 to 8 can be omitted.
・Array 2 to 8 can be string arrays.

Example

DIM WORK[10]
RSORT 0,10,WORK

PUSH Array,Expression

Add elements to the end of an array

・The number of elements increases by one.

Arguments

Array

The array to add the element to

Expression

The value of the element to add

Example

DIM WORK[10]
PUSH WORK,123

POP(Array)

Extract elements from the end of an array

・The number of elements reduces by one.

Argument

Array

The array whose elements are to be retrieved

Return Value

The value of the extracted element

Example

DIM WORK[10]
PUSH WORK,123
A=POP(WORK)

UNSHIFT Array,Expression

Add elements to the beginning of an array

・The number of elements increases by one.

Arguments

Array

The array to add the element to

Expression

The value of the element to add

Example

DIM WORK[10]
UNSHIFT WORK,123

SHIFT(Array)

Extract elements from the beginning of an array

・The number of elements reduces by one.

Argument

Array

The array whose elements are to be retrieved

Example

DIM WORK[10]
UNSHIFT WORK,123
A=SHIFT(WORK)

FILL Array,Value[,Offset[,NumberOfElements]]

Set all array contents to the specified value

・The array type may be an Int, Real or string.
・Partial change is possible by specifying offset and number of elements.

Arguments

Array

Array to overwrite values

Value

Number or string

Offset

The position at which to start writing the value

NumberOfElements

Number to write

Example

DIM WORK[10]
FILL WORK,0

TYPEOF(Value)

Find the value type

Argument

Value

The value whose type is to be examined

Return Value

Depending on the value type, one of the following numbers is returned:

0	Default Type	#T_DEFAULT
1	Int type	#T_INT
2	Real Type	#T_REAL
3	String Type	#T_STR
5	Int Array	#T_INTARRAY
6	Real Array	#T_REALARRAY
7	String Array	#T_STRARRAY

・The default type is a special type that is set when an argument is not specified in a function/command call.

ARRAY%(NumberOfElements[,NumberOfElements...])
ARRAY#(NumberOfElements[,NumberOfElements...])
ARRAY$(NumberOfElements[,NumberOfElements...])

Create an array

・Use this when you want to create an array other than when defining a variable with VAR.
・ARRAY% creates an Int array, ARRAY# creates a Real array, and ARRAY$ creates a string array.

Argument

NumberOfElements[,NumberOfElements...]

Array dimensions and number of elements to create

Return Value

Created array

DIM(Array)
DIM(Array,Dimension)

Check the number of array dimensions and the number of elements in each dimension

Arguments

Array

The array to check

Dimension

Dimension to check the number of elements: 0 to 3

・If not specified, the number of array dimensions is returned.

Return Value

・If a dimension is specified, the number of elements in the specified dimension is returned.
・If the dimension is not specified, the number of array dimensions is returned.

Example

DIM WORK[10,20]
? DIM(WORK)
? DIM(WORK,0)
? DIM(WORK,1)

RESIZE Array,NumberOfElements[,NumberOfElements...]

Change the size of an array

・The numeric value 0 or an empty string is entered in the element of the extended part.

Arguments

Array

The array to resize

NumberOfElements

Number of elements after resizing

・You can change only the number of elements written first when defining an array.
・Dimensions cannot be changed.

INSERT Array,InsertionPosition[,NumberOfElements[,InitialValue]]

Insert elements into a 1D array

Arguments

Array

Array to increase elements

InsertionPosition

Element insertion position: 0 to the number of array elements

NumberOfElements

Number of elements to insert: positive number

・1, if not specified.

InitialValue

Insert element value

・If not specified, 0 for numeric arrays and empty string for character arrays.

REMOVE Array,DeletionPosition [,NumberOfElements]

Delete 1D array elements

Arguments

Array

The array to remove elements from

DeletionPosition

Element deletion position: 0 to number of array elements -1

NumberOfElements

Number of elements to delete: positive number

・1, if not specified.

FIND(Array,Value)

Search an array for a specified value and return the found position

Arguments

Array

Target array to search

・Multi-dimensional arrays can also be specified.

Value

The value to search for

Return Value

Found position

・If the value is not found, -1 is returned.

Example

DIM A[]=[1,2,3,4,5]
?FIND(A,3)

FIND Array,Value OUT Index1[,Index2...]

Search an array for a specified value and return the found position

Arguments

Array

Target array to search

・Multi-dimensional arrays can also be specified.

Value

The value to search for

Return Value

The index of the found position

・The number of returned values must be the same as the number of dimensions of the searched target array.
・If no value is found, -1 is returned for all return values.

Example

DIM A$[3,3]=["1","2","3","4","5","6","7","8","9"]
FIND A$, "4" OUT Y,X
?A$[Y,X]

INSPECT Value

Display detailed value information

・For type, value, and array, the number of elements and the values of all elements are displayed.
・For strings and string variables, the length of the string is also displayed.
・If the content of the string is too long, the rest is omitted.
・It can be abbreviated as ?? instead of using INSPECT.

Example

INSPECT A
?? "12345"*10