KRec - Revision history

Gordon.dye at 20:31, 16 October 2022

2022-10-16T20:31:23Z

← Older revision		Revision as of 20:31, 16 October 2022
Line 3:		Line 3:
	The '''KRec''' [[internal function]]:		The '''KRec''' [[internal function]]:

			# returns the number of the last accessed key for [[indexed files]]
	# returns the number of records accessed since the last [[NEWPAGE]] for [[display files]]		# returns the number of records accessed since the last [[NEWPAGE]] for [[display files]]
	~~# returns~~ the ~~number~~ of ~~the last accessed key for [[indexed files]]~~		Note- following NEWPAGE with a semicolon (e.g. NEWPAGE; ) suppresses the zeroing of KREC.

	When processing a linked file, KRec is updated with the location of an anchor record only under the following conditions:		When processing a linked file, KRec is updated with the location of an anchor record only under the following conditions:

Laura at 19:41, 21 May 2014

2014-05-21T19:41:31Z

← Older revision		Revision as of 19:41, 21 May 2014
Line 1:		Line 1:
			KREC

	The '''KRec''' [[internal function]]:		The '''KRec''' [[internal function]]:

John: moved KReg to KRec

2014-02-26T16:15:49Z

moved KReg to KRec

← Older revision	Revision as of 16:15, 26 February 2014
(No difference)

John: moved KREC to KReg

2014-02-26T16:15:36Z

moved KREC to KReg

← Older revision	Revision as of 16:15, 26 February 2014
(No difference)

Laura at 19:41, 25 February 2013

2013-02-25T19:41:44Z

← Older revision		Revision as of 19:41, 25 February 2013
Line 33:		Line 33:
	*[[Rec]]		*[[Rec]]
	*[[RLn]]		*[[RLn]]
	*[[NewPage]] (for [[~~display files~~]])		*[[NewPage]] (for [[Display Files]])

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

Mikhail.zheleznov: *

2012-01-26T18:26:32Z

← Older revision		Revision as of 18:26, 26 January 2012
Line 18:		Line 18:
	When file N is a display file, KRec(N) acts as a line counter for lines output to the file. This feature is especially useful with printers in counting how many lines have already been printed on a page. Also, outputting a NEWPAGE to advance the paper to the top of the next page resets this counter to zero. [[Print]] KRec(255) will return the number of lines output to the standard printer file #255 since the last '''PRINT #255: NEWPAGE''' was issued.		When file N is a display file, KRec(N) acts as a line counter for lines output to the file. This feature is especially useful with printers in counting how many lines have already been printed on a page. Also, outputting a NEWPAGE to advance the paper to the top of the next page resets this counter to zero. [[Print]] KRec(255) will return the number of lines output to the standard printer file #255 since the last '''PRINT #255: NEWPAGE''' was issued.

	If file N is an internal file opened for [[Keyed]] processing, then KRec(N) returns the number of the last record accessed in the key file. This is different from the last record accessed in the master file, which can be found by the [[Rec]]N) function.		If file N is an internal file opened for [[Keyed]] processing, then KRec(N) returns the number of the last record accessed in the key file. This is different from the last record accessed in the master file, which can be found by the [[Rec]](N) function.

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

Mikhail.zheleznov: *

2012-01-26T18:24:44Z

← Older revision		Revision as of 18:24, 26 January 2012
Line 1:		Line 1:
	The '''KRec''' [[internal function]] ~~returns the number of records accessed since the last [[NEWPAGE]] for [[display files]]; returns the number of the last accessed key for [[indexed files]].~~		The '''KRec''' [[internal function]]:

	~~When processing a linked list file, KRec is updated with~~ the ~~location~~ of ~~an anchor record only under~~ the ~~following conditions:~~		# returns the number of records accessed since the last [[NEWPAGE]] for [[display files]]
			# returns the number of the last accessed key for [[indexed files]]

	:~~1.)~~ A [[Rec]]=(anchor record) is processed.		When processing a linked file, KRec is updated with the location of an anchor record only under the following conditions:
	~~:2.)~~ An anchor record is read.
	~~:3.)~~ An anchor record is written or deleted.		# A [[Rec]]=(anchor record) is processed.
			# An anchor record is read.
			# An anchor record is written or deleted.

	[[Restore]] REC=(non-anchor)sets KRec to zero. KRec remains otherwise unaffected during [[Read]] and [[Write]] statement processing.		[[Restore]] REC=(non-anchor)sets KRec to zero. KRec remains otherwise unaffected during [[Read]] and [[Write]] statement processing.

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

	KRec(N) is really two functions under one name. It has one use with display files, and another use with indexed internal files.		KRec(N) is really two functions under one name. It has one use with display files, and another use with indexed internal files.

	When file N is a display file, KRec(N) acts as a line counter for lines output to the file. This feature is especially useful with printers in counting how many lines have already been printed on a page. Also, outputting a NEWPAGE (to advance the paper to the top of the next page) resets this counter to zero. [[Print]] KRec(255) will return the number of lines output to the standard printer file (#255) since the last PRINT #255:NEWPAGE was issued.		When file N is a display file, KRec(N) acts as a line counter for lines output to the file. This feature is especially useful with printers in counting how many lines have already been printed on a page. Also, outputting a NEWPAGE to advance the paper to the top of the next page resets this counter to zero. [[Print]] KRec(255) will return the number of lines output to the standard printer file #255 since the last '''PRINT #255: NEWPAGE''' was issued.

	If file N is an internal file opened for [[Keyed]] processing, then KRec(N) returns the number of the last record accessed in the key file~~; this~~ is different from the last record accessed in the master file, which can be found by the [[Rec]]N) function.		If file N is an internal file opened for [[Keyed]] processing, then KRec(N) returns the number of the last record accessed in the key file. This is different from the last record accessed in the master file, which can be found by the [[Rec]]N) function.

	====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 24:		Line 30:
	*[[KLn]]		*[[KLn]]
	*[[KPs]]		*[[KPs]]
	*[[KRec]
	*[[LRec]]		*[[LRec]]
	*[[Rec]]		*[[Rec]]

Mikhail.zheleznov: moved KRec to KREC

2012-01-17T10:14:26Z

moved KRec to KREC

← 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

The '''KRec''' [[internal function]] returns the number of records accessed since the last [[NEWPAGE]] for [[display files]]; returns the number of the last accessed key for [[indexed files]].

When processing a linked list file, KRec is updated with the location of an anchor record only under the following conditions:

:1.) A [[Rec]]=(anchor record) is processed.
:2.) An anchor record is read.
:3.) An anchor record is written or deleted.

[[Restore]] REC=(non-anchor)sets KRec to zero. KRec remains otherwise unaffected during [[Read]] and [[Write]] statement processing.

====Comments and Examples====
KRec(N) is really two functions under one name. It has one use with display files, and another use with indexed internal files.

When file N is a display file, KRec(N) acts as a line counter for lines output to the file. This feature is especially useful with printers in counting how many lines have already been printed on a page. Also, outputting a NEWPAGE (to advance the paper to the top of the next page) resets this counter to zero. [[Print]] KRec(255) will return the number of lines output to the standard printer file (#255) since the last PRINT #255:NEWPAGE was issued.

If file N is an internal file opened for [[Keyed]] processing, then KRec(N) returns the number of the last record accessed in the key file; this is different from the last record accessed in the master file, which can be found by the [[Rec]]N) function.

====Related Functions====
For additional information about files, see the following functions:
*[[Exists]]
*[[File$]]
*[[FileNum]]
*[[FreeSp]]
*[[KLn]]
*[[KPs]]
*[[KRec]
*[[LRec]]
*[[Rec]]
*[[RLn]]
*[[NewPage]] (for [[display files]])

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