From WikiChip
Difference between revisions of "mirc/commands/write"
< mirc‎ | commands

m (Bot: de-linking old mIRC menu)
(Example)
 
(6 intermediate revisions by 3 users not shown)
Line 15: Line 15:
 
* '''-w''' - Operates on a line which match the <wildcard> expression.
 
* '''-w''' - Operates on a line which match the <wildcard> expression.
 
* '''-r''' - same as -w - but uses a regular expression.
 
* '''-r''' - same as -w - but uses a regular expression.
 +
* '''-W''' - line read from a file is treated as the wildcard
 +
* '''-R''' - line read from a file is treated as the regex
 
* '''-mN''' - handle the $crlf addition before a line:
 
* '''-mN''' - handle the $crlf addition before a line:
 
   There is a difference in how /write behave vs /write -s or /write -w when it comes to adding a $crlf before your line, if mirc is going to add the line to end of the file and that the last line does not have a $crlf already.
 
   There is a difference in how /write behave vs /write -s or /write -w when it comes to adding a $crlf before your line, if mirc is going to add the line to end of the file and that the last line does not have a $crlf already.
Line 25: Line 27:
 
* '''<line>''' - The line number to find
 
* '''<line>''' - The line number to find
 
* '''<words>''' - The word to scan.
 
* '''<words>''' - The word to scan.
* '''<wildcard>''' - Wildcard pattern to match
+
* '''<wildcard>''' - {{mirc|wildcard|Wildcard}} pattern to match
 
* '''</regex/>''' - RegEx pattern to match
 
* '''</regex/>''' - RegEx pattern to match
  
 
== Example ==
 
== Example ==
<syntaxhighlight lang="mIRC">Alias Example {
+
<syntaxhighlight lang="mIRC">
 +
;Example of entering a command in the active window to write text to a file:
 +
/write file.txt New line with some text
 +
 
 +
;Example of using the command in the script code:
 +
alias example {
 
   ;Create a file; add a few lines of text to it
 
   ;Create a file; add a few lines of text to it
 
   write Example.txt this is a cool line
 
   write Example.txt this is a cool line
Line 35: Line 42:
 
   write Example.txt text files are cool
 
   write Example.txt text files are cool
  
   /*
+
   ;Locate the line that starts with "Hello" and insert the following text before it
    Locate the line that starts with "hello"  
 
    and insert the following text before it
 
  */
 
 
   write -is"Hello" Example.txt This will become line 2!  
 
   write -is"Hello" Example.txt This will become line 2!  
  

Latest revision as of 02:55, 15 August 2025

The /write command can be used to manipulate a text file in various ways. Used without switches mIRC will append the line to the end of the text file. If the file does not exist, mIRC will create it. If <words>, <wildcard>, or <regex> contains spaces, they must be enclosed by a pair of quotes.

Synopsis[edit]

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

Switches[edit]

  • -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 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 which start with <words>
  • -w - Operates on a line which match the <wildcard> expression.
  • -r - same as -w - but uses a regular expression.
  • -W - line read from a file is treated as the wildcard
  • -R - line read from a file is treated as the regex
  • -mN - handle the $crlf addition before a line:
  There is a difference in how /write behave vs /write -s or /write -w when it comes to adding a $crlf before your line, if mirc is going to add the line to end of the file and that the last line does not have a $crlf already.
  /write will always put the $crlf, whereas /write -ws won't. For compatibility and to allow you to control exactly when and if a $crlf is going to be added in this case:
  When N = 0, the current behavior is used, N = 1 means a $crlf is added only if a $crlf isn't always there, N = 2 means a $crlf is never added.

Parameters[edit]

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

Example[edit]

;Example of entering a command in the active window to write text to a file:
/write file.txt New line with some text
 
;Example of using the command in the script code:
alias example {
  ;Create a file; 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
}

Compatibility[edit]

Added: mIRC v3.8
Added on: 25 Nov 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See also[edit]

[Expand]
v · d · e mIRC commands list