Hand_Number Function

Acquires the hand number associated with the hand label.

Syntax
Hand_Number( Hand Label )

Parameters
Hand Label Specify the hand label set. (Up to 31 one-byte characters in length)

Return Values
Hand number (integer)

Description
This function displays the hand number associated with the hand label specified in the Configure Robot Hand screen. If a hand with the label specified cannot be found, an error message will appear: “Error 2555: Undefined label set. Please specify a defined label”.

Note
Hands that have not been assigned a label
A hand label does not need to be assigned when configuring hand settings. As such, you can register multiple hands without a label name.
Enter in the following to return the lowest hand number among hands without a label.

> print Hand_Number("")  

We recommend assigning a hand label to each hand registered due to the difficulty of identifying unlabeled hands within a program.

See Also
Hand_Label$ Function

Hand_Number Function Example

String HandName$  
  
Print Hand_Number(Hand1)		' Display the hand 1 number  
Print Hand_Number("Hand1")  
  
HandName$ = "Hand1"  
Print Hand_Number(HandName$)