Libraries.Robots.Lego.Utility Documentation

This class is an object representation of the LEGO EV3 Mindstorms's miscellaneous capabilities. Currently, this is only used to pause the execution of a program of a robot.

Example Code

use Libraries.Robots.Lego.Utility
    use Libraries.Robots.Lego.Motor

    Utility utility
    Motor motor
    
    motor:SetSpeed(motor:MOTOR_B, 600)
    motor:RotateForward(motor:MOTOR_B)
    utility:DelayMilliseconds(1000)     //the program will wait 1 second before moving onto the next line of code, where the motor will then stop
    motor:Stop(motor:MOTOR_B)

Inherits from: Libraries.Language.Object

Summary

Actions Summary Table

ActionsDescription
Compare(Libraries.Language.Object object)This action compares two object hash codes and returns an integer.
DelayMilliseconds(integer time)This action pauses the execution of the robot's program temporarily.
Equals(Libraries.Language.Object object)This action determines if two objects are equal based on their hash code values.
GetHashCode()This action gets the hash code for an object.

Actions Documentation

Compare(Libraries.Language.Object object)

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Example Code

Object o
        Object t
        integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

Parameters

Return

integer: The Compare result, Smaller, Equal, or Larger.

DelayMilliseconds(integer time)

This action pauses the execution of the robot's program temporarily.

Example Code

use Libraries.Robots.Lego.Utility
    use Libraries.Robots.Lego.Sound
    use Libraries.Robots.Lego.Motor

    Utility utility
    Sound sound
    Motor motor
    
    motor:SetSpeed(motor:MOTOR_B, 720)
    motor:SetSpeed(motor:MOTOR_C, 720)      //two motors used to move the robot, connected to ports B and C
    motor:RotateForward(motor:MOTOR_B)
    motor:RotateForward(motor:MOTOR_C)
    repeat 5 times
        sound:Beep()
        utility:DelayMilliseconds(1000)      //wait a second in between beeps
    end
    motor:Stop(motor:MOTOR_B)   //because of the 1 seconds delay repeating 5 times, the motors get to run for 5 seconds
    motor:Stop(motor:MOTOR_C)

Parameters

Equals(Libraries.Language.Object object)

This action determines if two objects are equal based on their hash code values.

Example Code

use Libraries.Language.Object
        use Libraries.Language.Types.Text
        Object o
        Text t
        boolean result = o:Equals(t)

Parameters

Return

boolean: True if the hash codes are equal and false if they are not equal.

GetHashCode()

This action gets the hash code for an object.

Example Code

Object o
        integer hash = o:GetHashCode()

Return

integer: The integer hash code of the object.