Home > MultiValue Central > Online D3 Reference > C Functions > cfunc.open

cfunc.open

C Function/C Functions, Releases: AP 6.1

Pick/BASIC 'open' functionality from C.

Syntax

int _CP_open(int* fd, CPSTR* string1, CPSTR* string2)

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.

Example

CPSTR * s = _CP_mkstr('myfile');
int f;

_CP_open(&f,_CP_str_null,s);
_CP_clearfile(f);
_CP_close(f);

See Also

Command Name Type Description
cfunc.introduction Introductory Overview
cfunc.close C Function Pick/BASIC 'close' functionality from C.
cfunc.replace_bridge C Function Pick/BASIC 'replace' statement functionality from C.
cfunc.write C Function Pick/BASIC 'write' functionality from C.
cfunc.writev C Function Pick/BASIC 'writev' functionality from C.
cfunc.release C Function Pick/BASIC 'release' statement functionality from C.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.