AIdx - Revision history

Gordon.dye at 03:34, 23 May 2017

2017-05-23T03:34:48Z

← Older revision		Revision as of 03:34, 23 May 2017
Line 37:		Line 37:
	# The [[RD]] specification in [[BRConfig.sys]] can affect the AIDX function because it determines when two numeric values are considered equal.		# The [[RD]] specification in [[BRConfig.sys]] can affect the AIDX function because it determines when two numeric values are considered equal.
	# The [[COLLATE]] option in effect when the program was last saved or in the [[Option (statement)]] can alter the sort order from the AIDX function when sorting string values.		# The [[COLLATE]] option in effect when the program was last saved or in the [[Option (statement)]] can alter the sort order from the AIDX function when sorting string values.
	# To use AIDX, the arrays on both sides of the equal sign must have the same ~~dimensions~~.		# To use AIDX, the arrays on both sides of the equal sign must have only one dimension and they must be the same number of elements.

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

Laura at 12:41, 22 May 2014

2014-05-22T12:41:35Z

← Older revision		Revision as of 12:41, 22 May 2014
Line 1:		Line 1:
	AIDX (<array name>)		AIDX (<[[array name]]>)

	The '''AIDX''' [[internal function]] returns an [[array]] that is an ascending index obtained from sorting the array ~~named~~. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''		The '''AIDX''' [[internal function]] returns an [[array]] that is an ascending index obtained from sorting the array within parenthesis. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''

	'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.		'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.
Line 31:		Line 31:
	===Related Functions===		===Related Functions===

	Other functions that operate on [[arrays]] are [[DIDX]] (array sort with descending index), [[SRCH]], [[SUM]] and [[UDIM]]. See also ~~the~~ [[MAT]] ~~statement~~.		Other functions that operate on [[arrays]] are [[DIDX]] (array sort with descending index), [[SRCH]], [[SUM]] and [[UDIM]]. See also [[MAT]].

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

Laura at 19:32, 20 May 2014

2014-05-20T19:32:22Z

← Older revision		Revision as of 19:32, 20 May 2014
Line 1:		Line 1:
	AIDX (array name)		AIDX (<array name>)

	The '''AIDX''' [[internal function]] returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''		The '''AIDX''' [[internal function]] returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''

John at 18:31, 24 February 2014

2014-02-24T18:31:40Z

← Older revision		Revision as of 18:31, 24 February 2014
Line 1:		Line 1:
	AIDX (array name)		AIDX (array name)

	The '''AIDX''' internal function returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''		The '''AIDX''' [[internal function]] returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''

	'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.		'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.

John: moved AIDX to AIdx

2014-02-24T18:31:30Z

moved AIDX to AIdx

← Older revision	Revision as of 18:31, 24 February 2014
(No difference)

Mikhail.zheleznov: *

2012-01-18T20:01:55Z

← Older revision		Revision as of 20:01, 18 January 2012
Line 1:		Line 1:
	AIDX (array name)		AIDX (array name)

	The '''AIDX''' internal function returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''~~Permitted~~ only in the MAT statement.'''		The '''AIDX''' internal function returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''The use of AIDX is permitted only in the MAT statement.'''

	'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.		'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.
Line 24:		Line 24:
	00150 READ MAT N$ EOF 155		00150 READ MAT N$ EOF 155
	00155 MAT N$(CNT)		00155 MAT N$(CNT)
	00160 MAT A(UDIM(N$))=AIDX(N$)		00160 MAT A(UDIM(N$))=AIDX(N$) !
	00170 FOR I=1 TO 15		00170 FOR I=1 TO 15
	00180 PRINT N$(A(I))		00180 PRINT N$(A(I))
	00190 NEXT I		00190 NEXT I

Mikhail.zheleznov: *

2012-01-17T13:22:31Z

← Older revision		Revision as of 13:22, 17 January 2012
Line 3:		Line 3:
	The '''AIDX''' internal function returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''Permitted only in the MAT statement.'''		The '''AIDX''' internal function returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''Permitted only in the MAT statement.'''

	~~The~~ [[Mat]] ~~may not be used~~ in the ''array name'' parameter of this function. ~~Rather than~~ (~~Mat X~~), (X) ~~will specify the X array.~~		'''Note''' that you cannot use the '''[[Mat]]''' keyword in the ''array name'' parameter of this function.

			Correct:

			00010 MAT AscendingIndexArray(UDIM(ArrayToBeIndexed$))=AIDX(ArrayToBeIndexed$)

			Incorrect:

			00010 MAT AscendingIndexArray(UDIM(ArrayToBeIndexed$))=AIDX(MAT ArrayToBeIndexed$)

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

Mikhail.zheleznov: edit

2012-01-12T11:33:25Z

edit

New page

AIDX (array name)

The '''AIDX''' internal function returns an [[array]] that is an ascending index obtained from sorting the array named. The array to be sorted may be either string or numeric. '''Permitted only in the MAT statement.'''

The [[Mat]] may not be used in the ''array name'' parameter of this function. Rather than (Mat X), (X) will specify the X array.

===Comments and Examples===

The program below will sort and print an array of names in alphabetical order:

00100 DIM A(100),N$(100)
00110 DATA "Tom", "Colleen", "Bill", "Christi"
00120 DATA "Tim", "Dave", "Sheila", "Jenni"
00130 DATA "Pam", "Laura", "Jean", "Michele"
00140 DATA "Gary", "Gordon", "Mallika"
00150 READ MAT N$ EOF 155
00155 MAT N$(CNT)
00160 MAT A(UDIM(N$))=AIDX(N$)
00170 FOR I=1 TO 15
00180 PRINT N$(A(I))
00190 NEXT I

===Related Functions===

Other functions that operate on [[arrays]] are [[DIDX]] (array sort with descending index), [[SRCH]], [[SUM]] and [[UDIM]]. See also the [[MAT]] statement.

===Technical Considerations===

# The [[RD]] specification in [[BRConfig.sys]] can affect the AIDX function because it determines when two numeric values are considered equal.
# The [[COLLATE]] option in effect when the program was last saved or in the [[Option (statement)]] can alter the sort order from the AIDX function when sorting string values.
# To use AIDX, the arrays on both sides of the equal sign must have the same dimensions.

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