getTaskRobot(3)

NAME
getTaskRobot, findTaskRobot -- obtain pointer for robot attached to RCI task.

USAGE
#include <rci.h>

RCI_RBT *getTaskRobot(name)
  const char *name;

RCI_RBT* findTaskRobot(id)
  int id;

ARGUMENTS

name --
    Name of the robot (the same name given to rciAttachRobot()).

id --
    ID of the robot (the same number returned by find_robot()).

DESCRIPTION
These routines are used to obtain a pointer to the robot descriptor RCI_RBT for a robot that is attached to an RCI control task.

getTaskRobot() references the robot by name, and can be called from any RCI task, not just the one which has the robot attached.

findTaskRobot() references the robot using its ID number, and can also be called from any RCI task, not just the one which has the robot attached.

DIAGNOSTICS
The routines returns NULL if the robot is not currently attached to some RCI task within the current program.

SEE ALSO
rciAttachRobot(3), TASKROBOT(3), RCI_RBT(3).