LRec - Revision history

Laura at 17:31, 22 May 2014

2014-05-22T17:31:22Z

← Older revision		Revision as of 17:31, 22 May 2014
Line 1:		Line 1:
	~~LRec~~(<file handle>)		LREC(<file handle>)

	When the file referred to is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When it's an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When it's a display file, LREC returns the byte size of the file.		When the file referred to is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When it's an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When it's a display file, LREC returns the byte size of the file.

	When the file is not an open internal file handle LRec will return 0 or -1. If the file handle is equal to, then LRec will return 0. If it's greater than zero but is not an open file handle, LRec will return -1.		When the file is not an open internal file handle LRec will return 0 or -1. If the file handle is equal to, then LRec will return 0. If it's greater than zero but is not an open file handle, LRec will return -1.

Laura at 00:12, 22 May 2014

2014-05-22T00:12:00Z

← Older revision		Revision as of 00:12, 22 May 2014
Line 1:		Line 1:
	LRec(N)		LRec(<file handle>)

	When N is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When ~~N is~~ an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When ~~N is~~ a display file, LREC returns the byte size of the file.		When the file referred to is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When it's an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When it's a display file, LREC returns the byte size of the file.

	When N is not an open internal file handle LRec will return 0 or -1. If ~~N=0~~ then LRec~~(N)~~ will return 0. If ~~N is~~ greater than zero but is not an open file handle, LRec will return -1.		When the file is not an open internal file handle LRec will return 0 or -1. If the file handle is equal to, then LRec will return 0. If it's greater than zero but is not an open file handle, LRec will return -1.

	====Comments and Examples====		====Comments and Examples====

John: moved LREC to LRec over redirect

2014-02-27T13:12:21Z

moved LREC to LRec over redirect

← Older revision	Revision as of 13:12, 27 February 2014
(No difference)

Mikhail.zheleznov: *

2012-01-26T20:18:46Z

← Older revision		Revision as of 20:18, 26 January 2012
Line 1:		Line 1:
	LRec(N)		LRec(N)

	When N is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When N is an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When N is a display file, LREC returns the byte size of the file.		When N is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When N is an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When N is a display file, LREC returns the byte size of the file.
Line 6:		Line 6:

	====Comments and Examples====		====Comments and Examples====
	~~Here are three quick steps to determine how many records are in an internal file from [[immediate mode]] (although this could also be a program).~~

	OPEN #1:"name=filename",I,I,S		Here are three quick steps to determine how many records are in an internal file:
	PRINT LREC(1)
	CLOSE #1:		00010 OPEN #1:"name=filename",I,I,S
			00020 PRINT LREC(1)
			00030 CLOSE #1:

	As long as there are no deleted records, the number printed by PRINT LREC(1) is the total number of records in file 1.		As long as there are no deleted records, the number printed by PRINT LREC(1) is the total number of records in file 1.

	====Related Functions====		====Related Functions====

	For additional information about files, see the following functions:		For additional information about files, see the following functions:

	*[[Exists]]		*[[Exists]]
	*[[File$]]		*[[File$]]
Line 21:		Line 24:
	*[[FreeSp]]		*[[FreeSp]]
	*[[KLn]]		*[[KLn]]
	*[[~~KPSI~~]]		*[[KPS]]
	*[[KRec]]		*[[KRec]]
	*[[Rec]]		*[[Rec]]
Line 27:		Line 30:

	====Technical Considerations====		====Technical Considerations====

	# If any space in the file is occupied by records marked for deletion by the DELETE statement, these records will still appear in the total from LREC(N) even though they will not be processed by reading the file sequentially.		# If any space in the file is occupied by records marked for deletion by the DELETE statement, these records will still appear in the total from LREC(N) even though they will not be processed by reading the file sequentially.
	# If file N is not open, LREC(N) will return -1.		# If file N is not open, LREC(N) will return -1.

Mikhail.zheleznov: moved LRec to LREC

2012-01-17T10:14:02Z

moved LRec to LREC

← Older revision	Revision as of 10:14, 17 January 2012
(No difference)

Mikhail.zheleznov: 1 revision

2012-01-15T14:11:48Z

1 revision

New page

LRec(N)

When N is an internal file, '''LRec''' [[internal function]] returns the number of the last record in the file. When N is an external file, LRec returns the last record or last byte (depending on whether REC= or POS= was used last). When N is a display file, LREC returns the byte size of the file.

When N is not an open internal file handle LRec will return 0 or -1. If N=0 then LRec(N) will return 0. If N is greater than zero but is not an open file handle, LRec will return -1.

====Comments and Examples====
Here are three quick steps to determine how many records are in an internal file from [[immediate mode]] (although this could also be a program).

OPEN #1:"name=filename",I,I,S
PRINT LREC(1)
CLOSE #1:

As long as there are no deleted records, the number printed by PRINT LREC(1) is the total number of records in file 1.

====Related Functions====
For additional information about files, see the following functions:
*[[Exists]]
*[[File$]]
*[[FileNum]]
*[[FreeSp]]
*[[KLn]]
*[[KPSI]]
*[[KRec]]
*[[Rec]]
*[[RLn]]

====Technical Considerations====
# If any space in the file is occupied by records marked for deletion by the DELETE statement, these records will still appear in the total from LREC(N) even though they will not be processed by reading the file sequentially.
# If file N is not open, LREC(N) will return -1.
# For external files, LREC(N) can return either a record number or a byte number, depending on whether the last I/O statement used a REC= clause (the default mode) or a POS= clause (to position to a specified byte number).
# The use of LREC within an I/O statement is strongly discouraged, especially on multi-user systems. See the Multi-user Programming chapter for additional information.

<noinclude>
[[Category:Internal Functions]]
</noinclude>