Project

General

Profile

Bwrite » History » Revision 6

Revision 5 (Per Amundsen, 11/02/2018 03:45 AM) → Revision 6/7 (Per Amundsen, 02/06/2019 08:28 PM)

_Added in 1.9.0_ 

 */bwrite [-tac] <filename> <S> [N] <text|%var|&binvar>* 

 Writes [N] bytes from <text|%var|&binvar> to the file starting at byte position <S> or 0, any existing information at this position is overwritten. 

 *Switches* 

 -t - Treat <text|%var|&binvar> as plain text. 
 -a - Disables UTF-8 encoding of characters in the range 0-255, as long as the text contains no characters > 255. 
 -c - Chops the file at the end of the copied bytes. 

 *Parameters* 

 <filename> - File to modify. 
 <S> - Byte position in the file to start writing to. (zero based) 
 [N] - Byte count from <text|%var|&binvar> to write. 
 <text|%var|&binvar> - Text/%variable/&binvar to write to file. 

 *Example* 

 <pre> 
 alias example { 
   ;Write some text to a file at beginning of the file 
   /bwrite file.txt 0 hello there! 

   ;Read the binary data into binary variable &tempfile 
   /bread $qt(file.txt) 0 $file(file.txt).size &tempfile 

   ;Print the binary variable data as text, outputs 'Hello there!' 
   echo -ag $bvar(&tempfile, 1-).text 
  
   ;Replace "there!" with "world!" 
   /bwrite file.txt 6 world! 

   ;Read the binary data into binary variable &tempfile 
   /bread $qt(file.txt) 0 $file(file.txt).size &tempfile 

   ;Print the binary variable data as text, outputs 'Hello world!' 
   echo -ag $bvar(&tempfile, 1-).text 
 } 
 </pre>