fn: rmv
[contents]

Contents

Syntax

The syntax for rmv calls is:

f++:  
rmv(params)
rmv params

n++:  
@rmv(params)
@rmv params

Description

rmv is the remove function, it removes the files and/or directories specified by the parameters.

Note: Paths can be unoquoted, single quoted or double quoted.

Note: You should also be able to use the remove function for the underlying shell as well, typically del on Windows and rm and rmdir on other platforms like FreeBSD, Linux, OSX, etc..

Note: Nift will skip to the first non-whitespace (ie. to the first character that is not a space, tab or newline) after a rmv call and inject it to the output file where the call started. If you want to prevent Nift from doing this put a '!' after the call, eg.:

@rmv file.txt;!
@rmv(dir)!

Options

The following options are available for rmv calls:

option description
f ensures files have write permission before trying to remove them
i prompt when moving files
v output which files are being moved and where (verbose)
option description

f++ example

Examples of rmv being used with f++:

rmv("sample.txt")
rmv dir1 dir2 dir3
rmv *.txt

n++ example

Example of rmv being used with n++:

@rmv("sample.txt")
@rmv dir1 dir2 dir3
@rmv *.txt