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
在本地平台上访问。
实现
external const factory String.fromEnvironment(String name,
{String defaultValue = ""});