D3 Reference Manual

Index | Help

Поиск по страницам

Разделы / С-функции / _CP_read

_CP_read

read (функциональность оператора FlashBASIC)

int _CP_read(int type, CPSTR** result, int expression, CPSTR* string, int* value)

Эквивалентна одному из следующих операторов FlashBASIC в зависимости от типа ("type"):

Тип        Оператор FlashBASIC
_CP_READ   read result from expression,string
_CP_READU  readu result from expression,string
_CP_READUL readu result from expression,string 
            locked value = 1 end else value = 0 end

Если значение не требуется, пользователь может передать (int*) 0.

Вызов "_CP_read" использует ту же самую оптимизированную прогамму чтения, что и FlashBASIC. Это работает примерно в 2-5 раз быстрее, чем программа, используемая процессором AQL и стандартным Pick/BASIC.

Выражение "expression" должно быть дискриптором файла типа "integer", возвращаемым вызовом "_CP_open".

В случае ошибки функция возвращает "-1". Код ошибки содержится в "_CP_errno".

Примеры:

Следующий пример читает запись "myid" из "myfile".

CPSTR * s = _CP_mkstr("myfile");
CPSTR * id = _CP_mkstr("myid");
CPSTR * xx = _CP_str_null;
int f;
_CP_open(&f,_CP_str_null,s);
_CP_read(_CP_READ, xx, f, id, 0);