mirror of
https://github.com/NixOS/nix
synced 2025-07-06 00:51:47 +02:00
6c861b9c51
This ended up motivating a good deal of other infra improvements in order to get Windows right: - `OsString` to complement `std::filesystem::path` - env var code for working with the underlying `OsString`s - Rename `PATHNG_LITERAL` to `OS_STR` - `NativePathTrait` renamed to `OsPathTrait`, given a character template parameter until #9205 is complete. Split `tests.cc` matching split of `util.{cc,hh}` last year. Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
67 lines
1.3 KiB
C++
67 lines
1.3 KiB
C++
#pragma once
|
|
/**
|
|
* @file
|
|
*
|
|
* Utilities for working with the current process's environment
|
|
* variables.
|
|
*/
|
|
|
|
#include <optional>
|
|
|
|
#include "types.hh"
|
|
#include "file-path.hh"
|
|
|
|
namespace nix {
|
|
|
|
/**
|
|
* @return an environment variable.
|
|
*/
|
|
std::optional<std::string> getEnv(const std::string & key);
|
|
|
|
/**
|
|
* Like `getEnv`, but using `OsString` to avoid coercions.
|
|
*/
|
|
std::optional<OsString> getEnvOs(const OsString & key);
|
|
|
|
/**
|
|
* @return a non empty environment variable. Returns nullopt if the env
|
|
* variable is set to ""
|
|
*/
|
|
std::optional<std::string> getEnvNonEmpty(const std::string & key);
|
|
|
|
/**
|
|
* Get the entire environment.
|
|
*/
|
|
std::map<std::string, std::string> getEnv();
|
|
|
|
#ifdef _WIN32
|
|
/**
|
|
* Implementation of missing POSIX function.
|
|
*/
|
|
int unsetenv(const char * name);
|
|
#endif
|
|
|
|
/**
|
|
* Like POSIX `setenv`, but always overrides.
|
|
*
|
|
* We don't need the non-overriding version, and this is easier to
|
|
* reimplement on Windows.
|
|
*/
|
|
int setEnv(const char * name, const char * value);
|
|
|
|
/**
|
|
* Like `setEnv`, but using `OsString` to avoid coercions.
|
|
*/
|
|
int setEnvOs(const OsString & name, const OsString & value);
|
|
|
|
/**
|
|
* Clear the environment.
|
|
*/
|
|
void clearEnv();
|
|
|
|
/**
|
|
* Replace the entire environment with the given one.
|
|
*/
|
|
void replaceEnv(const std::map<std::string, std::string> & newEnv);
|
|
|
|
}
|