Bread » History » Version 6
Per Amundsen, 05/09/2017 09:31 PM
| 1 | 1 | Per Amundsen | _Added in 1.9.0_ |
|---|---|---|---|
| 2 | |||
| 3 | 6 | Per Amundsen | */bread [-ta] <filename> <S> <N> <&binvar>* |
| 4 | 1 | Per Amundsen | |
| 5 | Reads <N> bytes starting at byte position <S> in the file and stores the result in &binvar. |
||
| 6 | |||
| 7 | *Switches* |
||
| 8 | |||
| 9 | -t - reads data until the next [[$crlf]] or EOF. |
||
| 10 | 6 | Per Amundsen | -a - Disables UTF-8 encoding of characters in the range 0-255, as long as the line contains no characters > 255. |
| 11 | 1 | Per Amundsen | |
| 12 | *Parameters* |
||
| 13 | |||
| 14 | <filename> - The binary file to read. |
||
| 15 | 3 | Per Amundsen | <S> - The byte position in the file to start reading from. |
| 16 | 1 | Per Amundsen | <N> - Number of bytes to read. |
| 17 | <&binvar> - The &binvar to read the data into. |
||
| 18 | |||
| 19 | *Example* |
||
| 20 | |||
| 21 | 2 | Per Amundsen | <pre> |
| 22 | 1 | Per Amundsen | ;noop $example(FileA, FileB) |
| 23 | alias example { |
||
| 24 | ;Read the whole file into a binary variable |
||
| 25 | bread $qt($1) 0 $file($1).size &tempFile |
||
| 26 | |||
| 27 | ;Write the bytes form the binary variable to a file |
||
| 28 | bwrite $qt($2) 0 -1 &tempFile |
||
| 29 | } |
||
| 30 | 2 | Per Amundsen | </pre> |