NAME

DtEditorAppendFromFile − append data from a file into a DtEditor widget

SYNOPSIS

#include <Dt/Editor.h>
DtEditorErrorCode DtEditorAppendFromFile(Widget widget,
char ∗fileName);

DESCRIPTION

DtEditorAppendFromFile() function appends data from a file after the last character in a DtEditor widget. After the data is appended, the insertion cursor is positioned at the new last character.

The widget argument specifies the DtEditor widget ID. 

The fileName argument is the path and name of the file relative to the local system. 

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). 

RETURN VALUE

Upon successful completion, the DtEditorAppendFromFile() function returns one of the following values:

DtEDITOR_NO_ERRORS
the file is readable and writable

DtEDITOR_READ_ONLY_FILE
the file is read only;

otherwise, if the function cannot append the data into the DtEditor widget, it returns one of the following values:

DtEDITOR_NONEXISTENT_FILE
File does not exist

DtEDITOR_DIRECTORY
File is a directory

DtEDITOR_CHAR_SPECIAL_FILE
File is a character special device

DtEDITOR_BLOCK_MODE_FILE
File is a block mode device

DtEDITOR_UNREADABLE_FILE
File is unreadable for an unlisted reason

APPLICATION USAGE

If the data is in memory, rather than a disk file, the application should use DtEditorAppend(3). 

SEE ALSO

DtEditor(3), DtEditorAppend(3).  DtEditorGetContents(3), DtEditorInsert(3), DtEditorInsertFromFile(3), DtEditorReplace(3), DtEditorReplaceFromFile(3), DtEditorSaveContentsToFile(3), DtEditorSetContents(3), DtEditorSetContentsFromFile(3). 
 
 
 
 

  —  30 July 1994