ev_set_var() — Apollo

EV_$SET_VAR                       Domain/OS                        EV_$SET_VAR


NAME
     ev_$set_var - set an environment variable

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

     boolean ev_$set_var(
          char *variable_name,
          short &name_length,
          char *variable_value,
          short &value_length)

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

     function ev_$set_var(
          in variable_name: univ ev_$string_t;
          in name_length: integer;
          in variable_value: univ ev_$string_t;
          in value_length: integer): boolean;

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

           integer*2 name_length, value_length
           character variable_name*256, variable_value*256
           logical variable_set

           variable_set = ev_$set_var(variable_name, name_length,
          &                           variable_value, value_length)

DESCRIPTION
     Ev_$set_var sets the environment variable named variable_name to the
     value in variable_value.  It returns true if the variable was success-
     fully set, or false otherwise.  Ev_$set_var returns false if
     variable_name is a protected environment variable, such as USER, or if
     one of its arguments is invalid, if name_length is negative or 0 for
     instance.

     variable_name
          The name of the environment variable to set.

     name_length
          The number of bytes in variable_name.

     variable_value
          The value to set variable_name to.

     value_length
          The number of bytes in variable_value.
Museum
