| OLD | NEW |
| 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 part of dart.core; | 5 part of dart.core; |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * The reserved words [:true:] and [:false:] denote objects that are the only | 8 * The reserved words [:true:] and [:false:] denote objects that are the only |
| 9 * instances of this class. | 9 * instances of this class. |
| 10 * | 10 * |
| 11 * It is a compile-time error for a class to attempt to extend or implement | 11 * It is a compile-time error for a class to attempt to extend or implement |
| 12 * bool. | 12 * bool. |
| 13 */ | 13 */ |
| 14 class bool { | 14 class bool { |
| 15 /** | 15 /** |
| 16 * Returns the boolean value of the environment declaration [name]. | 16 * Returns the boolean value of the environment declaration [name]. |
| 17 * | 17 * |
| 18 * The boolean value of the declaration is `true` if the declared value is | 18 * The boolean value of the declaration is `true` if the declared value is |
| 19 * the string `"true"`. Otherwise it is false. | 19 * the string `"true"`, and `false` if the value is `"false"`. |
| 20 * | 20 * |
| 21 * If `name` is not declared, the result is instead [defaultValue]. | 21 * In all other cases, including when there is no declaration for `name`, |
| 22 * | 22 * the result is the [defaultValue]. |
| 23 * This constructor is equivalent to: | |
| 24 * | |
| 25 * const String.fromEnvironment(name, | |
| 26 * defaultValue: "$defaultValue") == "true" | |
| 27 * | 23 * |
| 28 * Example: | 24 * Example: |
| 29 * | 25 * |
| 30 * const loggingFlag = const bool.fromEnvironment("logging"); | 26 * const loggingFlag = const bool.fromEnvironment("logging"); |
| 31 * | 27 * |
| 32 * If you want to use a different truth-string, you can use the | 28 * If you want to use a different truth-string, you can use the |
| 33 * [String.fromEnvironment] constructor directly: | 29 * [String.fromEnvironment] constructor directly: |
| 34 * | 30 * |
| 35 * const isLoggingOn = (const String.fromEnvironment("logging") == "on"); | 31 * const isLoggingOn = (const String.fromEnvironment("logging") == "on"); |
| 36 */ | 32 */ |
| 37 external const factory bool.fromEnvironment(String name, | 33 external const factory bool.fromEnvironment(String name, |
| 38 {bool defaultValue: false}); | 34 {bool defaultValue: false}); |
| 39 | 35 |
| 40 /** | 36 /** |
| 41 * Returns [:"true":] if the receiver is [:true:], or [:"false":] if the | 37 * Returns [:"true":] if the receiver is [:true:], or [:"false":] if the |
| 42 * receiver is [:false:]. | 38 * receiver is [:false:]. |
| 43 */ | 39 */ |
| 44 String toString() { | 40 String toString() { |
| 45 return this ? "true" : "false"; | 41 return this ? "true" : "false"; |
| 46 } | 42 } |
| 47 } | 43 } |
| OLD | NEW |