From WikiChip
Difference between revisions of "mirc/commands/fseek"
m (Bot: Adding a template) |
(→Parameters) |
||
(17 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{mirc title|/fseek Command}} | ||
The '''/fseek command''' sets the read/write pointer to the specified position in the file, position starts at 0. | The '''/fseek command''' sets the read/write pointer to the specified position in the file, position starts at 0. | ||
== Synopsis == | == Synopsis == | ||
− | /fseek <name> <position> | + | /fseek -nlwrp <name> <position|N|matchtext> |
== Switches == | == Switches == | ||
− | * '''-l''' - sets the pointer to the beginning of the line | + | * '''-l''' - sets the pointer to the beginning of the Nth line |
− | * '''-n''' - sets the pointer to the beginning of the next line | + | * '''-n''' - sets the pointer to the beginning of the next line (from the current position of the read/write pointer) |
− | * '''-w''' - sets the pointer to the beginning of the line matching the wildcard expression | + | * '''-w''' - sets the pointer to the beginning of the line matching the {{mirc|wildcard}} expression |
* '''-r''' - sets the pointer to the beginning of the line matching the regular expression | * '''-r''' - sets the pointer to the beginning of the line matching the regular expression | ||
+ | * '''-p''' - sets the pointer to the beginning of the current line, if the pointer is already at the beginning of a line, it sets the pointer to the beginning of the previous line | ||
== Parameters == | == Parameters == | ||
* '''<name>''' - the name of the file handle | * '''<name>''' - the name of the file handle | ||
− | * '''<position>''' - not required | + | * '''<position|N|matchtex>''' - not required if you use -n, if -l is used: a line number, if -w is used: a {{mirc|wildcard}} expression, if -r is used: a regular expression, if no switch is used, it's the position in the file (Nth byte) |
+ | |||
+ | |||
+ | '''Note''': if /fseek is not successful (can't find a match with -w or -r, can't find the Nth line with -l etc), it will set the read/write pointer to the end of the file. $fopen().err is not set, but $fopen().eof is. | ||
== Example == | == Example == | ||
Line 23: | Line 28: | ||
== Compatibility == | == Compatibility == | ||
Added: 6.1 | Added: 6.1 | ||
− | |||
− | |||
− | |||
− | |||
== 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|$fread}} |
− | * | + | * {{mIRC|$fopen}} |
− | * | + | * {{mIRC|$ferr}} |
− | * | + | * {{mIRC|$feof}} |
− | * | + | * {{mIRC|$fgetc}} |
− | * | + | * {{mIRC|/fclose}} |
− | * | + | * {{mIRC|/flist}} |
− | * | + | * {{mIRC|/fopen}} |
{{mIRC command list}} | {{mIRC command list}} | ||
− | [[Category: | + | [[Category:mIRC commands|fseek command - mIRC]] |
Latest revision as of 13:07, 30 December 2019
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
The /fseek command sets the read/write pointer to the specified position in the file, position starts at 0.
Synopsis[edit]
/fseek -nlwrp <name> <position|N|matchtext>
Switches[edit]
- -l - sets the pointer to the beginning of the Nth line
- -n - sets the pointer to the beginning of the next line (from the current position of the read/write pointer)
- -w - sets the pointer to the beginning of the line matching the wildcard expression
- -r - sets the pointer to the beginning of the line matching the regular expression
- -p - sets the pointer to the beginning of the current line, if the pointer is already at the beginning of a line, it sets the pointer to the beginning of the previous line
Parameters[edit]
- <name> - the name of the file handle
- <position|N|matchtex> - not required if you use -n, if -l is used: a line number, if -w is used: a wildcard expression, if -r is used: a regular expression, if no switch is used, it's the position in the file (Nth byte)
Note: if /fseek is not successful (can't find a match with -w or -r, can't find the Nth line with -l etc), it will set the read/write pointer to the end of the file. $fopen().err is not set, but $fopen().eof is.
Example[edit]
/fseek myfile 42 /fseek -l myfile 12 /fseek -n /fseek -w *findthis* /fseek -r /findthat/
Compatibility[edit]
Added: 6.1
See also[edit]
mIRC commands list