Texas Instruments TI-89 - Push_List_To_Mat

694
Appendix A: System Routines — Lists and Matrices
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
push_list_to_mat
Declaration:
void
push_list_to_mat
(EStackIndex
list_idx,
EStackIndex
el_per_row_idx
)
Category(ies):
Lists and Matrices
Description:
Converts the list indexed by
list_idx
to a matrix with the elements per row
as specified by the value indexed by
el_per_row_idx
and pushes the result
on the estack.
Inputs:
list_idx
— Indexes the input list.
el_per_row_idx
— Indexes the number of elements per row for the
resulting matrix. If NULL then the number of elements
in the list is used (a row matrix is created).
Outputs:
None
Assumptions:
None
Side Effects:
May expand expression stack, cause heap compression, or throw an error.
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: push_mat_to_list
Example:
/* Push a row matrix on the estack from a list indexed by list_index.
Assume list_index already setup, make sure it is a list and not a matrix.
*/
if ((ESTACK(list_index) == LIST_TAG) && (ESTACK(list_index-1) != LIST_TAG)) {
push_list_to_mat (list_index, NULL);
/* Now push a column matrix on the estack */
push_list_to_mat (list_index, Integer1Index);
}