help/putenv

   1 NAME
   2     putenv - set the value of an environment variable
   3
   4 SYNOPSIS
   5     putenv(env [,val])
   6
   7 TYPES
   8     env         str
   9     val         str
  10
  11     return      int
  12
  13 DESCRIPTION
  14      This function will set or change the value of an environment variable.
  15      Zero is returned if the environment variable was successfully set,
  16      otherwise a non-zero result is returned.
  17
  18      When called with 1 arg, env must be a string of the form:
  19
  20             "envname=envval"
  21
  22      This sets the environment variable "envname" to the value "envval".
  23
  24      The 2 arg form is equivalent to:
  25
  26             putenv(strcat(env, "=", val))
  27
  28
  29 EXAMPLE
  30     > putenv("name", "value")
  31             0
  32     > getenv("name")
  33             "value"
  34     > putenv("name=val2")
  35             0
  36     > getenv("name")
  37             "val2"
  38     > isnull(getenv("unknown"))
  39             1
  40
  41 LIMITS
  42     With 1 arg, env must contain at least 1 '=' character.
  43
  44 LINK LIBRARY
  45     none
  46
  47 SEE ALSO
  48     getenv
  49