method

resolveSymbolicLinksSync

Source

/**
 * Resolves the path of a file system object relative to the
 * current working directory, resolving all symbolic links on
 * the path and resolving all `..` and `.` path segments.
 *
 * [resolveSymbolicLinksSync] uses the operating system's native
 * file system API to resolve the path, using the `realpath` function
 * on linux and OS X, and the `GetFinalPathNameByHandle` function on
 * Windows. If the path does not point to an existing file system object,
 * `resolveSymbolicLinksSync` throws a `FileSystemException`.
 *
 * On Windows the `..` segments are resolved _before_ resolving the symbolic
 * link, and on other platforms the symbolic links are _resolved to their
 * target_ before applying a `..` that follows.
 *
 * To ensure the same behavior on all platforms resolve `..` segments before
 * calling `resolveSymbolicLinksSync`. One way of doing this is with the `Uri`
 * class:
 *
 *     var path = Uri.parse('.').resolveUri(new Uri.file(input)).toFilePath();
 *     if (path == '') path = '.';
 *     var resolved = new File(path).resolveSymbolicLinksSync();
 *     print(resolved);
 *
 * since `Uri.resolve` removes `..` segments. This will result in the Windows
 * behavior.
 */
String resolveSymbolicLinksSync() {
  var result = _resolveSymbolicLinks(path);
  _throwIfError(result, "Cannot resolve symbolic links", path);
  return result;
}