Merge pull request #1421 from MitrahSoft/Added_a_example_06/03/2024

Added a example for FileIsEOF() function

docs/03.reference/01.functions/fileiseof/_examples.md

@@ -1 +1,16 @@
-*There are currently no examples for this function.*
+```luceescript
+filePath = "/path/to/file.txt"
+openFile = fileopen(filePath, "read");
+lines = [];
+// IMPORTANT: must close file, use try/catch/finally to do so
+try {
+	// fileIsEOF(openFile) == false until we've read in the last line.
+	while( !fileIsEoF(openFile) ) {
+		arrayAppend(lines, fileReadLine( openFile ));
+	}
+} catch(any e) {
+	rethrow;
+} finally {
+	fileClose(openFile);
+}
+```