IB Statements/fstat - Revision history

Barb at 16:02, 16 August 2016

2016-08-16T16:02:06Z

← Older revision		Revision as of 16:02, 16 August 2016
Line 41:		Line 41:
	129 2 Time of last update (seconds, 2 digits)		129 2 Time of last update (seconds, 2 digits)
	131 4 Time of last update HHMM		131 4 Time of last update HHMM
-	135 4 For keyed file: File length of I00 file (# of bytes, hex **	+	135 4 For keyed file: File length of I00 file (# of bytes, hex)
	For object file: if NE "@00000000@" then it's a Comet32 object		For object file: if NE "@00000000@" then it's a Comet32 object
	139 4 Key position (extended keyed files only)		139 4 Key position (extended keyed files only)

Barb at 15:59, 16 August 2016

2016-08-16T15:59:52Z

← Older revision		Revision as of 15:59, 16 August 2016
Line 41:		Line 41:
	129 2 Time of last update (seconds, 2 digits)		129 2 Time of last update (seconds, 2 digits)
	131 4 Time of last update HHMM		131 4 Time of last update HHMM
-	135 4 File length of I00 file (# of bytes, hex)	+	135 4 For keyed file: File length of I00 file (# of bytes, hex **
		+	For object file: if NE "@00000000@" then it's a Comet32 object
	139 4 Key position (extended keyed files only)		139 4 Key position (extended keyed files only)
	143 1 File type in hex (added in Comet 2005)		143 1 File type in hex (added in Comet 2005)

Badge: New page: '''FSTAT function''' '''Syntax:''' FSTAT(filename[,DIR=directory][,EXCP=statement-label]) '''Discussion:''' The FSTAT function returns file status information. The filename may b...

2009-05-22T12:28:43Z

New page: '''FSTAT function''' '''Syntax:''' FSTAT(filename[,DIR=directory][,EXCP=statement-label]) '''Discussion:''' The FSTAT function returns file status information. The filename may b...

New page

'''FSTAT function'''

'''Syntax:''' FSTAT(filename[,DIR=directory][,EXCP=statement-label])

'''Discussion:''' The FSTAT function returns file status information.

The filename may be a string constant, a single-element string variable, a string array element, a string expression, or a string function.

If you specify a directory, and the file does not exist, FSTAT succeeds and gives you the next file in the directory you specified. If you do not specify a directory, and the file does not exist, Comet gives you an error 11 (file not found).

Return values: Position Length Description/Values
===================================================================
1 1 File type
K = keyed file
D = sequential file
T = text file
O = Comet object program
Q = QICBASIC object program
2 1 Locked status
"P" = locked
"" or "@00@" = unlocked
3 3 Directory name
6 3 Open count (decimal)
9 3 Extract count (decimal)
12 3 Record size (# of bytes, decimal)
15 4 Size of data file (# of bytes, hex)
19 6 Create date (MMDDYY)
25 6 Update date (MMDDYY)
31 3 Key length
(# of bytes, decimal, key files only)
34 1 Unused
35 11 Next file name in directory
46 4 Record size (# of bytes, decimal, 4 digits)
50 12 Whole file name after the conversion from Qantel
characters to DOS characters, in the form:
filename (8 characters with blanks appended),
period (if extension is supplied), and
extension (3 characters)
62 * 8 Full create date (MMDDYYYY)
70 * 8 Full update date (MMDDYYYY)
129 2 Time of last update (seconds, 2 digits)
131 4 Time of last update HHMM
135 4 File length of I00 file (# of bytes, hex)
139 4 Key position (extended keyed files only)
143 1 File type in hex (added in Comet 2005)
"@01@" = sequential file
"@02@" = contiguous file
"@04@" = keyed file
"@08@" = text file
"@24@" = extended keyed file
147 4 Position of object in library file (if object
file is bound)

* Full create date and update date added in Comet 504.239 and Comet98 Build 239.
Example: LENGTH 150 & LOCAL VALUE$
.
VALUE$ = FSTAT("C1A",EXCP=9999)

This example shows how the FSTAT function can be used to obtain file status information for a file named "C1A".