# stat method

Future<FileStat> stat (String path)

Asynchronously calls the operating system's stat() function on `path`.

Returns a Future which completes with a FileStat object containing the data returned by stat(). If the call fails, completes the future with a FileStat object with `.type` set to FileSystemEntityType.notFound and the other fields invalid.

## Implementation

    static Future<FileStat> stat(String path) {
      final IOOverrides overrides = IOOverrides.current;
      if (overrides == null) {
        return _stat(path);
      }
      return overrides.stat(path);
    }