tf_write(), sf_write()

Purpose

Write data to a file

Old names

#define _vnwrite tf_write
#define _anwrite sf_write

Syntax (CCOWN)

void tf_write(int file_handle, const void *data, unsigned bytes)
void sf_write(int file_handle, const void * data, unsigned bytes)

Syntax (DP4DBAPI)

BOOLEAN dp4_sf_write(FCONN * fconn, void *data, dp4_file_size)

Parameters

int file_handle

File handle of file to which to write, obtained from an earlier call to tf_open() or sf_open()

 

FCONN * fconn

File handle of file to which to write, obtained from an earlier call to dp4_sf_open()

 

const void* data

Pointer to buffer to hold data that is written

 

unsigned bytes

Number of bytes to write to file

Description

The tf_write() and sf_write() functions write a number of bytes to the current position in the file. The file position is automatically incremented.

The sf_write() function calls the file handling support in the database manager, and the tf_write() function calls the file handling support in the terminal manager. You must not call an sf_ function with a handle obtained with tf_open(), or a tf_ function with a handle obtained with sf_open().

For the DP4DBAPI functions, the return value is TRUE if the function completes without errors.

See also

tf_write_record(), tf_read()