ev_delete_var()

EV_$DELETE_VAR                    Domain/OS                     EV_$DELETE_VAR


NAME
     ev_$delete_var - delete an environment variable

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/ev.h>

     boolean ev_$delete_var(
          char *variable_name,
          short &name_length)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/ev.ins.pas';

     function ev_$delete_var(
          in variable_name: univ ev_$string_t;
          in name_length: integer): boolean;

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/ev.ins.ftn'

           integer*2 name_length
           character variable_name*256
           logical variable_found

           variable_found = ev_$delete_var(variable_name, name_length)

DESCRIPTION
     Ev_$delete_var removes the variable named variable_name from the environ-
     ment if it is defined.  It returns true if a variable named variable_name
     actually existed in the environment.  Ev_$delete_var returns false if
     there was no variable named variable_name in the environment when it was
     called.

     variable_name
          The name of the environment variable to delete.

     name_length
          The number of bytes in variable_name.
Museum
