cfunc.open C Function/C Functions

cfunc.open

Command cfunc.open C Function/C Functions
Applicable release versions: AP 6.1
Category C Functions (120)
Description equivalent to the Pick/BASIC statement: open

open string1,string2 to fd

Upon successful return, the first parameter is a pointer to an integer file descriptor which may be passed to other file system calls.

string1 should be "dict" or "data", or may be passed as _CP_str_null.

string2 should be the file name.

This function returns -1 if an error occurs. The error code is contained in _CP_errno.
Syntax int _CP_open(int* fd, CPSTR* string1, CPSTR* string2)
Options
Example
CPSTR * s = _CP_mkstr("myfile");
int f;

_CP_open(&f,_CP_str_null,s);
_CP_clearfile(f);
_CP_close(f);
Purpose
Related cfunc.introduction
cfunc.close
cfunc.replace_bridge
cfunc.write
cfunc.writev
cfunc.release