void appendRelativeNativePath ( ACString relativeFilePath )

Arguments:

relativeFilePath

void appendRelativePath ( AString relativeFilePath )

AppendRelative[Native]Path

Append a relative path to the current path of the nsILocalFile object.

Arguments:

relativeFilePath: relativeFilePath is a native relative path. For security reasons, this cannot contain .. or cannot start with a directory separator. For the |appendRelativeNativePath| method, the relativeFilePath must be in the native filesystem charset.

ACString getRelativeDescriptor ( nsILocalFile fromFile )

Returns a relative file path in an opaque, XP format. It is therefore not a native path.

The character set of the string returned from this function is undefined. DO NOT TRY TO INTERPRET IT AS HUMAN READABLE TEXT!

Arguments:

fromFile: the file from which the descriptor is relative. There is no defined result if this param is null.

void initWithFile ( nsILocalFile file )

Initialize this object with another file

Arguments:

file: the file this becomes equivalent to

void initWithNativePath ( ACString filePath )

Arguments:

filePath

void initWithPath ( AString filePath )

InitWith[Native]Path

This function will initialize the nsILocalFile object. Any internal state information will be reset.

NOTE: This function has a known bug on the macintosh and other OSes which do not represent file locations as paths. If you do use this function, be very aware of this problem!

Arguments:

filePath: A string which specifies a full file path to a location. Relative paths will be treated as an error (NS_ERROR_FILE_UNRECOGNIZED_PATH). For initWithNativePath, the filePath must be in the native filesystem charset.

void launch ( )

Ask the operating system to attempt to open the file. this really just simulates "double clicking" the file on your platform. This routine only works on platforms which support this functionality.

PRLibrary* load ( )

Return the result of PR_LoadLibrary on the file. The caller is responsible for calling PR_UnloadLibrary on the result.

FILE* openANSIFileDesc ( char* mode )

Return the result of fopen on the file. The caller is responsible for calling fclose on the result.

Arguments:

mode

PRFileDesc* openNSPRFileDesc ( PRInt32 flags , PRInt32 mode )

Return the result of PR_Open on the file. The caller is responsible for calling PR_Close on the result.

Arguments:

flags

mode

void reveal ( )

Ask the operating system to open the folder which contains this file or folder. This routine only works on platforms which support the ability to open a folder...

void setRelativeDescriptor ( nsILocalFile fromFile , ACString relativeDesc )

Initializes the file to the location relative to fromFile using a string returned by getRelativeDescriptor.

Arguments:

fromFile: the file to which the descriptor is relative

relativeDesc