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 /// Generic utility functions. Stuff that should possibly be in core. | 5 /// Generic utility functions. Stuff that should possibly be in core. |
6 library utils; | 6 library utils; |
7 | 7 |
8 import 'dart:async'; | 8 import 'dart:async'; |
9 import 'dart:crypto'; | 9 import 'dart:crypto'; |
10 import 'dart:isolate'; | 10 import 'dart:isolate'; |
(...skipping 127 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
138 return false; | 138 return false; |
139 } | 139 } |
140 | 140 |
141 /// Returns the hex-encoded sha1 hash of [source]. | 141 /// Returns the hex-encoded sha1 hash of [source]. |
142 String sha1(String source) { | 142 String sha1(String source) { |
143 var sha = new SHA1(); | 143 var sha = new SHA1(); |
144 sha.add(source.charCodes); | 144 sha.add(source.charCodes); |
145 return CryptoUtils.bytesToHex(sha.close()); | 145 return CryptoUtils.bytesToHex(sha.close()); |
146 } | 146 } |
147 | 147 |
| 148 /// Invokes the given callback asynchronously. Returns a [Future] that completes |
| 149 /// to the result of [callback]. |
| 150 /// |
| 151 /// This is also used to wrap synchronous code that may thrown an exception to |
| 152 /// ensure that methods that have both sync and async code only report errors |
| 153 /// asynchronously. |
| 154 Future defer(callback()) { |
| 155 return new Future.immediate(null).then((_) => callback()); |
| 156 } |
| 157 |
148 /// Returns a [Future] that completes in [milliseconds]. | 158 /// Returns a [Future] that completes in [milliseconds]. |
149 Future sleep(int milliseconds) { | 159 Future sleep(int milliseconds) { |
150 var completer = new Completer(); | 160 var completer = new Completer(); |
151 new Timer(milliseconds, (_) => completer.complete()); | 161 new Timer(milliseconds, (_) => completer.complete()); |
152 return completer.future; | 162 return completer.future; |
153 } | 163 } |
154 | 164 |
155 /// Configures [future] so that its result (success or exception) is passed on | 165 /// Configures [future] so that its result (success or exception) is passed on |
156 /// to [completer]. | 166 /// to [completer]. |
157 void chainToCompleter(Future future, Completer completer) { | 167 void chainToCompleter(Future future, Completer completer) { |
(...skipping 142 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
300 | 310 |
301 /// Add all key/value pairs from [source] to [destination], overwriting any | 311 /// Add all key/value pairs from [source] to [destination], overwriting any |
302 /// pre-existing values. | 312 /// pre-existing values. |
303 void mapAddAll(Map destination, Map source) => | 313 void mapAddAll(Map destination, Map source) => |
304 source.forEach((key, value) => destination[key] = value); | 314 source.forEach((key, value) => destination[key] = value); |
305 | 315 |
306 /// Decodes a URL-encoded string. Unlike [decodeUriComponent], this includes | 316 /// Decodes a URL-encoded string. Unlike [decodeUriComponent], this includes |
307 /// replacing `+` with ` `. | 317 /// replacing `+` with ` `. |
308 String urlDecode(String encoded) => | 318 String urlDecode(String encoded) => |
309 decodeUriComponent(encoded.replaceAll("+", " ")); | 319 decodeUriComponent(encoded.replaceAll("+", " ")); |
OLD | NEW |