OLD | NEW |
1 A comprehensive, cross-platform path manipulation library for Dart. | 1 A comprehensive, cross-platform path manipulation library for Dart. |
2 | 2 |
3 The path package provides common operations for manipulating file paths: | 3 The path package provides common operations for manipulating file paths: |
4 joining, splitting, normalizing, etc. | 4 joining, splitting, normalizing, etc. |
5 | 5 |
6 We've tried very hard to make this library do the "right" thing on whatever | 6 We've tried very hard to make this library do the "right" thing on whatever |
7 platform you run it on. When you use the top-level functions, it will assume the | 7 platform you run it on. When you use the top-level functions, it will assume the |
8 current platform's path style and work with that. If you want to specifically | 8 current platform's path style and work with that. If you want to specifically |
9 work with paths of a specific style, you can construct a `path.Builder` for that | 9 work with paths of a specific style, you can construct a `path.Builder` for that |
10 style. | 10 style. |
11 | 11 |
12 ## Using | 12 ## Using |
13 | 13 |
14 The path library was designed to be imported with a prefix, though you don't | 14 The path library was designed to be imported with a prefix, though you don't |
15 have to if you don't want to: | 15 have to if you don't want to: |
16 | 16 |
17 import 'package:path/path.dart' as path; // TODO(bob): ??? | 17 import 'package:path/path.dart' as path; |
18 | 18 |
19 ## Top-level functions | 19 ## Top-level functions |
20 | 20 |
21 The most common way to use the library is through the top-level functions. | 21 The most common way to use the library is through the top-level functions. |
22 These manipulate path strings based on your current working directory and the | 22 These manipulate path strings based on your current working directory and the |
23 path style (POSIX, Windows, or URLs) of the host platform. | 23 path style (POSIX, Windows, or URLs) of the host platform. |
24 | 24 |
25 ### String get current | 25 ### String get current |
26 | 26 |
27 Gets the path to the current working directory. In the browser, this means the | 27 Gets the path to the current working directory. In the browser, this means the |
(...skipping 369 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
397 * It can accurately tell if a path is absolute based on drive-letters or UNC | 397 * It can accurately tell if a path is absolute based on drive-letters or UNC |
398 prefix. | 398 prefix. |
399 | 399 |
400 * It understands that "/foo" is not an absolute path on Windows. | 400 * It understands that "/foo" is not an absolute path on Windows. |
401 | 401 |
402 * It knows that "C:\foo\one.txt" and "c:/foo\two.txt" are two files in the | 402 * It knows that "C:\foo\one.txt" and "c:/foo\two.txt" are two files in the |
403 same directory. | 403 same directory. |
404 | 404 |
405 If you find a problem, surprise or something that's unclear, please don't | 405 If you find a problem, surprise or something that's unclear, please don't |
406 hesitate to [file a bug](http://dartbug.com/new) and let us know. | 406 hesitate to [file a bug](http://dartbug.com/new) and let us know. |
OLD | NEW |