From WikiChip
Difference between revisions of "mirc/commands/write"
m (Bot: Fixing links) |
m (Add new -WR switches for v7.78) |
||
(13 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{mirc title|/write Command}} | ||
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. | 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 == | == Synopsis == | ||
− | /write [- | + | /write [-cidnamN l<line> s<words> w<wildcard> r</regex/>] <filename> [text] |
== Switches == | == Switches == | ||
Line 11: | Line 12: | ||
* '''-a''' - Appends the text to an existing line | * '''-a''' - Appends the text to an existing line | ||
* '''-l''' - Line number for the line to write/modify/delete | * '''-l''' - Line number for the line to write/modify/delete | ||
− | * '''-s''' - Operates on a | + | * '''-s''' - Operates on a line which start with <words> |
− | * '''-w''' - Operates on a | + | * '''-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: | ||
+ | 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 == | == Parameters == | ||
Line 20: | 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 | ||
Line 41: | Line 48: | ||
== Compatibility == | == Compatibility == | ||
− | + | {{mIRC compatibility|3.8}} | |
− | |||
− | |||
− | |||
− | |||
== See also == | == See also == | ||
* [[List of commands - mIRC|List of commands]] | * [[List of commands - mIRC|List of commands]] | ||
* [[List of identifiers - mIRC|List of identifiers]] | * [[List of identifiers - mIRC|List of identifiers]] | ||
− | * | + | * {{mIRC|$read}} |
− | * | + | * {{mIRC|$readn}} |
− | * | + | * {{mIRC|$mircini}} |
− | * | + | * {{mIRC|$mircdir}} |
* {{mIRC|/fopen}} | * {{mIRC|/fopen}} | ||
* {{mIRC|/fwrite}} | * {{mIRC|/fwrite}} | ||
{{mIRC command list}} | {{mIRC command list}} | ||
− | [[Category: | + | [[Category:mIRC commands|write command - mIRC]] |
Latest revision as of 12:22, 8 November 2024
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
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]
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]
mIRC commands list