Difference between revisions of "BINOPEN()"

From Lianjapedia
Jump to: navigation, search
 
(7 intermediate revisions by 4 users not shown)
Line 3: Line 3:
  
 
==Syntax==
 
==Syntax==
BINOPEN([<expC>,<expN>])
+
BINOPEN(<expC>,<expN>)
  
 
==See Also==
 
==See Also==
[[BIN2I()]], [[BIN2L()]], [[BIN2W()]], [[BINCLOSE()]], [[BINCREATE()]], [[BINREAD()]], [[BINSEEK()]], [[BINWRITE()]], [[FCLOSE()]], [[FOPEN()]], [[I2BIN()]], [[L2BIN()]]
+
[[BIN2I()]], [[BIN2L()]], [[BIN2W()]], [[BINCLOSE()]], [[BINCREATE()]], [[BINFILETOSTR()]], [[BINREAD()]], [[BINSEEK()]], [[BINSTRTOFILE()]], [[BINWRITE()]], [[FCLOSE()]], [[FOPEN()]], [[I2BIN()]], [[L2BIN()]]
  
 
==Description==
 
==Description==
 
The BINOPEN() function opens an existing binary file.  The <expC> is the name of the file to be opened.  The <expN> is the mode in which the file will be opened.  The open mode options are:
 
The BINOPEN() function opens an existing binary file.  The <expC> is the name of the file to be opened.  The <expN> is the mode in which the file will be opened.  The open mode options are:
  
{| class="wikitable"
+
{| class="wikitable" width="100%"
 
!Mode||Description
 
!Mode||Description
 
|-
 
|-
Line 26: Line 26:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
fd = binopen("file.obj")
+
fd = binopen("file.obj", 2)
 
count = binread(fd, 4)
 
count = binread(fd, 4)
 
count = bin2l(count)
 
count = bin2l(count)
Line 37: Line 37:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
[[Category:Binary File Access]]
+
[[Category:Object Storage Functions]]
[[Category:Binary File Access Functions]]
+
[[Category:Lianja VFP Extensions]]
 +
[[Category:VFP Function Extensions]]

Latest revision as of 07:59, 4 March 2019

Purpose

Function to open a binary file

Syntax

BINOPEN(<expC>,<expN>)

See Also

BIN2I(), BIN2L(), BIN2W(), BINCLOSE(), BINCREATE(), BINFILETOSTR(), BINREAD(), BINSEEK(), BINSTRTOFILE(), BINWRITE(), FCLOSE(), FOPEN(), I2BIN(), L2BIN()

Description

The BINOPEN() function opens an existing binary file. The <expC> is the name of the file to be opened. The <expN> is the mode in which the file will be opened. The open mode options are:

Mode Description
0 Read-only
1 Write-only
2 Read/write

BINOPEN() returns a file descriptor if it has opened the file successfully, or a -1 if unsuccessful. Since the file descriptor is used to identify open binary files, the BINOPEN() return value should always be assigned to a memory variable. The binary conversion functions may be used in conjunction with the binary file functions.

Example

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