Project

General

Profile

Write » History » Revision 9

Revision 8 (Per Amundsen, 08/13/2015 10:26 AM) → Revision 9/15 (Per Amundsen, 05/24/2018 10:15 AM)

_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 <[[Scripting_Wildcards|wildcard]]> <wildcard> pattern. 
 -r - same as -w - but uses a [[Scripting_Regex|regular expression]] match. 

 *Parameters* 

 &lt;line&gt; - The line number to find. 
 &lt;text&gt; - The text to scan. 
 &lt;wildcard&gt; - [[Scripting_Wildcards|Wildcard]] Wildcard pattern to match. 
 &lt;/regex/&gt; - Regex 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>