NAME

DtEditorInsertFromFile − insert data from a file into a DtEditor widget

SYNOPSIS

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

DESCRIPTION

The DtEditorInsertFromFile() function inserts data from a file at the insertion cursor in a DtEditor widget. After the data is inserted, the insertion cursor is positioned after the last character inserted.

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 competion, the DtEditorInsertFromFile() 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 it cannot insert the data into the DtEditor widget, the function returns one of the following values:

DtEDITOR_NONEXISTANT_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 DtEditorInsert(3). 

SEE ALSO

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

  —  30 July 1994