| 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 pathos library provides common operations for manipulating file paths: | 3 The pathos library 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. |
| (...skipping 198 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 209 // URL | 209 // URL |
| 210 path.relative('http://dartlang.org', from: 'http://pub.dartlang.org'); | 210 path.relative('http://dartlang.org', from: 'http://pub.dartlang.org'); |
| 211 // -> 'http://dartlang.org' | 211 // -> 'http://dartlang.org' |
| 212 | 212 |
| 213 ### String withoutExtension(String path) | 213 ### String withoutExtension(String path) |
| 214 | 214 |
| 215 Removes a trailing extension from the last part of [path]. | 215 Removes a trailing extension from the last part of [path]. |
| 216 | 216 |
| 217 withoutExtension('path/to/foo.dart'); // -> 'path/to/foo' | 217 withoutExtension('path/to/foo.dart'); // -> 'path/to/foo' |
| 218 | 218 |
| 219 ### String fromUri(Uri uri) |
| 220 |
| 221 Returns the path represented by [uri]. For POSIX and Windows styles, [uri] must |
| 222 be a `file:` URI. For the URL style, this will just convert [uri] to a string. |
| 223 |
| 224 // POSIX |
| 225 path.fromUri(Uri.parse('file:///path/to/foo')) |
| 226 // -> '/path/to/foo' |
| 227 |
| 228 // Windows |
| 229 path.fromUri(Uri.parse('file:///C:/path/to/foo')) |
| 230 // -> r'C:\path\to\foo' |
| 231 |
| 232 // URL |
| 233 path.fromUri(Uri.parse('http://dartlang.org/path/to/foo')) |
| 234 // -> 'http://dartlang.org/path/to/foo' |
| 235 |
| 236 ### Uri toUri(String path) |
| 237 |
| 238 Returns the URI that represents [path]. For POSIX and Windows styles, this will |
| 239 return a `file:` URI. For the URL style, this will just convert [path] to a |
| 240 [Uri]. |
| 241 |
| 242 This will always convert relative paths to absolute ones before converting |
| 243 to a URI. |
| 244 |
| 245 // POSIX |
| 246 path.toUri('/path/to/foo') |
| 247 // -> Uri.parse('file:///path/to/foo') |
| 248 |
| 249 // Windows |
| 250 path.toUri(r'C:\path\to\foo') |
| 251 // -> Uri.parse('file:///C:/path/to/foo') |
| 252 |
| 253 // URL |
| 254 path.toUri('http://dartlang.org/path/to/foo') |
| 255 // -> Uri.parse('http://dartlang.org/path/to/foo') |
| 256 |
| 219 ## The path.Builder class | 257 ## The path.Builder class |
| 220 | 258 |
| 221 In addition to the functions, path exposes a `path.Builder` class. This lets | 259 In addition to the functions, path exposes a `path.Builder` class. This lets |
| 222 you configure the root directory and path style that paths are built using | 260 you configure the root directory and path style that paths are built using |
| 223 explicitly instead of assuming the current working directory and host OS's path | 261 explicitly instead of assuming the current working directory and host OS's path |
| 224 style. | 262 style. |
| 225 | 263 |
| 226 You won't often use this, but it can be useful if you do a lot of path | 264 You won't often use this, but it can be useful if you do a lot of path |
| 227 manipulation relative to some root directory. | 265 manipulation relative to some root directory. |
| 228 | 266 |
| (...skipping 117 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 346 * It can accurately tell if a path is absolute based on drive-letters or UNC | 384 * It can accurately tell if a path is absolute based on drive-letters or UNC |
| 347 prefix. | 385 prefix. |
| 348 | 386 |
| 349 * It understands that "/foo" is not an absolute path on Windows. | 387 * It understands that "/foo" is not an absolute path on Windows. |
| 350 | 388 |
| 351 * It knows that "C:\foo\one.txt" and "c:/foo\two.txt" are two files in the | 389 * It knows that "C:\foo\one.txt" and "c:/foo\two.txt" are two files in the |
| 352 same directory. | 390 same directory. |
| 353 | 391 |
| 354 If you find a problem, surprise or something that's unclear, please don't | 392 If you find a problem, surprise or something that's unclear, please don't |
| 355 hesitate to [file a bug](http://dartbug.com/new) and let us know. | 393 hesitate to [file a bug](http://dartbug.com/new) and let us know. |
| OLD | NEW |