c_cpp/etc/calc/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
  50 ## Copyright (C) 1999  Landon Curt Noll
  51 ##
  52 ## Calc is open software; you can redistribute it and/or modify it under
  53 ## the terms of the version 2.1 of the GNU Lesser General Public License
  54 ## as published by the Free Software Foundation.
  55 ##
  56 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  57 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  58 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  59 ## Public License for more details.
  60 ##
  61 ## A copy of version 2.1 of the GNU Lesser General Public License is
  62 ## distributed with calc under the filename COPYING-LGPL.  You should have
  63 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  64 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  65 ##
  66 ## @(#) $Revision: 30.1 $
  67 ## @(#) $Id: putenv,v 30.1 2007/03/16 11:10:42 chongo Exp $
  68 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/putenv,v $
  69 ##
  70 ## Under source code control:   1995/07/09 03:48:57
  71 ## File existed as early as:    1995
  72 ##
  73 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  74 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/