/*
|
/*
|
FUNCTION
|
FUNCTION
|
<<getenv>>---look up environment variable
|
<<getenv>>---look up environment variable
|
|
|
INDEX
|
INDEX
|
getenv
|
getenv
|
INDEX
|
INDEX
|
environ
|
environ
|
|
|
ANSI_SYNOPSIS
|
ANSI_SYNOPSIS
|
#include <stdlib.h>
|
#include <stdlib.h>
|
char *getenv(const char *<[name]>);
|
char *getenv(const char *<[name]>);
|
|
|
TRAD_SYNOPSIS
|
TRAD_SYNOPSIS
|
#include <stdlib.h>
|
#include <stdlib.h>
|
char *getenv(<[name]>)
|
char *getenv(<[name]>)
|
char *<[name]>;
|
char *<[name]>;
|
|
|
DESCRIPTION
|
DESCRIPTION
|
<<getenv>> searches the list of environment variable names and values
|
<<getenv>> searches the list of environment variable names and values
|
(using the global pointer `<<char **environ>>') for a variable whose
|
(using the global pointer `<<char **environ>>') for a variable whose
|
name matches the string at <[name]>. If a variable name matches,
|
name matches the string at <[name]>. If a variable name matches,
|
<<getenv>> returns a pointer to the associated value.
|
<<getenv>> returns a pointer to the associated value.
|
|
|
RETURNS
|
RETURNS
|
A pointer to the (string) value of the environment variable, or
|
A pointer to the (string) value of the environment variable, or
|
<<NULL>> if there is no such environment variable.
|
<<NULL>> if there is no such environment variable.
|
|
|
PORTABILITY
|
PORTABILITY
|
<<getenv>> is ANSI, but the rules for properly forming names of environment
|
<<getenv>> is ANSI, but the rules for properly forming names of environment
|
variables vary from one system to another.
|
variables vary from one system to another.
|
|
|
<<getenv>> requires a global pointer <<environ>>.
|
<<getenv>> requires a global pointer <<environ>>.
|
*/
|
*/
|
|
|
/* This file may have been modified by DJ Delorie (Jan 1991). If so,
|
/* This file may have been modified by DJ Delorie (Jan 1991). If so,
|
** these modifications are Coyright (C) 1991 DJ Delorie, 24 Kirsten Ave,
|
** these modifications are Coyright (C) 1991 DJ Delorie, 24 Kirsten Ave,
|
** Rochester NH, 03867-2954, USA.
|
** Rochester NH, 03867-2954, USA.
|
*/
|
*/
|
|
|
/*
|
/*
|
* Copyright (c) 1987 Regents of the University of California.
|
* Copyright (c) 1987 Regents of the University of California.
|
* All rights reserved.
|
* All rights reserved.
|
*
|
*
|
* Redistribution and use in source and binary forms are permitted
|
* Redistribution and use in source and binary forms are permitted
|
* provided that: (1) source distributions retain this entire copyright
|
* provided that: (1) source distributions retain this entire copyright
|
* notice and comment, and (2) distributions including binaries display
|
* notice and comment, and (2) distributions including binaries display
|
* the following acknowledgement: ``This product includes software
|
* the following acknowledgement: ``This product includes software
|
* developed by the University of California, Berkeley and its contributors''
|
* developed by the University of California, Berkeley and its contributors''
|
* in the documentation or other materials provided with the distribution
|
* in the documentation or other materials provided with the distribution
|
* and in all advertising materials mentioning features or use of this
|
* and in all advertising materials mentioning features or use of this
|
* software. Neither the name of the University nor the names of its
|
* software. Neither the name of the University nor the names of its
|
* contributors may be used to endorse or promote products derived
|
* contributors may be used to endorse or promote products derived
|
* from this software without specific prior written permission.
|
* from this software without specific prior written permission.
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
|
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
|
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
*/
|
*/
|
|
|
#include <stdlib.h>
|
#include <stdlib.h>
|
#include <stddef.h>
|
#include <stddef.h>
|
#include <string.h>
|
#include <string.h>
|
|
|
extern char **environ;
|
extern char **environ;
|
|
|
/*
|
/*
|
* _findenv --
|
* _findenv --
|
* Returns pointer to value associated with name, if any, else NULL.
|
* Returns pointer to value associated with name, if any, else NULL.
|
* Sets offset to be the offset of the name/value combination in the
|
* Sets offset to be the offset of the name/value combination in the
|
* environmental array, for use by setenv(3) and unsetenv(3).
|
* environmental array, for use by setenv(3) and unsetenv(3).
|
* Explicitly removes '=' in argument name.
|
* Explicitly removes '=' in argument name.
|
*
|
*
|
* This routine *should* be a static; don't use it.
|
* This routine *should* be a static; don't use it.
|
*/
|
*/
|
|
|
char *
|
char *
|
_DEFUN (_findenv, (name, offset),
|
_DEFUN (_findenv, (name, offset),
|
register _CONST char *name _AND
|
register _CONST char *name _AND
|
int *offset)
|
int *offset)
|
{
|
{
|
return _findenv_r (_REENT, name, offset);
|
return _findenv_r (_REENT, name, offset);
|
}
|
}
|
|
|
/*
|
/*
|
* getenv --
|
* getenv --
|
* Returns ptr to value associated with name, if any, else NULL.
|
* Returns ptr to value associated with name, if any, else NULL.
|
*/
|
*/
|
|
|
char *
|
char *
|
_DEFUN (getenv, (name),
|
_DEFUN (getenv, (name),
|
_CONST char *name)
|
_CONST char *name)
|
{
|
{
|
int offset;
|
int offset;
|
char *_findenv_r ();
|
char *_findenv_r ();
|
|
|
return _findenv_r (_REENT, name, &offset);
|
return _findenv_r (_REENT, name, &offset);
|
}
|
}
|
|
|
