Modding Tools > Lucas' Simpsons Hit & Run Mod Launcher > Hacks > Mod Requirable Hacks > Custom Files > Custom Lua Functions > General Functions > DirectoryGetEntries

DirectoryGetEntries

Calls a callback function for every file and sub-directory in the given path.

The order of these files is not predictable and should not be relied upon.

Syntax

DirectoryGetEntries( <path>, <callback>, [<end_to_start>] )
  • path: The directory to iterate.
  • callback: The callback that will be called for each item in the directory.
    • This callback is given the two arguments:
      • FileOrDirectory: The file or directory name.
      • IsDirectory: Whether or not the entry is a directory.
    • This callback must return true for the loop to continue.
  • end_to_start: Makes the function iterate the directory in reverse order.
    • Optional, defaults to false.

Examples

-- Print each file and whether or not it's a directory.
DirectoryGetEntries(Path, function(FileOrDirectory, IsDirectory)
    print(FileOrDirectory, IsDirectory)

    return true
end)

Notes

No additional notes.

Version History

1.23.10

Fixed a bug where calling DirectoryGetEntries on / yielded no results (when not using the -legacyfilesystem command line argument).

1.18

Added a third argument that specifies whether or not to return the list of files and folders in reverse order.

Unknown Version

Added this function.

Donut Team © 2023 · v4.0