From Multi Theft Auto: Wiki
Revision as of 07:40, 30 January 2014 by The GTA (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This function returns a list of all files that are found under the wild-card and directory parameters. It is similar to scanDir but returns files only.


table translator.getFiles ( string dirPath, string wildcard, bool recursive )


  • dirPath: a path to the directory the scan shall take place or start in
  • wildcard: glob-style wild-card for filename matching; every filename that matches the wild-card is returned
  • recursive: a boolean that specifies whether the whole directory tree at dirPath should be included into the scan


This function returns a table of all matching file entries for the performed scan. It returns false if dirPath is not a valid directory target for the translator.


Click to collapse [-]

This snippet is yet another alternative to output the count of directories and files in a folder.

-- Get a handle to the resource instance directory.
local resRoot = fileCreateTranslator( "/" );

local function getFilesystemObjectCounts( path )
    local fileCount = 0;
    local dirCount = 0;

    -- Query the counts.
    fileCount = #getFiles( path, "*", false );
    dirCount = #getDirs( path, false );

    -- Return the counts.
    return fileCount, dirCount;

-- Output the filesystem object counts for the resource instance root.
local fileCount, dirCount = getFilesystemObjectCounts( "/" );

outputChatBox( "found " .. fileCount .. " files and " .. dirCount .. " directories in the resource folder root." );

FileSystem Translator Functions