Difference between revisions of "$read"
From Scriptwiki
m (htmltable -> wikitable) |
m (clarified that s switch scans for a whole word) |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 20: | Line 20: | ||
| t || If the ''t'' switch is specified then mIRC will treat the first line in the file as plain text, even if it is a numeric. | | t || If the ''t'' switch is specified then mIRC will treat the first line in the file as plain text, even if it is a numeric. | ||
|- | |- | ||
| − | | s || Scans the ''filename'' for a line beginning with the ''string'' and returns the text following the match value. | + | | s || Scans the ''filename'' for a line beginning with a word specified in the ''string'' and returns the text following the match value. |
|- | |- | ||
| w || Scans the ''filename'' for a line matching ''string'', where ''string'' can contain [[If-Then-Else#iswm|wildcards]]. | | w || Scans the ''filename'' for a line matching ''string'', where ''string'' can contain [[If-Then-Else#iswm|wildcards]]. | ||
|- | |- | ||
| − | | r || Scans the ''filename'' for a line matching ''string'', where ''string'' is taken as a [[ | + | | r || Scans the ''filename'' for a line matching ''string'', where ''string'' is taken as a [[Regular_Expression|regular expression]]. |
|- | |- | ||
| p || If the ''p'' switch is specified, command <nowiki>|</nowiki> separators are treated as such instead of as plain text. | | p || If the ''p'' switch is specified, command <nowiki>|</nowiki> separators are treated as such instead of as plain text. | ||
| Line 47: | Line 47: | ||
[[kick]] [[$chan]] [[$nick]] $read(Example.txt) ;Kicks a user with a random line from the text file. | [[kick]] [[$chan]] [[$nick]] $read(Example.txt) ;Kicks a user with a random line from the text file. | ||
| − | == Also | + | == See Also == |
* [[$readn]] This returns the line number that $read just returned. | * [[$readn]] This returns the line number that $read just returned. | ||
| + | * [[$lines]] This returns the total number of lines in the given file. | ||
* [[play]] This is a much better alternative if you require to list the content of a whole file to a channel. | * [[play]] This is a much better alternative if you require to list the content of a whole file to a channel. | ||
* [[filter]] This can help with more complex needs when reading in content from files or windows. | * [[filter]] This can help with more complex needs when reading in content from files or windows. | ||
Latest revision as of 14:07, 18 March 2016
Returns a line of text from a text file.
$read(filename,[ntswrp],[string],[N])
The first parameter is the filename and the only required parameter. If you omit all other parameters you will be returned with a random line from the file.
The second parameter is a set of options that determin the type of search you wish to use, for a full description see the table below. if string is numerical and you do not use swr switch the line corresponding to the numerical value will be returned.
If the N parameter is given it starts to search the file from that line number.
Note: If the first line of your text file is a numerical value mIRC treats this number as the total number of lines in the text file, be careful not to accidently have your file cut short due to an unexpected numerical value. If you specify N = 0, mIRC returns the value of the first line if it's a number. Take good note of the t switch in the table below.
| Switch | Meaning |
| n | If the n switch is specified then the line read in will not be evaluated and will be treated as plain text. |
| t | If the t switch is specified then mIRC will treat the first line in the file as plain text, even if it is a numeric. |
| s | Scans the filename for a line beginning with a word specified in the string and returns the text following the match value. |
| w | Scans the filename for a line matching string, where string can contain wildcards. |
| r | Scans the filename for a line matching string, where string is taken as a regular expression. |
| p | If the p switch is specified, command | separators are treated as such instead of as plain text. |
Examples
Example.txt: 5 Ave It Hash Help Dot Script 6 Cows dont go moo, Fish go moo! Fish go moo Yes they do
The above is an example text file used in the following examples.
$read(Example.txt,s,Ave) ;Returns It, all data that follows the first line starting with Ave. $read(Example.txt,w,*moo) ;Returns Fish go moo, note the lack of pending asterisks means moo has to be the last word. $read(Example.txt,3) ;Returns 6, This is the 3rd line in the file if you count line 1 as the linecount line because it is a number. $read(Example.txt,t,3) ;Returns Hash Help Dot Script, This is the 3rd line in the file if you count line 1 plain text. $read(Example.txt,w,*moo) ;Returns kick $chan $nick $read(Example.txt) ;Kicks a user with a random line from the text file.
See Also
- $readn This returns the line number that $read just returned.
- $lines This returns the total number of lines in the given file.
- play This is a much better alternative if you require to list the content of a whole file to a channel.
- filter This can help with more complex needs when reading in content from files or windows.
- loadbuf This is a much better alternative if you need to dump many lines of text to a dialog or to a custom window
