Poco

class Environment

Library: Foundation
Package: Core
Header: Poco/Environment.h

Description

This class provides access to environment variables and some general system information.

Member Summary

Member Functions: get, has, nodeId, nodeName, osArchitecture, osName, osVersion, set

Types

NodeId

typedef UInt8 NodeId[6];

Ethernet address.

Member Functions

get static

static std::string get(
    const std::string & name
);

Returns the value of the environment variable with the given name. Throws a NotFoundException if the variable does not exist.

get static

static std::string get(
    const std::string & name,
    const std::string & defaultValue
);

Returns the value of the environment variable with the given name. If the environment variable is undefined, returns defaultValue instead.

has static

static bool has(
    const std::string & name
);

Returns true iff an environment variable with the given name is defined.

nodeId static

static void nodeId(
    NodeId & id
);

Returns the Ethernet address of the first Ethernet adapter found on the system.

Throws a SystemException if no Ethernet adapter is available.

nodeId static

static std::string nodeId();

Returns the Ethernet address (format "xx:xx:xx:xx:xx:xx") of the first Ethernet adapter found on the system.

Throws a SystemException if no Ethernet adapter is available.

nodeName static

static std::string nodeName();

Returns the node (or host) name.

osArchitecture static

static std::string osArchitecture();

Returns the operating system architecture.

osName static

static std::string osName();

Returns the operating system name.

osVersion static

static std::string osVersion();

Returns the operating system version.

set static

static void set(
    const std::string & name,
    const std::string & value
);

Sets the environment variable with the given name to the given value.