Actions
Added in 1.9.0
/write [-cidnaiNmN l<line> s<text> w<wildcard> r</regex/>] <filename> [text]
Writes lines to a text file.
Switches
| Switch | Description | 
| -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. | 
| -lN | Line number for the line to write/modify/delete. | 
| -sN | Operates on a line that matches the scanned <text>. | 
| -wN | Operates on a line that matches the scanned <wildcard> pattern. | 
| -r | same as -w - but uses a regular expression match. | 
| -mN | changes how $crlf are written to the end of a file, where N = 0 is the default behavior, N = 1 adds $crlf to end of file if it is not already there before writing a line, and N = 2 never adds $crlf to end of file before writing a line. | 
Parameters
| Parameter | Description | 
| <line> | The line number to find. | 
| <text> | The text to scan. | 
| <wildcard> | Wildcard pattern to match. | 
| </regex/> | Regular expression 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
}
Updated by Per Amundsen over 2 years ago · 15 revisions