Project

General

Profile

Write » History » Revision 13

Revision 12 (Per Amundsen, 12/30/2019 05:34 PM) → Revision 13/15 (Per Amundsen, 12/30/2019 05:35 PM)

_Added in 1.9.0_ 

 */write [-cidnaiNmN 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. 
 -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 <[[Scripting_Wildcards|wildcard]]> pattern. 
 -r - same as -w - but uses a [[Scripting_Regex|regular expression]] match. 
 -mN - *TODO* 

 *Parameters* 

 &lt;line&gt; - The line number to find. 
 &lt;text&gt; - The text to scan. 
 &lt;wildcard&gt; - [[Scripting_Wildcards|Wildcard]] pattern to match. 
 &lt;/regex/&gt; - [[Scripting_Regex|Regular [[Scripting_Regex|regular expression]] pattern to match. 
 &lt;filename&gt; - The file name to manipulate. 
 [text] - The text to be written to the file. 

 *Example* 

 <pre> 
 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 
 } 
 </pre>