tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmenttuple_environment (Operator)
Name
tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmenttuple_environment — Read one or more environment variables.
Signature
Herror tuple_environment(const char* Names, char* Values)
Herror T_tuple_environment(const Htuple Names, Htuple* Values)
def tuple_environment(names: MaybeSequence[str]) -> Sequence[str]
def tuple_environment_s(names: MaybeSequence[str]) -> str
Description
tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmentTupleEnvironmenttuple_environment reads the content of all environment variables
that are referenced by their names in the input tuple NamesNamesNamesNamesnamesnames and
returns the content with the output tuple ValuesValuesValuesValuesvaluesvalues. 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 NamesNamesNamesNamesnamesnames that does not denote a valid environment
variable.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmentTupleEnvironmenttuple_environment,
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
NamesNamesNamesNamesnamesnames (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Tuple containing name(s) of the environment
variable(s).
ValuesValuesValuesValuesvaluesvalues (output_control) string(-array) → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Content of the environment variable(s).
Alternatives
tuple_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstrtuple_strstr,
tuple_strrstrtuple_strrstrTupleStrrstrTupleStrrstrTupleStrrstrtuple_strrstr,
tuple_strchrtuple_strchrTupleStrchrTupleStrchrTupleStrchrtuple_strchr,
tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrTupleStrrchrtuple_strrchr,
tuple_strlentuple_strlenTupleStrlenTupleStrlenTupleStrlentuple_strlen,
tuple_str_first_ntuple_str_first_nTupleStrFirstNTupleStrFirstNTupleStrFirstNtuple_str_first_n,
tuple_str_last_ntuple_str_last_nTupleStrLastNTupleStrLastNTupleStrLastNtuple_str_last_n,
tuple_splittuple_splitTupleSplitTupleSplitTupleSplittuple_split,
tuple_substrtuple_substrTupleSubstrTupleSubstrTupleSubstrtuple_substr
Module
Foundation