String.fromEnvironment 构造函数

const String.fromEnvironment(
  1. String name, {
  2. String defaultValue = "",
})

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

编译配置环境由编译或运行 Dart 程序的周围工具提供。环境是从一组字符串键到其关联的字符串值的映射。与 name 相关的字符串值或没有值,必须在单个程序中对 String.fromEnvironmentint.fromEnvironmentbool.fromEnvironmentbool.hasEnvironment 的所有调用中保持一致。

调用此构造函数的结果是与键 name 关联的字符串。如果没有与 name 关联的值,则结果将替换为 defaultValue 字符串,默认为空字符串。

查找值的示例

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

为了检查是否存在该值,请使用 bool.hasEnvironment。示例

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

name 相关的字符串值或没有值,必须在单个程序中对 String.fromEnvironmentint.fromEnvironmentbool.fromEnvironmentbool.hasEnvironment 的所有调用中保持一致。

此构造函数仅保证在作为 const 调用时工作。在某些平台(这些平台可以在运行时访问编译器选项)上,它可能作为非常量调用工作,但大多数先期编译的平台将没有此信息。

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

实现

external const factory String.fromEnvironment(String name,
    {String defaultValue = ""});