Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <process.h>
    int _bgetcmd( char *cmd_line, int len );

Description:
    The _bgetcmd function causes the command line information, with the
    program name removed, to be copied to cmd_line.  The argument len
    specifies the size of cmd_line.  The information is terminated with a
    '\0' character.  This provides a method of obtaining the original
    parameters to a program unchanged (with the white space intact).

    This information can also be obtained by examining the vector of program
    parameters passed to the main function in the program.

Returns:
    The number of bytes required to store the entire command line, excluding
    the terminating null character, is returned.

Example:
    Suppose a program were invoked with the command line

         myprog arg-1 ( my   stuff ) here

    where that program contains

    #include <stdio.h>
    #include <stdlib.h>
    #include <process.h>

    void main()
      {
        char *cmdline;
        int   cmdlen;

        cmdlen = _bgetcmd( NULL, 0 ) + 1;
        cmdline = malloc( cmdlen );
        if( cmdline != NULL ) {
          cmdlen = _bgetcmd( cmdline, cmdlen );
          printf( "%s\n", cmdline );
        }
      }

    produces the following:

      arg-1 ( my   stuff ) here

Classification:
    WATCOM

Systems:
    All, Netware

See Also:
    abort, atexit, exec Functions, exit, _exit, getcmd, getenv, main,
    onexit, putenv, spawn Functions, system