Difference between revisions of "var.recallAt"
Jump to navigation
Jump to search
(Created page with "var.'''recallAt''' is a function that is part of the Var library.<br /> Recalls a value from a cell of a list or matrix in the symbol table. This function is ...") |
|||
Line 1: | Line 1: | ||
+ | __NOTOC__ | ||
+ | |||
var.'''recallAt''' is a function that is part of the [[:Category:var|Var]] library.<br /> | var.'''recallAt''' is a function that is part of the [[:Category:var|Var]] library.<br /> | ||
Line 15: | Line 17: | ||
! Parameter !! Type !! Description | ! Parameter !! Type !! Description | ||
|- | |- | ||
− | | <u><center>name</center></u> || string || | + | | <u><center>name</center></u> || string || Name of the variable to grab from |
|- | |- | ||
− | | <u><center>column</center></u> || number || | + | | <u><center>column</center></u> || number || 1-based column number of the matrix or list. |
|- | |- | ||
− | | <u><center>row</center></u> || number || | + | | <u><center>row</center></u> || number || ''(Optional)'' 1-based row number. ''row'' is only required when recalling a value from a matrix. |
|- | |- | ||
|} | |} | ||
== Example == | == Example == | ||
− | |||
<syntaxhighlight>var.store("mat", {{1,2}, {3,4}}) -- create matrix mat in the symbol table | <syntaxhighlight>var.store("mat", {{1,2}, {3,4}}) -- create matrix mat in the symbol table | ||
var.storeAt("mat", 13.3, 1, 1) -- puts the number 13.1 into the field 1,1 of the matrix | var.storeAt("mat", 13.3, 1, 1) -- puts the number 13.1 into the field 1,1 of the matrix |
Latest revision as of 12:58, 7 June 2012
var.recallAt is a function that is part of the Var library.
Recalls a value from a cell of a list or matrix in the symbol table.
This function is optimized to work with numeric values and normally returns a number. If the value of the recalled cell is not numeric, this function returns nil and an error message string.
This has been introduced in TI-Nspire OS 3.2 (Changes).
Syntax
var.recallAt(name, column [,row])
Parameter | Type | Description |
---|---|---|
string | Name of the variable to grab from | |
number | 1-based column number of the matrix or list. | |
number | (Optional) 1-based row number. row is only required when recalling a value from a matrix. |
Example
var.store("mat", {{1,2}, {3,4}}) -- create matrix mat in the symbol table
var.storeAt("mat", 13.3, 1, 1) -- puts the number 13.1 into the field 1,1 of the matrix
val = var.recallAt("mat", 1, 1) -- grab it back in lua
Good to know
Routines var.recallAt and var.storeAt will work with matrices but only if they are created by some other means (var.store) :
See also