| HS_getAns | Function (ROM Call 0x241)

homescr.h

HANDLE HS_getAns (unsigned short Index);

Returns the handle of a Home Screen answer.

HS_getAns returns a handle to the answer 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 `'ans'` pseudo-function. If the answer does not exist, HS_getAns returns H_NULL. This happens in three conditions

- The entry/answer pair does not exist.
- The answer is a message like "Done" that comes after an executed program.
- The answer is an error message (i.e. ERROR_MSG_TAG is present in it).

The returned handle contains a "multi-expression"; see MULTI_EXPR and HS_getEntry for more info.

Uses: HS_getFIFONode, HToESI
Used by: push_ans_entry

See also: HS_getEntry, HS_getFIFONode