dart:core

Конструктор String.fromEnvironment

Строковое значение объявления среды name.

Объявления среды предоставляются окружающей системой, компилирующей или выполняющей программу Dart. Объявления сопоставляют строковый ключ со строковым значением.

Если name не объявлено в среде, результат вместо этого defaultValue.

Пример получения значения:

const String.fromEnvironment("defaultFloo", defaultValue: "no floo")

Чтобы проверить, существует ли объявление вообще, используйте bool.hasEnvironment. Пример:

const maybeDeclared = bool.hasEnvironment("maybeDeclared")
    ? String.fromEnvironment("maybeDeclared")
    : null;

Строковое значение или отсутствие значения, связанного с name должно быть согласованным при всех вызовах String.fromEnvironment, int.fromEnvironment, bool.fromEnvironment и bool.hasEnvironment в одной программе.

Гарантируется, что этот конструктор будет работать только при вызове const. Он может работать как вызов, не являющийся константой, на некоторых платформах, у которых есть доступ к параметрам компилятора во время выполнения, но большинство платформ с предварительной компиляцией не имеют этой информации.

Реализация

// The .fromEnvironment() constructors are special in that we do not want
// users to call them using "new". We prohibit that by giving them bodies
// that throw, even though const constructors are not allowed to have bodies.
// Disable those static errors.
//ignore: const_constructor_with_body
//ignore: const_factory
external const factory String.fromEnvironment(String name,
    {String defaultValue = ""});