FnSnap: Array Functions

From BR Wiki
Jump to navigation Jump to search

Sorting arrays

FNSORTARRAY - sort an array with header and footer

Sorts an array either ascending or descending and optionally excludes elements at the top and bottom to allow headers and footers to remain in place - sort is based on positions within the array, not the start of the string

FNSORTARRAY(MAT L$,START,LENGTH;DESENDING,HEADER,FOOTER)!:

Functions used |None

Variables
Mat L$ matrix to be sorted
START Starting position for the character string on which to sort
LENGTH length of the character sub string on which to sort
DESCENDING if true sorts descending order else sorts ascending
HEADER number of rows at the top of the matrix to omit from the sort
FOOTER number of rows at the bottom of the matrix to omit from the sort


Comments

Sort an array on any character sub-set allowing for header rows at the top and footer/total rows at the bottom.


FNSRTARY - sort an array with header and footer based on itself

Similar to FNSORTARRAY but uses the entire string to sort rather than a sub string

FNSRTARY(MAT L$;MAT M$,DESENDING,HEADER,FOOTER)

Functions used |None

Variables
Mat L$ matrix to be sorted
DESCENDING if true sorts descending order else sorts ascending
HEADER number of rows at the top of the matrix to omit from the sort
FOOTER number of rows at the bottom of the matrix to omit from the sort


Comments



FNSRTNARY -Sort a numeric array based on another array

Similar to FNSRTARY but for a numeric matrix

FNSRTNARY(MAT L;MAT M$,DESENDING,HEADER,FOOTER) !:

Functions used |None

Variables
Mat L$ matrix to be sorted
DESCENDING if true sorts descending order else sorts ascending
HEADER number of rows at the top of the matrix to omit from the sort
FOOTER number of rows at the bottom of the matrix to omit from the sort


Comments

Array arithmetic

FNCOLSUM - sums the elements of an array for a specified column

Provides the sum of a single column of a multi column array.

FNCOLSUM(MAT L,C)
Functions used
Variables
MAT L Matrix containing multiple columns
C Column number to be summed
Comments



FNROWSUM - sums the elements of an array for a specified row

Returns the sum of a row of a multi row and multi column array

FNROWSUM(MAT L,R)
Functions used
Variables
Mat L Numeric array containing the row to be totaled
R Row number to be totaled


Comments



Searching arrays

FNCHRMAT$ - convert a numeric array to character

Convert a numeric matrix into a formatted character matrix

FNCHRMAT$(CHRMAT$,NUMMAT,FORMAT$;BLANKS)

Functions used |None

Variables
Mat CHRMAT$ matrix that will be output
Mat NUMMAT numeric matrix being converted
FORMAT$ format used to convert each line to a string
BLANKS if true replaces a zero value with blanks


Comments



FNLISTSRCH - searches a character array based on a search string

FNLISTSRCH(MAT L$,SRCHSTR$,MAT SELECT;STRT)

Description|
Performs a search on a matrix and modifies the matrix select with elements in the searched matrix that match SRCHSTR$

Functions used |

Variables
Mat L$ The array to be searched. The search is case insensitive and will match any matching combination regardless of position within each element.
SRCHSTR$ The string that is being matched to each element, case insensitive
MAT SELECT A numeric array that holds the row numbers of matching elements. Any newly found elements are added to the array.
STRT Optional positioning number. matches will only occur if the match is AFTER this position in the row string


Comments

Used in lists and grids following FNLISTSPEC to allow for a search of the arrays used in a list or grid and a positioning of the cursor on elements matching the criteria



FNLISTSRCHN - searches a numeric array based on a search string

FNLISTSRCHN(MAT L,SRCHSTR$,MAT SELECT;STRT,SMASK$)

Description|
Same as FNLISTSRCH except for a numeric matrix

Functions used |

Variables
Mat L The array to be searched. Each element is turned into a string before being searched. The search is case insensitive and will match any matching combination regardless of position within each element.
SRCHSTR$ The string that is being matched to each element, case insensitive
MAT SELECT A numeric array that holds the row numbers of matching elements. Any newly found elements are added to the array.
STRT Optional positioning number. matches will only occur if the match is AFTER this position in the row string


Comments

Used in lists and grids following FNLISTSPEC to allow for a search of the arrays used in a list or grid and a positioning of the cursor on elements matching the criteria



FNSELECTION - selection process using two arrays

FNSELECTION(SELECTION,MAT SEL$,MAT SEL;MANY)

Description|
Maintains two matrices, one SEL is true if an item is selected. The other SEL$ contains the selection sequence number if MANY is greater than one or the word SELECTED if MANY equals one. If many=0 only one item is allowed as a selection.

Functions used |None

Variables
SELECTION the element number selected or deselected MAT SEL$ selection number or word MAT SEL true if element is selected MANY 0 for a single selection 1 for any or all and a number for a limited number of elements


Comments



FNSRCHCRIT$*50 - search criteria for a list box

FNSRCHCRIT$*50(SR$,SC$,LROWS,LCOLS,PARENT;MESSAGE$)

Description|
Opens a window within a listbox window and asks for a search string

Functions used |

Variables


Comments



Other

FNDELROW - removes a row from an array and redimensions the array

Removes a row form an array and redimensions the array to be one row shorter

FNDELROW$(MAT DEL,DELROW)
Functions used
Variables
MAT DEL The numeric array that needs to be updated
DELROW The row number to delete


Comments



FNDELROW$ - removes a row from an array and redimensions the array

Removes a row form an array and redimensions the array to be one row shorter

FNDELROW$(MAT DEL$,DELROW)
Functions used
Variables
MAT DEL$ The character array that needs to be updated
DELROW The row number to delete


Comments



FNPARMAT - split an array into sub-arrays

Parses an array into a multi-dimensional array based on splitting at a predefined character

FNPARMAT(MAT M$,SUB$;NOREF)

Functions used |None

Variables
MAT M$ matrix to be parsed
SUB$ character that will be treated as a boundary or field separator NOREF if true prevents a single line matrix from being reformatted to a one dimensional matrix


Comments