Removes a file or empty directory.
== Function ==
=== Synopsis ===
<source lang="lua">
success = love.filesystem.remove( name )
</source>
=== Arguments ===
{{param|string|name|The file or directory to remove.}}
=== Returns ===
{{param|boolean|success|True if the file/directory was removed, false otherwise.}}
== Notes ==
The directory must be empty before removal or else it will fail. Simply remove all files and folders in the directory beforehand.

If the file exists in the .love but not in the save directory, it returns <code>false</code> as well.

An opened [[File]] prevents removal of the underlying file. Simply close the [[File]] to remove it.

== Examples ==
Create a bunch of folders in the save folder and remove them and any file they may contain as soon as the game is quit.
<source lang="lua">
function love.load()
    local dir = 'a'
    for _ = 1, 10 do
        dir = dir .. '/a'
    end
    love.filesystem.createDirectory( dir )
end

function love.quit()
    local function recursivelyDelete( item )
        if love.filesystem.getInfo( item , "directory" ) then
            for _, child in pairs( love.filesystem.getDirectoryItems( item )) do
                recursivelyDelete( item .. '/' .. child )
                love.filesystem.remove( item .. '/' .. child )
            end
        elseif love.filesystem.getInfo( item ) then
            love.filesystem.remove( item )
        end
        love.filesystem.remove( item )
    end
    recursivelyDelete( 'a' )
end
</source>

== See Also ==
* [[parent::love.filesystem]]
[[Category:Functions]]
{{#set:Description=Removes a file (or directory).}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.filesystem.remove}}