ITEM_READ$()

ITEM_READ$(N,L)

RETURNS THE ITEM NUMBER L OF THE SYSTEM OBJECT NUMBER N

  • Type: Function
  • Parameters: 2
  • Group: System Objects

ACTION

The function ITEM_READ$(N,L) returns the line (item) number L of the system object designated by its number N.

The system object is of type : MEMO, MEMO_RICH, COMBO, LIST, DLIST, SYNEDIT.

Remark 1: the first line has the number 1.

Remark 2: the keyword ITEM_READ$ ends by '$' because the returned value is a string.

SYNTAX: Result$=ITEM_READ$(N,L)

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.
  • L = number of item (integer or real). Must be greater than 0.
  • Result$ is a string.

USE

  • The function ITEM_READ$() is used to read a line of an object handling text.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If the system object number N does not exist.
  • If the object number N is not of type : MEMO, MEMO_RICH, COMBO, LIST, DLIST, SYNEDIT.
  • If number L is not a correct expression.
  • If number L is less than 0.

EXAMPLE

rem create a LIST

list 1

rem fill the LIST with 2 lines

item_add 1,"This is line 1"

item_add 1,"This is line 2"

rem print the second item

print

print

print

print

print

print

print

print

print item_read$(1,2)

SEE ALSO

MEMO

MEMO_RICH

COMBO

LIST

DLIST

SYNEDIT

FILE_ADD

ITEM_ADD

ITEM_INSERT

ITEM_DELETE

ITEM_SELECT

COUNT()

ITEM_INDEX()

ITEM_INDEX$()