tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironment (Operator)
Name
tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironment — Read one or more environment variables.
Signature
Herror tuple_environment(const char* Names, char* Values)
Herror T_tuple_environment(const Htuple Names, Htuple* Values)
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
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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