Project

General

Profile

Added in 1.9.0

/write [-cidna l<line> s<text> w<wildcard> r</regex/>] <filename> [text]

Writes lines to a text file.

Switches

-c - Clears the entire file before writing to it.
-i - Inserts the text at a given line instead of replacing it.
-d - Deletes the given or last line.
-n - Prevent adding $crlf at the end of the text.
-a - Appends the text to an existing line.
-l - Line number for the line to write/modify/delete.
-s - Operates on a line that matches the scanned <text>.
-w - Operates on a line that matches the scanned <wildcard> pattern.
-r - same as -w - but uses a regular expression match.

Parameters

<line> - The line number to find.
<text> - The text to scan.
<wildcard> - Wildcard pattern to match.
</regex/> - Regex pattern to match.
<filename> - The file name to manipulate.
[text] - The text to be written to the file.

Example

alias example {
  ; Create a file and add a few lines of text to it.
  /write Example.txt this is a cool line
  /write Example.txt hello there!
  /write Example.txt text files are cool

  ; Locate the line that starts with "hello" and insert the following text before it.
  /write -is"Hello" Example.txt This will become line 2!

  ; Delete line 1.
  /write -dl1 Example.txt
}

Also available in: PDF HTML TXT