ev_get_var() — Apollo Domain/OS SR10.3.5

EV_$GET_VAR                       Domain/OS                        EV_$GET_VAR


NAME
     ev_$get_var - get an environment variable

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

     boolean ev_$get_var(
          char *variable_name,
          short &name_length,
          char **value_ptr,
          short *value_length)

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

     function ev_$get_var(
          in variable_name: univ ev_$string_t;
          in name_length: integer;
          out value_p: ev_$string_ptr_t;
          out 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, value*256
           logical variable_exists

           integer*4 value_ptr
           pointer /value_ptr/ value

           variable_exists = ev_$get_var(variable_name, name_length,
          &                              value_ptr, value_length)

DESCRIPTION
     Ev_$get_var supplies a pointer to the value of the environment variable
     named variable_name.  It returns true if a variable named variable_name
     exists in the environment.  It returns false otherwise.

     variable_name
          The name of the environment variable to get.

     name_length
          The number of bytes in variable_name.

     value_ptr
          A pointer to the value of the environment variable.

     value_length
          The number of bytes in the value at value_ptr.
Museum
