NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
unsigned int ResolveHandle ( string  filename,
byte &  handle,
bool &  writable 
)
inline

Resolve a handle.

Resolve a file handle from the specified filename. The file handle is returned in the second parameter, which must be a variable. A boolean value indicating whether the handle can be used to write to the file or not is returned in the last parameter, which must be a variable. The loader result code is returned as the value of the function call. The filename parameter must be a constant or a variable.

Parameters
filenameThe name of the file for which to resolve a handle.
handleThe file handle output from the function call.
writableA boolean flag indicating whether the handle is to a file open for writing (true) or reading (false).
Returns
The function call result. See Loader module error codes.
Examples:
ex_ResolveHandle.nxc.