SDL::EnvironmentRef Struct Reference

Semi-safe reference for Environment.

Inheritance diagram for SDL::EnvironmentRef:

Collaboration diagram for SDL::EnvironmentRef:

Public Member Functions
	EnvironmentRef (EnvironmentParam resource) noexcept
	Constructs from EnvironmentParam. More...
	EnvironmentRef (EnvironmentRaw resource) noexcept
	Constructs from EnvironmentParam. More...
	EnvironmentRef (const EnvironmentRef &other) noexcept
	Copy constructor.
	~EnvironmentRef ()
	Destructor.
constexpr	Environment (std::nullptr_t=nullptr) noexcept
	Default ctor.
constexpr	Environment (const EnvironmentRaw resource) noexcept
	Constructs from EnvironmentParam. More...
constexpr	Environment (const Environment &other)=delete
	Copy constructor.
constexpr	Environment (Environment &&other) noexcept
	Move constructor.
constexpr	Environment (const EnvironmentRef &other)=delete
constexpr	Environment (EnvironmentRef &&other)=delete
	Environment (bool populated)
	Create a set of environment variables. More...
Public Member Functions inherited from SDL::Environment
constexpr	Environment (std::nullptr_t=nullptr) noexcept
	Default ctor.
constexpr	Environment (const EnvironmentRaw resource) noexcept
	Constructs from EnvironmentParam. More...
constexpr	Environment (const Environment &other)=delete
	Copy constructor.
constexpr	Environment (Environment &&other) noexcept
	Move constructor.
constexpr	Environment (const EnvironmentRef &other)=delete
constexpr	Environment (EnvironmentRef &&other)=delete
	Environment (bool populated)
	Create a set of environment variables. More...
	~Environment ()
	Destructor.
constexpr Environment &	operator= (Environment &&other) noexcept
	Assignment operator.
constexpr EnvironmentRaw	get () const noexcept
	Retrieves underlying EnvironmentRaw.
constexpr EnvironmentRaw	release () noexcept
	Retrieves underlying EnvironmentRaw and clear this.
constexpr auto	operator<=> (const Environment &other) const noexcept=default
	Comparison.
constexpr	operator bool () const noexcept
	Converts to bool.
constexpr	operator EnvironmentParam () const noexcept
	Converts to EnvironmentParam.
void	Destroy ()
	Destroy a set of environment variables. More...
const char *	GetVariable (StringParam name)
	Get the value of a variable in the environment. More...
OwnArray< char * >	GetVariables ()
	Get all variables in the environment. More...
Uint64	GetVariableCount ()
	Get the Variables count. More...
void	SetVariable (StringParam name, StringParam value, bool overwrite)
	Set the value of a variable in the environment. More...
void	UnsetVariable (StringParam name)
	Clear a variable from the environment. More...

Additional Inherited Members
Protected Member Functions inherited from SDL::Environment
constexpr Environment &	operator= (const Environment &other) noexcept=default
	Assignment operator.

Constructor & Destructor Documentation

EnvironmentRef() [1/2]

SDL::EnvironmentRef::EnvironmentRef ( EnvironmentParam  resource )

inlinenoexcept

Parameters

resource

a EnvironmentRaw or Environment.

This does not takes ownership!

EnvironmentRef() [2/2]

SDL::EnvironmentRef::EnvironmentRef ( EnvironmentRaw  resource )

inlinenoexcept

Parameters

resource

a EnvironmentRaw or Environment.

This does not takes ownership!

Member Function Documentation

Environment() [1/2]

SDL::Environment::Environment ( bool  populated )

inline

Parameters

populated

true to initialize it from the C runtime environment, false to create an empty environment.

Postcondition

a pointer to the new environment or nullptr on failure; call GetError() for more information.

Thread safety:

If populated is false, it is safe to call this function from any thread, otherwise it is safe if no other threads are calling setenv() or unsetenv()

Since

This function is available since SDL 3.2.0.

See also

Environment.GetVariable

Environment.GetVariables

Environment.SetVariable

Environment.UnsetVariable

Environment.Destroy

Environment() [2/2]

constexpr SDL::Environment::Environment ( const EnvironmentRaw  resource )

inlineexplicitconstexprnoexcept

Parameters

resource

a EnvironmentRaw to be wrapped.

This assumes the ownership, call release() if you need to take back.

---

The documentation for this struct was generated from the following file:

• SDL3pp/SDL3pp_stdinc.h