DLM File

File Open

dlm_FileOpen()

Opens a DLM file for reading or writing.

Syntax
#include "dlmfile.h"

DlmResult dlm_FileOpen
    (
        DlmFileName  fileName,
        DlmFileMode  fileMode,
        DlmFileId *  id
    );
fileName name of file to open
fileMode dlm_FILE_MODE_READ or dlm_FILE_MODE_WRITE
id output for open file id (to be used in read and write functions)
Description

dlm_FileOpen() opens a DLM file for reading or writing.

Return Values

If successful, dlm_FileOpen() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

See Also

dlm_FileClose()
dlm_FileRead()
dlm_FileWrite()

Example
if ((result = dlm_FileOpen(fileName, dlm_FILE_MODE_WRITE, &id)) < 0)
{
    printf("Error: Failure opening file for writing: %s.\n", dlm_ErrorMessage(result));
}
else
{
    /* do something */

    if ((result = dlm_FileClose(id) < 0)
    {
        printf("Error: Failure closing file: %s.\n", dlm_ErrorMessage(result));
    }
    else
    {
        printf("File closed.\n");
    }
}