cmd_newdata Function (ROM Call 0x363)

AMS 1.01 or higher bascmd.h

void cmd_newdata (CESI Data);

Executes TI-Basic 'NewData' command.

cmd_newdata creates a TI-Basic data variable. This function expects the following layout on the expression stack:

END_TAG listexpr_n ... listexpr_2 listexpr_1 symname

listexpr_1, listexpr_2, etc. are list expressions (they may be symbol names of TI-Basic list variables as well), and symname is the VAT symbol name (see SYMSTR and Tags for more info) of the TI-Basic data variable which will be created. The parameter Data should point to the tag of the last item on the expression stack. The data variable will be built up from these list expressions; each list will become one column of the data variable. There must be at least one list. This function also makes the new variable the current one in the Data/Matrix editor. See the TI-Basic manual for more info.


Uses: HeapAlloc, HeapFree, HeapFreeIndir, HeapLock, HeapRealloc, HeapUnlock, remaining_element_count, ER_catch, ER_success, ER_throwVar, check_estack_size, HToESI, next_expression_index, top_estack, memcpy, memset, sprintf, CheckGraphRef, estack_max_index, gen_version, primary_tag_list, statFree, AddSymToFolder, checkCurrent, DerefSym, HSymDel, HSYMtoName, SymFind, VarStore, _bcd_math, ROM Call 0x459, ROM Call 0x45A
Used by: cmd_blddata, spike_geo_titles, spike_optionD