version 6.0
WR Get text (area; first; last) Text
Parameter | Type | Description | |
area | Longint | 4D Write area | |
first | Longint | First character of text | |
last | Longint | Last character of text | |
Function result | Text | Text between first and last characters |
Description
The command WR Get text returns the text in area between the character described by first and the character described by last.
The maximum number of characters 4th Dimension can store in a field or variable is 32,000. Therefore, WR Get text can return a maximum of 32,000 characters. If the difference between last and first is greater than 32,000 characters, and the document has at least last number of characters, WR Get text returns an empty string and an error is reported by WR Error number.
If last is greater than the number of characters in the document and the difference between last and first is less than 32,000, WR Get text returns all of the characters to the end of the document. If last is less than or equal to first, WR Get text returns an empty string.
WR Get text does not change the selected text in area.
Example
The following example places the first 100 characters of area into the variable vText.
vText:=WR Get text (area;0;100)
See Also
WR GET PARAGRAPHS, WR Get selected text, WR GET SELECTION.