DTEDITORINSERTFROMFILE(3)

💅 DtEditorInsertFromFile 💅

okay so bestie, this is a library call page from the DtEditor friend group — the original header line is DtEditorInsertFromFile(library call), but we’re folding that manual-name vibe in right here so you don’t have to read it twice 🫶

✨ NAME ✨

DtEditorInsertFromFile — insert data from a file into a DtEditor widget. periodt.

---

🎀 SYNOPSIS 🎀

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

---

💖 DESCRIPTION 💖

So DtEditorInsertFromFile inserts data from a file into the insertion cursor position in a DtEditor widget. After the data is inserted, the insertion cursor is positioned after the last character inserted — yes, it parks itself right after the new text, iconic ✨

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 resources, see DtEditor(3). iykyk 💅

---

🔥 RETURN VALUE 🔥

Upon successful completion, DtEditorInsertFromFile returns one of these 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 removed. not me removing your NULLs 💀

Otherwise, if it cannot insert the data into the DtEditor widget, DtEditorInsertFromFile returns one of these 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). that’s the move, bestie 🫶

---

🦋 SEE ALSO 🦋

the whole little reference crew:

• Dt/Editor.h
• DtEditor(5)
• DtEditor(3)
• DtEditorAppend(3)
• DtEditorAppendFromFile(3)
• DtEditorGetContents(3)
• DtEditorInsert(3)
• DtEditorReplace(3)
• DtEditorReplaceFromFile(3)
• DtEditorSaveContentsToFile(3)
• DtEditorSetContents(3)
• DtEditorGetInsertionPosition(3)
• DtEditorSetInsertionPosition(3)
• DtEditorSetContentsFromFile(3)

---

okay that’s the whole page, bestie 💜 footer check: the source/version stamp is DtEditorInsertFromFile(library call), and there’s literally no date printed on this one — so I’m not inventing one, no cap. mwah 💋✨