Operators#

Introduction #

The Operators blocks in VEXcode AIR handle mathematical calculations and string manipulations. These blocks allow for performing arithmetic, evaluating conditions, and processing text.

Below is a list of available blocks:

math operator — Performs addition, subtraction, multiplication, or division.
comparison operator — Compares two values using greater than, less than, or equal operators.
logical operator — Evaluates multiple conditions using and or or.
not operator — Inverts a Boolean value.
range operator — Checks if a number falls within a range.
pick random — Generates a random number within a specified range.
round number — Rounds a number to the nearest whole number.
math functions — Applies operations such as square root, trigonometry, logarithms, and exponentiation.
atan2 — Computes the inverse tangent of Y/X.
remainder — Returns the remainder of a division operation.
join – Combines two strings into one.
letter – Extracts a character from a string by position.
length – Returns the number of characters in a string.
contains – Checks if a string includes a specific word or character.
convert – Converts a number into text, a whole number, or a decimal.

The math operator block performs basic arithmetic on the values placed on either side. It returns a result based on the project’s print precision, which defaults to 0 decimal places but can be adjusted using the set print precision block for screen or Console.

The Math operator reporter block.#

([0] [math_plus v] [0])

Parameters	Description
value 1	The first number used in the operation.
operator	The mathematical operator to use: + - Addition - - Subtraction * - Multiplication / - Division
value 2	The second number used in the operation.

Parameters

Description

value 1

The first number used in the operation.

operator

The mathematical operator to use:

+ - Addition
- - Subtraction
* - Multiplication
/ - Division

value 2

The second number used in the operation.

Example

Perform basic addition and show two decimal places.#

当开始
[Perform basic addition and show two decimal places.]
在控制台上设定打印精度为 [0.01 v]
在控制台上打印 ([10] [math_plus v] [10.5])▶

comparison operator #

The comparison operator block compares two values using a selected operator and returns either True or False.

True — The comparison is correct (e.g., 5 > 3 returns True).
False — The comparison is incorrect (e.g., 2 ≥ 5 returns False).

The Comparison operator Boolean block.#

<[0] [math_equal v] [0]>

Parameter	Description
value 1	The first value to compare.
operator	The comparison to use: = - Equal to < - Less than ≤ - Less than or equal to > - Greater than ≥ - Greater than or equal to
value 2	The second value to compare.

Parameter

Description

value 1

The first value to compare.

operator

The comparison to use:

= - Equal to
< - Less than
≤ - Less than or equal to
> - Greater than
≥ - Greater than or equal to

value 2

The second value to compare.

Example

当开始
[Fly to position (0, 300, 500).]
起飞至 [500] [毫米 v] ▶
等待 (1) 秒
移动 [向前 v]
等到 <([y v] 转位 [毫米 v]) [math_greater_than v] [300]>
等待 (1) 秒
土地 ▶

logical operator #

The logical operator block checks multiple conditions and returns either True or False based on the selected operator.

True — The logic condition is met.
False — The logic condition is not met.

The Logical Operator Boolean block.#

<<> [and v] <>>

Parameter	Description
condition 1	The first Boolean condition to evaluate.
operator	The logical operator to use: and — Returns True if both conditions are True. or — Returns True if at least one condition is True.
condition 2	The second Boolean condition to evaluate.

Parameter

Description

condition 1

The first Boolean condition to evaluate.

operator

The logical operator to use:

and — Returns True if both conditions are True.
or — Returns True if at least one condition is True.

condition 2

The second Boolean condition to evaluate.

Example

当开始
[Display when buttons 5 and 7 are pressed together.]
等到 <<遥控器按键 [5 v] 按下了？> [and v] <遥控器按键 [7 v] 按下了？>>
在控制台上打印 [Both buttons pressed!]▶

not operator #

The not operator block inverts the result of a Boolean block. If the input is True, it returns False, and if the input is False, it returns True.

True — The input condition would normally return False.
False — The input condition would normally return True.

The Not Operator Boolean block.#

<非 <>>

Parameter	Description
condition	The Boolean condition to be inverted.

Example

当开始
[Move with controller while button 5 is not pressed.]
起飞至 [500] [毫米 v] ▶
当 <非 <遥控器按键 [5 v] 按下了？>>
使用遥控器移动
结束
土地 ▶

range operator #

The range operator block checks if a value falls within a specified range. It returns either True or False.

True — If the value is within the range.
False — If the value is outside the range.

The Range Operator Boolean block.#

<[0] [math_less_than v] [0] [math_less_than v] [0]>

Parameter	Description
first operator	The comparison operator to use: < — Less than ≤ — Less than or equal to > — Greater than ≥ — Greater than or equal to
value	The value to check.
second operator	The comparison operator to use: < — Less than ≤ — Less than or equal to > — Greater than ≥ — Greater than or equal to

Parameter

Description

first operator

The comparison operator to use:

< — Less than
≤ — Less than or equal to
> — Greater than
≥ — Greater than or equal to

value

The value to check.

second operator

The comparison operator to use:

< — Less than
≤ — Less than or equal to
> — Greater than
≥ — Greater than or equal to

Example

当开始
[Hover at approximately 1000mm then land.]
起飞至 [500] [毫米 v] ▶
爬升 [向上 v]
等到 <[1000] [math_less_than v] (altitude in [mm v]) [math_less_than v] [1100]>
徘徊
等待 (3) 秒
土地 ▶

pick random #

The pick random block generates a random number within a specified range. The number returned will be an integer if both parameters are whole numbers or a decimal if either parameter contains a decimal.

The Pick Random reporter block.#

在 [1] 到 [10] 之间选随机数

Parameters	Description
min	The lowest possible number that can be picked.
max	The highest possible number that can be picked.

Examples

Display a number between 1 and 10.#

当开始
[Display a number between 1 and 10.]
在控制台上打印 (在 [1] 到 [10] 之间选随机数)▶

Display a decimal number between 1 and 10.5.#

当开始
[Display a decimal number between 1 and 10.5.]
在控制台上设定打印精度为 [All Digits v]
在控制台上打印 (在 [1] 到 [10.5] 之间选随机数)▶

round number #

The round number block rounds a given number to the nearest whole number. It follows standard rounding rules:

If the decimal is 0.5 or greater, the number rounds up.
If the decimal is less than 0.5, the number rounds down.

The Round Number reporter block.#

([0] 四舍五入到 [0] 位小数)

Parameter	Description
number	The number to round.
decimal places	The amount of decimals places to round to.

Example

Display the rounded result of 10 / 3.#

当开始
[Display the rounded result of 10 / 3.]
在控制台上设定打印精度为 [0.01 v]
在控制台上打印 (([10] [math_division v] [3]) 四舍五入到 [1] 位小数)▶

math functions #

The math functions block applies a selected mathematical function to a given number and returns the result. It supports operations such as absolute value, rounding, square roots, trigonometric functions, logarithms, and exponentiation.

The Math Functions reporter block.#

[abs v] 的 [0]

Parameter	Description
function	The mathematical operation to apply to the input value: abs — Absolute value floor — Rounds down ceiling — Rounds up sqrt — Square root sin — Sine cos — Cosine tan — Tangent asin — Inverse sine acos — Inverse cosine atan — Inverse tangent ln — Natural logarithm log — Base 10 logarithm e^ — Euler’s number raised to a power 10^ — 10 raised to a power negative — Returns the negative of the number
number	The number to apply the function to.

Parameter

Description

function

The mathematical operation to apply to the input value:

abs — Absolute value
floor — Rounds down
ceiling — Rounds up
sqrt — Square root
sin — Sine
cos — Cosine
tan — Tangent
asin — Inverse sine
acos — Inverse cosine
atan — Inverse tangent
ln — Natural logarithm
log — Base 10 logarithm
e^ — Euler’s number raised to a power
10^ — 10 raised to a power
negative — Returns the negative of the number

number

The number to apply the function to.

Example

Display the square root of 16.#

当开始
[Display the square root of 16.]
在控制台上打印 ([sqrt v] 的 [16])▶

atan2 #

The atan2 block calculates the principal value of the inverse tangent of Y/X. It returns the angle in degrees between the positive X-axis and the point (X, Y).

atan2 block#

(atan2 of x:[4] y:[3])

Parameter	Description
X	The horizontal position of the point, measured from the origin (0, 0).
Y	The vertical position of the point, measured from the origin (0, 0).

Example

Calculate the angle from current position (4, 3).#

当开始
[Calculate the angle from current position (4, 3).]
在控制台上打印 (atan2 of x:[4] y:[3])▶

remainder #

The remainder block calculates the remainder when dividing one number by another.

The Remainder reporter block.#

remainder of [0] / [0]

Parameter	Description
dividend	The number to be divided.
divisor	The number to divide by.

Example

Display the remainder of 10 / 3.#

当开始
[Display the remainder of 10 / 3.]
在控制台上打印 (remainder of [10] / [3])▶

join #

The join block combines two or more strings into a single string. It returns a string that contains the combined text of the given inputs.

The Join reporter block.#

(连接 [apple] [banana])

parameter	description
string 1	The first string to combine.
string 2	The second string to combine.

Example

当开始
[Display "VEXcode" on the Console.]
在控制台上打印 (连接 [VEX] [code])▶

letter #

The letter block extracts a specific character from a string based on its position. It returns a single-character string, representing the letter at the given position.

The Letter reporter block.#

([1] 的第 [apple] 个字符)

parameter	description
position	The position of the character in the string (starting at 1).
string	The string to extract a letter from.

Example

当开始
[Display the first letter of "drone".]
在控制台上打印 ((1) 的第 [drone] 个字符)▶

length #

The length block reports the number of characters in a string, including spaces. It returns a whole number, representing the total number of characters.

The Length reporter block.#

([apple] 长度)

parameter	description
string	The string to measure the length of.

Example

当开始
[Count the number of characters in "VEX Robotics".]
在控制台上打印 ([VEX Robotics] 长度)▶

contains #

The contains block checks if a string includes a specific word or character. It returns either True or False.

True — The string includes that specific word or character.
False — The string does not include that specific word or character.

The Contains Boolean block.#

<[apple] contains [a] ?>

parameter	description
string	The main string to search within.
search term	The word or character to check for inside the string.

Example

当开始
[Check if "robotics" contains "bot".]
如果 <[robotics] contains [bot] ?> 那么
在控制台上打印 [The word contains "bot".]▶
否则
在控制台上打印 [Not found.]▶
结束

convert #

The convert block changes a number into a different format: a string or decimal number. It returns the value in the selected format:

text — Converts the number to a string. Numbers must be in string format to work with String Operator blocks.
number — Converts the number to a decimal (floating-point) value.

The Convert reporter block.#

(转换 [0] 为 [文本 v])

parameter	description
value	The number to convert.
type	The type to convert the number into: text number

parameter

description

value

The number to convert.

type

The type to convert the number into:

text
number

Example

当开始
[Add any number to 5.]
询问 [Give me a number.] 并等待
在控制台上打印 ((转换 (应答) 为 [数字 v]) [math_plus v] [5])▶