Returns a line of text from a text file.
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.
|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.|
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.
- $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