]> git.saurik.com Git - wxWidgets.git/commitdiff
documented just added env functions
authorVadim Zeitlin <vadim@wxwidgets.org>
Sun, 26 Nov 2000 22:55:32 +0000 (22:55 +0000)
committerVadim Zeitlin <vadim@wxwidgets.org>
Sun, 26 Nov 2000 22:55:32 +0000 (22:55 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@8838 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/latex/wx/function.tex

index 0b116e9eaeb2302d1bc1247c300c9eb330d1f9e8..6c8dc48c2f1fcacadfb17030effbeb5eeec99892 100644 (file)
@@ -2965,3 +2965,42 @@ This is the same as \helpref{wxCHECK2}{wxcheck2}, but
 \helpref{wxFAIL\_MSG}{wxfailmsg} with the specified {\it msg} is called
 instead of wxFAIL() if the {\it condition} is false.
 
+\section{Environment access functions}\label{environfunctions}
+
+The functions in this section allow to access (get) or change value of
+environment variables in a portable way. They are currently implemented under
+Win32 and POSIX-like systems (Unix).
+
+% TODO add some stuff about env var inheriting but not propagating upwards (VZ)
+
+\wxheading{Include files}
+
+<wx/utils.h>
+
+\membersection{wxGetEnv}\label{wxgetenv}
+
+\func{wxChar *}{wxGetEnv}{\param{const wxString\&}{ var}}
+
+Returns the current value of the environment variable {\it var} or {\tt NULL} 
+if it doesn't exist.
+
+\membersection{wxSetEnv}\label{wxsetenv}
+
+\func{bool}{wxSetEnv}{\param{const wxString\&}{ var}, \param{const wxChar *}{value}}
+
+Sets the value of the environment variable {\it var} (adding it if necessary)
+to {\it value}.
+
+Returns {\tt TRUE} on success.
+
+\membersection{wxUnsetEnv}\label{wxunsetenv}
+
+\func{bool}{wxUnsetEnv}{\param{const wxString\&}{ var}}
+
+Removes the variable {\it var} from the environment. 
+\helpref{wxGetEnv}[wxgetenv} will return {\tt NULL} after the call to this
+function.
+
+Returns {\tt TRUE} on success.
+
+