getDefaultRobot(3)

NAME
getDefaultRobot -- RCI database routine to get name of default robot.

USAGE
char *getDefaultRobot()

RESTRICTIONS
This routine must be called from the planning level.

DESCRIPTION
Returns a string identifying the system's default robot, which is described in the single-line file $RCCL/conf/defaultRobot. This string can be used as an argument to the routines that return parameters for a robot, such as getJls() or getKyn().

DIAGNOSTICS
The function returns NULL if it can't find the name. Error information is reported on the errorStack (q.v.), and returned error codes are accessible with getErrorCode(). Possible error codes are:

EEnvironment --
    The environment variable RCCL is not set.

EBadAccess --
    Can't open the file $RCCL/conf/defaultRobot.

EBadObj --
    Can't read the file $RCCL/conf/defaultRobot.

The routine will abort the program if called from the control level.

SEE ALSO
getJls(3), errorStack(3).