BINCREATE()

From Recital Documentation Wiki
Jump to: navigation, search

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 Server, Recital