doc:lua_make-your-own-scripts
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | Next revisionBoth sides next revision | ||
doc:lua_make-your-own-scripts [2014/10/13 18:22] – admin | doc:lua_make-your-own-scripts [2014/10/13 18:46] – admin | ||
---|---|---|---|
Line 186: | Line 186: | ||
- | === ioInput(file name , | + | === ioInput(file_name |
Line 228: | Line 228: | ||
- | ==== loadbuffer | + | === loadbuffer === |
- | loadbuffer(start: longint; VAR filelen: longint; | + | |
- | Reads the file "filename" into the telegram buffer starting at position " | + | Reads the file "file_name" into the telegram buffer starting at position " |
- | The number of bytes read will be returned in " | + | The data source can be defined as explained for the ioInput command. |
+ | |||
+ | The number of bytes read will be returned in " | ||
The following conditions apply: | The following conditions apply: | ||
- | * If the filename is "" | + | * The selected filename will be returned in " |
- | * If len is 0, the whole file will be read. If the length exceeds the telegram length, an error will be raised. | + | * If filename |
- | ==== savebuffer | + | === savebuffer === |
- | savebuffer(start: longint; VAR filelen: longint; | + | |
Writes the telegram buffer starting at position " | Writes the telegram buffer starting at position " | ||
- | The number of bytes written will be returned in " | + | The number of bytes written will be returned in " |
The following conditions apply: | The following conditions apply: | ||
- | * If the filename is "" | + | * The selected file name will be returned in " |
* If len is 0, the whole telegram buffer will be written. | * If len is 0, the whole telegram buffer will be written. | ||
- | ==== setbuffer | + | === setbuffer === |
- | setBuffer(bufferNr | + | setBuffer(bufferNr |
- | Changes the actual buffer used to buffer number " | + | Changes the actual buffer used to buffer number " |
- | If newsize is <> 0, the old buffer is deleted and new memory with size newmem is allocated. The maximal memsize is 2^31 = 2147483648 bytes | + | If newsize is <> 0, the old buffer is deleted and new memory with size newmem is allocated |
- | ==== copyBuffer | + | === copyBuffer === |
- | copyBuffer(bufferNr | + | copyBuffer(bufferNr ) |
- | Copies the content of buffer | + | Copies the content of buffer |
- | ==== BlitBuffer | + | === BlitBuffer === |
- | BlitBuffer(frombuffer: byte; startpos: longint; | + | BlitBuffer(frombuffer |
Copies a memory block from the buffer " | Copies a memory block from the buffer " | ||
Line 276: | Line 278: | ||
In case the buffer len needs to be bigger, the buffer len is increased accourdingly. | In case the buffer len needs to be bigger, the buffer len is increased accourdingly. | ||
- | ==== SetBufferLen | + | === SetBufferLen === |
- | | + | |
All other buffer commands can increase the ' | All other buffer commands can increase the ' | ||
Line 285: | Line 287: | ||
SetBufferLen sets the ' | SetBufferLen sets the ' | ||
- | The success of the SetBufferLen - operation is returned | + | The success of the SetBufferLen - operation is returned |
- | ^ input value of newSize | + | ^ input value of newSize |
| < = 0 | available size of the buffer in bytes. This can be used to read the real allocated memory size of that buffer | | < = 0 | available size of the buffer in bytes. This can be used to read the real allocated memory size of that buffer | ||
| 1.. available size | new available size (= requested size) | | | 1.. available size | new available size (= requested size) | | ||
Line 293: | Line 295: | ||
As seen, a negative value given back indicates a fault condition, all other returned values are positive. | As seen, a negative value given back indicates a fault condition, all other returned values are positive. | ||
+ | |||
+ | |||
+ | === SendBuffer === | ||
+ | Sends the actual buffer | ||
+ | |||
doc/lua_make-your-own-scripts.txt · Last modified: 2019/04/08 18:43 by admin