tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironment (Operator)

Name

tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironment — Read one or more environment variables.

Signature

tuple_environment( : : Names : Values)

Herror tuple_environment(const char* Names, char* Values)

Herror T_tuple_environment(const Htuple Names, Htuple* Values)

void TupleEnvironment(const HTuple& Names, HTuple* Values)

HTuple HTuple::TupleEnvironment() const

static void HOperatorSet.TupleEnvironment(HTuple names, out HTuple values)

HTuple HTuple.TupleEnvironment()

Description

tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmentTupleEnvironment reads the content of all environment variables that are referenced by their names in the input tuple NamesNamesNamesNamesnames and returns the content with the output tuple ValuesValuesValuesValuesvalues. The input tuple may only contain strings.

For general information about string operations see Tuple / String Operations.

Exception: Empty input tuples

If the input tuple is empty, the operator returns an empty tuple. Additionally, an empty string is returned for every name within NamesNamesNamesNamesnames that does not denote a valid environment variable.

HDevelop In-line Operation

HDevelop provides an in-line operation for tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmentTupleEnvironment, which can be used in an expression in the following syntax:

Values := environment(Names)

Execution Information

Parameters

NamesNamesNamesNamesnames (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Tuple containing name(s) of the environment variable(s).

ValuesValuesValuesValuesvalues (output_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Content of the environment variable(s).

Alternatives

tuple_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstr, tuple_strrstrtuple_strrstrTupleStrrstrTupleStrrstrTupleStrrstr, tuple_strchrtuple_strchrTupleStrchrTupleStrchrTupleStrchr, tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrTupleStrrchr, tuple_strlentuple_strlenTupleStrlenTupleStrlenTupleStrlen, tuple_str_first_ntuple_str_first_nTupleStrFirstNTupleStrFirstNTupleStrFirstN, tuple_str_last_ntuple_str_last_nTupleStrLastNTupleStrLastNTupleStrLastN, tuple_splittuple_splitTupleSplitTupleSplitTupleSplit, tuple_substrtuple_substrTupleSubstrTupleSubstrTupleSubstr

Module

Foundation