BINCREATE()

Class

Binary File Access

Purpose

Function to create a binary file

Syntax

BINCREATE([<expC>])

See Also

BIN2I(), BIN2L(), BIN2W(), BINCLOSE(), BINOPEN(), BINREAD(), BINSEEK(), BINWRITE(), FCLOSE(), FCREATE(), FOPEN(), I2BIN(), L2BIN()

Description

The BINCREATE() function creates a new binary file. The <expC> is the name of the file to be created. BINCREATE() leaves the created file open, and returns a file descriptor when successful, or a -1 if an error occurs. Since the file descriptor is used to identify an open binary file, always assign the BINCREATE() return value to a memory variable.

Example

fd = bincreate("file.obj")
count = binread(fd, 4)
count = bin2l(count)
count = l2bin(count + 1)
binseek(fd, 512, 0)
binwrite(fd, count)
binclose(fd)

Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer