Sfairadora

  • Reference Guide

remove

remove(text, par, pos, n)
var_txt <- insert(par, pos, n)
The first variant removes n characters from the text from the paragraph with the index par, position pos. The modified text is returned as the result. The text parameter itself remains unchanged. The operation of the latter variant is analogous, but the text stored in the variable var_txt is changed in place. If the paragraph index exceeds the actual number of paragraphs or the position pos exceeds the character number in the paragraph, an error is returned. If n exceeds number of remaining characters, all the characters up to the end of text are removed.

Parameters

text
A value of the type Rich_text.
var_str
An l-value of the type Rich_text.
par
The index of the paragraph, to which the string is inserted (the type Int). Paragraphs are indexed from 0. If the text contains a table, the paragraphs in the table are numbered by rows.
pos
The index of the character within the paragraph where to insert the string (the type Int). The value 0 denotes the beginning of the paragraph.
n
Number of characters to be removed. The type Int.

Return Value

The first variant returns the modified text of the type Rich_text.
The latter variant returns an l-value referring to the variable var_txt.

See Also