HB_GETENV()
Obtains a system environmental setting.
Syntax
HB_GETENV(<cEnviroment>, [<cDefaultValue>], [<lApplyCodepage>] )
--> <cReturn>
Arguments
<cEnviroment> Enviromental variable to obtain.
<cDefaultValue> Optional value to return if <cEnvironment> is not found.
<lApplyCodepage> optional logical parameter specifing whether to apply automatic codepage conversion (to the codepage specified by Set( _SET_OSCODEPAGE ) on the obtained value. The default is .T. Note that if the default value is passed and the environment value is not found, this codepage conversion is not performed against the returned default value
Returns
<cReturn> Value of the environment variable or <cDefaultValue> or an empty string.
Description
This function yields a string that is the value of the environment variable <cEnviroment>, which is stored at the system level.
If no environment variable can be found, the value of the function will be <cDefaultValue> if it is passed, else an empty string.
Examples
? HB_GETENV( "PATH" )
? HB_GETENV( "CONFIG" )
? HB_GETENV( "HARBOURCMD", "-n -l -es2" )
Compliance
Harbour
Platforms
All
Files
src/rtl/gete.c Library is rtl
Seealso
GETENV, GETE