oracular (3) VistaIOSetProgramName.3.gz

NAME

       VistaIOSetProgramName - register a program name for error messages

SYNOPSIS

       void VistaIOSetProgramName (name)
              VistaIOStringConst name

ARGUMENTS

       name      Specifies  the  program's  name  as  a  null-terminated  string, or is NULL to indicate that no
                 program name should be registered.

DESCRIPTION

       VistaIOSetProgramName determines what, if any, program name will be included in subsequent error messages
       composed by VistaIOError (3), VistaIOSystemError(3), VistaIOWarning(3), and VistaIOSystemWarning(3).

       Initially,  no  program name is registered. If VistaIOSetProgramName is called with a string, that string
       is registered as the program name.  If VistaIOSetProgramName is called with  an  argument  of  NULL,  any
       previously-registered name is forgotten.

EXAMPLES

              int main (argc, argv)
              int argc;
              char *argv[];
              {
                   ...
                   VistaIOSetProgramName (argv[0]);
                   ...
              }

SEE ALSO

       VistaIOError(3), VistaIOWarning(3), VistaIOSetErrorHandler(3), VistaIOSetWarningHandler(3),

NOTES

       VistaIOSetProgramName  does not make its own copy of the string it is passed.  Consequently, storage used
       for the string must be maintained by the caller.

AUTHOR

       Art Pope <pope@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>