| HS_getEntry | Function (ROM Call 0x242)

homescr.h

HANDLE HS_getEntry (unsigned short Index);

Returns the handle of a Home Screen entry.

HS_getEntry returns a handle to the entry part of the Home Screen history pair with index Index, where Index is a value between 1 and 99 and has the same meaning as the parameter of the TI-Basic `'entry'` pseudo-function. If the entry does not exist, HS_getEntry returns H_NULL.
The returned handle contains a "multi-expression". A multi-expression is an expression consisting of multiple expressions seperated by NEXTEXPR_TAG and ending in ENDSTACK_TAG. See MULTI_EXPR for more info.
Even if the multi-expression contains only one expression and therefore has no NEXTEXPR_TAGs in it, it will still have an ENDSTACK_TAG.
The handle returned by this funtion is valid input for HToESI and Parse2DMultiExpr.

Uses: HS_getFIFONode
Used by: TE_handleEvent, push_ans_entry

See also: HS_getAns, HS_getFIFONode