String.fromEnvironment 构造函数

编译配置环境声明中 name 的值。

编译配置环境由周围编译或运行 Dart 程序的工具提供。环境是从一系列字符串键到它们相关联的字符串值的映射。与 name 关联的字符串值或不存在值必须在程序中所有对 String.fromEnvironment、int.fromEnvironment、bool.fromEnvironment 和 bool.hasEnvironment 的调用中保持一致。

调用此构造函数的结果是与键 name 关联的字符串。如果没有与 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 调用时才有保证。在某些可以在运行时访问编译选项的平台中，它可以作为一个非常量调用工作，但大多数提前编译的平台将没有这个信息。

编译配置环境不同于 POSIX 进程的环境变量。那些可以在使用从 dart:io 库中的 Platform.environment 在本地平台上访问。