Cnt - Revision history

Laura at 20:01, 20 May 2014

2014-05-20T20:01:22Z

← Older revision		Revision as of 20:01, 20 May 2014
Line 1:		Line 1:
			CNT
	See also the READ type for [[Grid and List#Parameters\|Grids]]		See also the READ type for [[Grid and List#Parameters\|Grids]]

John at 19:36, 26 February 2014

2014-02-26T19:36:07Z

← Older revision		Revision as of 19:36, 26 February 2014
Line 1:		Line 1:
	See also the READ type for [[Grid and List#Parameters\|Grids]]		See also the READ type for [[Grid and List#Parameters\|Grids]]

	The '''CNT''' internal function returns the number of data items successfully processed by the last I/O [[statement]]. When there is an error in a field definition array in [[INPUT FIELDS]], [[PRINT FIELDS]] or [[RINPUT FIELDS]] statements, CNT will return the number of the last successfully processed element in the error-causing field definition [[array]].		The '''CNT''' [[internal function]] returns the number of data items successfully processed by the last I/O [[statement]]. When there is an error in a field definition array in [[INPUT FIELDS]], [[PRINT FIELDS]] or [[RINPUT FIELDS]] statements, CNT will return the number of the last successfully processed element in the error-causing field definition [[array]].

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

John: moved CNT to Cnt

2014-02-26T19:35:58Z

moved CNT to Cnt

← Older revision	Revision as of 19:35, 26 February 2014
(No difference)

Laura at 18:05, 16 October 2013

2013-10-16T18:05:23Z

← Older revision		Revision as of 18:05, 16 October 2013
Line 1:		Line 1:
			See also the READ type for [[Grid and List#Parameters\|Grids]]

	The '''CNT''' internal function returns the number of data items successfully processed by the last I/O [[statement]]. When there is an error in a field definition array in [[INPUT FIELDS]], [[PRINT FIELDS]] or [[RINPUT FIELDS]] statements, CNT will return the number of the last successfully processed element in the error-causing field definition [[array]].		The '''CNT''' internal function returns the number of data items successfully processed by the last I/O [[statement]]. When there is an error in a field definition array in [[INPUT FIELDS]], [[PRINT FIELDS]] or [[RINPUT FIELDS]] statements, CNT will return the number of the last successfully processed element in the error-causing field definition [[array]].

Mikhail.zheleznov: edit

2012-01-12T13:42:38Z

edit

New page

The '''CNT''' internal function returns the number of data items successfully processed by the last I/O [[statement]]. When there is an error in a field definition array in [[INPUT FIELDS]], [[PRINT FIELDS]] or [[RINPUT FIELDS]] statements, CNT will return the number of the last successfully processed element in the error-causing field definition [[array]].

===Comments and Examples===

When an I/O error occurs, the CNT function is very useful in [[debugging]]. Suppose the following program has two arrays of 52 elements each:

00510 READ #2,USING 520: MAT PAYTYPE$,FLAG$,MAT AMT
00520 FORM 52*C 1,N 1,52*N 5.2

Error code [[0726]] will occur on line 510 above to indicate a [[conversion error]] on one of the 103 items being read. As soon as the error occurs, the operator should enter PRINT CNT (or just CNT), and the system will print 52. This means the first 52 items were read successfully and the problem is in the 53rd item. CNT immediately localizes the problem to FLAG$ (which cannot be read with an N 1 format because it is a string variable).

In the following example, CNT is used within a program to [[redimension]] an array to the number of elements read:

00010 DIM A(20)
00020 DATA 1,2,3,4,5
00030 READ MAT A EOF 40
00040 MAT A(CNT)

===Related Functions===

The [[ERR]] and [[LINE]] functions are also commonly used for debugging.

===Technical Considerations===

If the current error was not an I/O error, CNT will be irrelevant because it contains information about a previous error.

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