NSFileSystem¶

Checks if an item (file or folder) exists on the file system.

virtual bool Amplitude::NSFileSystem::Exists (
    const AmOsString & path
) override const

Parameters:

• path The path to the item.

Returns:

true if the file exists, false otherwise.

Implements SparkyStudios::Audio::Amplitude::FileSystem::Exists

Returns the base path of the file system.

virtual const AmOsString & Amplitude::NSFileSystem::GetBasePath () override const

Returns:

The base path for resolving relative paths from which the engine will load resources.

Implements SparkyStudios::Audio::Amplitude::FileSystem::GetBasePath

Checks if an item (file or folder) is a directory.

virtual bool Amplitude::NSFileSystem::IsDirectory (
    const AmOsString & path
) override const

Parameters:

• path The path to the item.

Returns:

true if the file is a directory, false otherwise.

Implements SparkyStudios::Audio::Amplitude::FileSystem::IsDirectory

Merge the given parts of the path into a single path by joining them with the file system's path separator.

virtual AmOsString Amplitude::NSFileSystem::Join (
    const std::vector< AmOsString > & parts
) override const

Parameters:

• parts The parts of the path.

Returns:

A path concatenated with the given parts and the file system path separator.

Implements SparkyStudios::Audio::Amplitude::FileSystem::Join

Constructs a new NSFileSystem instance.

Amplitude::NSFileSystem::NSFileSystem () 

Opens the file at the given path.

virtual std::shared_ptr< File > Amplitude::NSFileSystem::OpenFile (
    const AmOsString & path,
    eFileOpenMode mode=eFileOpenMode_Read
) override const

Parameters:

• path The path to the file to open.
• mode The file open mode.

Returns:

The opened file. The returned File implementation depends on the FileSystem implementation.

Implements SparkyStudios::Audio::Amplitude::FileSystem::OpenFile

Resolves a relative path from the file system base path.

virtual AmOsString Amplitude::NSFileSystem::ResolvePath (
    const AmOsString & path
) override const

Returns:

The resolved path.

Implements SparkyStudios::Audio::Amplitude::FileSystem::ResolvePath

Changes the file system base path.

virtual void Amplitude::NSFileSystem::SetBasePath (
    const AmOsString & basePath
) override

That path is interpreted by the implementation and doesn't necessarily have to be a real path on disk. It's just used as the base path for resolving relative paths from which the engine will load resources.

Parameters:

• basePath The file system base path.

Implements SparkyStudios::Audio::Amplitude::FileSystem::SetBasePath

Stops the FileSystem .

virtual void Amplitude::NSFileSystem::StartCloseFileSystem () override

This function MUST be called when the FileSystem is no longer needed. It is used to stop the file system (e.g.: unmounting an archive).

Note:

• For implementations, it is recommended to process the stopping in a separate thread.
• The implementation is free to ignore this if not needed.

Implements SparkyStudios::Audio::Amplitude::FileSystem::StartCloseFileSystem

Opens the FileSystem .

virtual void Amplitude::NSFileSystem::StartOpenFileSystem () override

This function MUST be called before any other actions in the file system. It is used to initialize the file system (e.g.: mounting an archive).

Note:

• For implementations, It is recommended to process the initialization in a separate thread. *
• The implementation is free to ignore this if not needed.

Implements SparkyStudios::Audio::Amplitude::FileSystem::StartOpenFileSystem

Checks if the FileSystem is stopped.

virtual bool Amplitude::NSFileSystem::TryFinalizeCloseFileSystem () override

Since the StartCloseFileSystem() function is designed to be asynchronous, this function is used to check if the FileSystem has been successfully stopped.

Returns:

true if the FileSystem has been fully stopped, false otherwise.

Implements SparkyStudios::Audio::Amplitude::FileSystem::TryFinalizeCloseFileSystem

Checks if the FileSystem is loaded.

virtual bool Amplitude::NSFileSystem::TryFinalizeOpenFileSystem () override

Since the StartOpenFileSystem() function is designed to be asynchronous, this function is used to check if the FileSystem has been successfully initialized.

Returns:

true if the FileSystem has been fully loaded, false otherwise.

Implements SparkyStudios::Audio::Amplitude::FileSystem::TryFinalizeOpenFileSystem

Destroys the NSFileSystem instance.

Amplitude::NSFileSystem::~NSFileSystem () override