Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DtEditorInsertFromFile(library call)	  DtEditorInsertFromFile(library call)

NAME
       DtEditorInsertFromFile  -- insert data from a file into a DtEditor wid-
       get

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

DESCRIPTION
       The DtEditorInsertFromFile function inserts data	from a file to the in-
       sertion	cursor	position  in a DtEditor	widget.	 After the data	is in-
       serted, the insertion cursor is positioned after	the last character in-
       serted.

       The widget argument specifies the DtEditor widget ID.

       The fileName argument is	the pathname of	the file relative to the local
       system.

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

RETURN VALUE
       Upon successful completion, 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.

       DtEDITOR_NULLS_REMOVED
		 The file contained embedded NULL characters, which  were  re-
		 moved.

       Otherwise, if it	cannot insert the data into the	DtEditor widget, DtEd-
       itorInsertFromFile returns one of the following values:

       DtEDITOR_NONEXISTENT_FILE
		 The file does not exist.

       DtEDITOR_DIRECTORY
		 The file is a directory.

       DtEDITOR_CHAR_SPECIAL_FILE
		 The file is a character-special device.

       DtEDITOR_BLOCK_MODE_FILE
		 The file is a block-mode device.

       DtEDITOR_NO_FILE_ACCESS
		 The file cannot be accessed.

       DtEDITOR_INSUFFICIENT_MEMORY
		 Not enough system memory is available to insert the file.

       DtEDITOR_UNREADABLE_FILE
		 The file is unreadable	for an unspecified reason.

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

SEE ALSO
       Dt/Editor.h  - DtEditor(5), DtEditor(3),	DtEditorAppend(3), DtEditorAp-
       pendFromFile(3),	DtEditorGetContents(3),	DtEditorInsert(3), DtEditorRe-
       place(3),   DtEditorReplaceFromFile(3),	DtEditorSaveContentsToFile(3),
       DtEditorSetContents(3),	   DtEditorGetInsertionPosition(3),	DtEdi-
       torSetInsertionPosition(3), DtEditorSetContentsFromFile(3).

					  DtEditorInsertFromFile(library call)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | APPLICATION USAGE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DtEditorInsertFromFile&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help