Topic complex |
Ramtext functions |
Function |
ramtext_paste() |
Short |
Inserts the "ramtext:~clip" into another ramtext |
Syntax |
ramtext_paste(ramtext : STRING; startpos : INTEGER) : INTEGER |
Parameter |
ramtext : ramtext file name formatted like "ramtext:..."
startpos: Position in ramtext where "ramtext:~clip" first character is to be inserted |
Return |
Number of characters of ramtext that have been moved while inserting "ramtext:~clip". |
See also: |
|
Description |
This function inserts the content of the system text file "ramtext:~clip" beginning at the position startpos.
The return value is of low importance because it shows the number of chars that have been moved through the insert operation - it's (filesize - startpos). If it's value is 0 there are two reasons why the ramtext could not be inserted:
* startpos was set to 0 (which is not allowed)
* startpos was higher as the current file size +1
This means startpos may only be of values from 1 (insert at the very beginning) to GetSize(ramtext) +1 (insert at the very end)
|