ian@0: //
ian@0: // Boost.Process
ian@0: // ~~~~~~~~~~~~~
ian@0: //
ian@0: // Copyright (c) 2006, 2007 Julio M. Merino Vidal
ian@0: // Copyright (c) 2008 Ilya Sokolov, Boris Schaeling
ian@0: // Copyright (c) 2009 Boris Schaeling
ian@0: // Copyright (c) 2010 Felipe Tanus, Boris Schaeling
ian@0: //
ian@0: // Distributed under the Boost Software License, Version 1.0. (See accompanying
ian@0: // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
ian@0: //
ian@0: 
ian@0: /**
ian@0:  * \file boost/process/environment.hpp
ian@0:  *
ian@0:  * Includes the declaration of the environment class.
ian@0:  */
ian@0: 
ian@0: #ifndef BOOST_PROCESS_ENVIRONMENT_HPP
ian@0: #define BOOST_PROCESS_ENVIRONMENT_HPP
ian@0: 
ian@0: #include <map>
ian@0: #include <string>
ian@0: 
ian@0: namespace boost {
ian@0: namespace process {
ian@0: 
ian@0: /**
ian@0:  * Representation of a process' environment variables.
ian@0:  *
ian@0:  * The environment is a map that establishes an unidirectional
ian@0:  * association between variable names and their values and is
ian@0:  * represented by a string to string map.
ian@0:  *
ian@0:  * Variables may be defined to the empty string. Be aware that doing so
ian@0:  * is not portable: POSIX systems will treat such variables as being
ian@0:  * defined to the empty value, but Windows systems are not able to
ian@0:  * distinguish them from undefined variables.
ian@0:  *
ian@0:  * Neither POSIX nor Windows systems support a variable with no name.
ian@0:  *
ian@0:  * It is worthy to note that the environment is sorted alphabetically.
ian@0:  * This is provided for-free by the map container used to implement this
ian@0:  * type, and this behavior is required by Windows systems.
ian@0:  */
ian@0: typedef std::map<std::string, std::string> environment;
ian@0: 
ian@0: }
ian@0: }
ian@0: 
ian@0: #endif