An interface used by the tensorflow implementation to access operating system functionality like the filesystem etc.
Callers may wish to provide a custom Env object to get fine grain control.
All Env implementations are safe for concurrent access from multiple threads without any external synchronization.
tensorflow::Env::Env()virtual tensorflow::Env::~Env()virtual Status tensorflow::Env::NewRandomAccessFile(const string &fname, RandomAccessFile **result)=0- Creates a brand new random access read-only file with the specified name.
virtual Status tensorflow::Env::NewWritableFile(const string &fname, WritableFile **result)=0- Creates an object that writes to a new file with the specified name.
virtual Status tensorflow::Env::NewAppendableFile(const string &fname, WritableFile **result)=0- Creates an object that either appends to an existing file, or writes to a new file (if the file does not exist to begin with).
virtual bool tensorflow::Env::FileExists(const string &fname)=0- Returns true iff the named file exists.
virtual Status tensorflow::Env::GetChildren(const string &dir, std::vector< string > *result)=0- Stores in *result the names of the children of the specified directory. The names are relative to "dir".
virtual Status tensorflow::Env::DeleteFile(const string &fname)=0- Deletes the named file.
virtual Status tensorflow::Env::CreateDir(const string &dirname)=0- Creates the specified directory.
virtual Status tensorflow::Env::DeleteDir(const string &dirname)=0- Deletes the specified directory.
virtual Status tensorflow::Env::GetFileSize(const string &fname, uint64 *file_size)=0- Stores the size of fname in *file_size.
virtual Status tensorflow::Env::RenameFile(const string &src, const string &target)=0- Renames file src to target. If target already exists, it will be replaced.
virtual uint64 tensorflow::Env::NowMicros()=0- Returns the number of micro-seconds since some fixed point in time. Only useful for computing deltas of time.
virtual void tensorflow::Env::SleepForMicroseconds(int micros)=0- Sleeps/delays the thread for the prescribed number of micro-seconds.
virtual Thread* tensorflow::Env::StartThread(const ThreadOptions &thread_options, const string &name, std::function< void()> fn) TF_MUST_USE_RESULT=0- Returns a new thread that is running fn() and is identified (for debugging/performance-analysis) by "name".
static Env* tensorflow::Env::Default()- Returns a default environment suitable for the current operating system.
virtual Status tensorflow::Env::NewRandomAccessFile(const string &fname, RandomAccessFile **result)=0
Creates a brand new random access read-only file with the specified name.
On success, stores a pointer to the new file in *result and returns OK. On failure stores NULL in *result and returns non-OK. If the file does not exist, returns a non-OK status.
The returned file may be concurrently accessed by multiple threads.
Creates an object that writes to a new file with the specified name.
Deletes any existing file with the same name and creates a new file. On success, stores a pointer to the new file in *result and returns OK. On failure stores NULL in *result and returns non-OK.
The returned file will only be accessed by one thread at a time.
Creates an object that either appends to an existing file, or writes to a new file (if the file does not exist to begin with).
On success, stores a pointer to the new file in *result and returns OK. On failure stores NULL in *result and returns non-OK.
The returned file will only be accessed by one thread at a time.
Returns true iff the named file exists.
Stores in *result the names of the children of the specified directory. The names are relative to "dir".
Original contents of *results are dropped.
Deletes the named file.
Creates the specified directory.
Deletes the specified directory.
Stores the size of fname in *file_size.
Renames file src to target. If target already exists, it will be replaced.
Returns the number of micro-seconds since some fixed point in time. Only useful for computing deltas of time.
Sleeps/delays the thread for the prescribed number of micro-seconds.
virtual Thread* tensorflow::Env::StartThread(const ThreadOptions &thread_options, const string &name, std::function< void()> fn) TF_MUST_USE_RESULT=0
Returns a new thread that is running fn() and is identified (for debugging/performance-analysis) by "name".
Caller takes ownership of the result and must delete it eventually (the deletion will block until fn() stops running).
Returns a default environment suitable for the current operating system.
Sophisticated users may wish to provide their own Env implementation instead of relying on this default environment.
The result of Default() belongs to this library and must never be deleted.