Spanish/Doc/TutorialArgs

From The Player Project

Jump to: navigation, search

/** @ingroup tutorials @defgroup tutorial_args Argumentos en la línea de comandos @brief Parsear los argumentos en la línea de comandos

Si quieres pasar una argumentos de línea de comandos a los programas cliente Player, se puede utilizar la utilidad getopt proporcionada por unistd.h

\dontinclude args.h \skipline unistd

Se debe suministrar una serie de caracteres en optflags, los cuales son opciones legítimas para el programa. Si el caracter es seguido por dos puntos (:) entonces esa opcion require un parámetro adicional. Estos parámetros son devueltos como const char*, por tanto se tienen que usar funciones como atoi() o atof() si se quieren conseguir resultados numéricos.

\skip parse_args \until end parse_args

También es a menudo útil incluir pequeñas funciones que expliquen los parámetros de tu programa.

@verbatim USAGE: myprogram [options]

Donde [options] puede ser:

 -h <hostname>  : nombre del ordenador al que conectar  (default: localhost)
 -p <port>      : puerto en el que escucha Player (default: 6665)
 -i <index>     : índice de dispositivo (default: 0)
 -d <level>     : nivel de depurado para los mensajes (0 = ninguno -- 9 = todo)
 -u <rate>      : Ajusta el ratio de actualización del servidor a <rate> en Hz
 -m <datamode>  : Asusta el modo de envío de datos del servidor
                     PLAYER_DATAMODE_PUSH_ALL = 0
                     PLAYER_DATAMODE_PULL_ALL = 1
                     PLAYER_DATAMODE_PUSH_NEW = 2
                     PLAYER_DATAMODE_PULL_NEW = 3
                     PLAYER_DATAMODE_ASYNC    = 4

@endverbatim

\skip print_usage \until end print_usage

Para el código completo vea examples/libplayerc++/args.h

  • /
Personal tools