Project

General

Profile

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>