Default constructor for creating an is_null() FileRef object.

A constructor used when you have an existing PP_Resource for a FileRef and which to create a C++ object that takes an additional reference to the resource.

Parameters:

[in]

resource

A PP_Resource corresponding to file reference.

A constructor used when you have received a PP_Resource as a return value that has already been reference counted.

Parameters:

[in]

resource

A PP_Resource corresponding to file reference.

A constructor that creates a weak pointer to a file in the given file system.

File paths are POSIX style.

If the path is malformed, the resulting FileRef will have a null PP_Resource.

Parameters:

[in]	file_system	A FileSystem corresponding to a file system type.
[in]	path	A path to the file. Must begin with a '/' character.

The copy constructor for FileRef.

Parameters:

[in]

other

A pointer to a FileRef.

Delete() deletes a file or directory.

If file_ref refers to a directory, then the directory must be empty. It is an error to delete a file or directory that is in use. It is not valid to delete a file in the external file system.

Parameters:

[in]

cc

A CompletionCallback to be called upon completion of Delete().

Returns:

An int32_t containing an error code from pp_errors.h.

GetFileSystemType() returns the type of the file system.

Returns:

A PP_FileSystemType with the file system type if valid or PP_FILESYSTEMTYPE_INVALID if the provided resource is not a valid file reference.

GetName() returns the name of the file.

Returns:

A Var containing the name of the file. The value returned by this function does not include any path components (such as the name of the parent directory, for example). It is just the name of the file. Use GetPath() to get the full file path.

GetParent() returns the parent directory of this file.

If file_ref points to the root of the filesystem, then the root is returned.

Returns:

A FileRef containing the parent directory of the file. This function fails if the file system type is PP_FileSystemType_External.

GetPath() returns the absolute path of the file.

Returns:

A Var containing the absolute path of the file. This function fails if the file system type is PP_FileSystemType_External.

MakeDirectory() makes a new directory in the file system according to the given make_directory_flags, which is a bit-mask of the PP_MakeDirectoryFlags values.

It is not valid to make a directory in the external file system.

Parameters:

[in]	make_directory_flags	A bit-mask of the PP_MakeDirectoryFlags values. See ppb_file_ref.h for more details.
[in]	cc	A CompletionCallback to be called upon completion of MakeDirectory().

Returns:

An int32_t containing an error code from pp_errors.h.

Query() queries info about a file or directory.

You must have access to read this file or directory if it exists in the external filesystem.

Parameters:

[in]

callback

A CompletionCallbackWithOutput to be called upon completion of Query().

Returns:

An int32_t containing an error code from pp_errors.h.

ReadDirectoryEntries() Reads all entries in the directory.

Parameters:

[in]

cc

A CompletionCallbackWithOutput to be called upon completion of ReadDirectoryEntries(). On success, the directory entries will be passed to the given function.

Normally you would use a CompletionCallbackFactory to allow callbacks to be bound to your class. See completion_callback_factory.h for more discussion on how to use this. Your callback will generally look like:

   void OnReadDirectoryEntries(
       int32_t result,
       const std::vector<DirectoryEntry>& entries) {
     if (result == PP_OK)
       // use entries...
   }

Returns:

An int32_t containing an error code from pp_errors.h.

Rename() renames a file or directory.

Argument new_file_ref must refer to files in the same file system as in this object. It is an error to rename a file or directory that is in use. It is not valid to rename a file in the external file system.

Parameters:

[in]	new_file_ref	A FileRef corresponding to a new file reference.
[in]	cc	A CompletionCallback to be called upon completion of Rename().

Returns:

An int32_t containing an error code from pp_errors.h.

Touch() Updates time stamps for a file.

You must have write access to the file if it exists in the external filesystem.

Parameters:

[in]	last_access_time	The last time the file was accessed.
[in]	last_modified_time	The last time the file was modified.
[in]	cc	A CompletionCallback to be called upon completion of Touch().

Returns:

An int32_t containing an error code from pp_errors.h.