Difference between revisions of "BINCREATE()"

From Recital Documentation Wiki
Jump to: navigation, search
(Class)
 
Line 1: Line 1:
 
 
 
==Purpose==
 
==Purpose==
 
Function to create a binary file
 
Function to create a binary file
Line 30: Line 28:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[Category:Binary File Access]]
 
[[Category:Binary File Access]]
 
[[Category:Binary File Access Functions]]
 
[[Category:Binary File Access Functions]]

Latest revision as of 16:08, 26 November 2009

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