| ER_throwVar | Function (ROM Call 0x153)

error.h

void ER_throwVar (short err_no);

Throws an error.

ER_throwVar restores the state previously saved by ER_catch. It then returns in such a way that ER_catch appears to have returned with the value err_no. See the TI-Basic manual for a meaning of the various error codes. ER_throwVar should not be called with a value 0 as err_no. Think of ER_throwVar as a long jump rather than a subroutine call. Execution does not return from the ER_throwVar call.
Note: If you want to use ER_throwVar to bail out to the TIOS from an arbitrary place, you need to define `ENABLE_ERROR_RETURN`. See the section Returning Errors for more information.

Uses: NG_control, NG_such_that_index
Used by: PASS, cmd_blddata, cmd_circle, cmd_cubicreg, cmd_custom, cmd_dialog, cmd_disp, cmd_disptbl, cmd_drawfunc, cmd_drawinv, cmd_drawparm, cmd_drawpol, cmd_expreg, cmd_get, cmd_input, cmd_inputstr, cmd_linetan, cmd_linreg, cmd_lnreg, cmd_logistic, cmd_medmed, cmd_movevar, cmd_newdata, cmd_newfold, cmd_newpic, cmd_onevar, cmd_output, cmd_passerr, cmd_pause, cmd_popup, cmd_powerreg, cmd_prompt, cmd_quadreg, cmd_quartreg, cmd_request, cmd_send, cmd_sendcalc, cmd_sendchat, cmd_shade, cmd_showstat, cmd_sinreg, cmd_slpline, cmd_sorta, cmd_sortd, cmd_toolbar, cmd_try, cmd_twovar, did_push_anti_deriv, push_1st_derivative, push_acosh, push_asin, push_asinh, push_atan, push_atanh, push_comdenom, push_cosh, push_csolve, push_czeros, push_def_int, push_desolve, push_determinant, push_exp, push_expand, push_extended_prod, push_factor, push_floor, push_lim, push_ln, push_log10, push_max, push_min, push_nsolve, push_red_row_ech, push_row_echelon, push_simult, push_sin2, push_sinh, push_solve, push_str_to_expr, push_summation, push_tan, push_tanh, push_zeros, push_equals, push_exponentiate, push_greater_than, push_greater_than_or_equals, push_less_than, push_less_than_or_equals, push_not_equals, push_product, push_substitute_simplify, push_substitute_using_such_that, push_sum, Dialog, display_statements, NG_approxESI, NG_execute, NG_graphESI, NG_rationalESI, NG_RPNToText, Parse1DExpr, Parse2DExpr, Parse2DMultiExpr, push_internal_simplify, push_parse_text, TokenizeSymName, EV_defaultHandler, EV_sendEventSide, handleRclKey, handleVarLinkKey, GR3_paint3d, GR3_xyToWindow, gdb_recall, HomeExecute, HomePushEStack, HomeStorePair, getcalc, exp, log, log10, are_units_consistent, de_initRes, de_loop, did_push_approx_inflection_point, did_push_var_val, does_push_fetch, dv_create_graph_titles, EQU_getNameInfo, EV_quit, execute_graph_func, get_ub, GetStatValue, GM_Derivative, GM_DistArc, GM_Inflection, GM_Integrate, GM_Intersect, GM_Math1, GM_Shade, GM_TanLine, gr_ck_solvergraph, gr_execute_de, gr_execute_seq, GR_Pan, GR3_addContours, GR3_handleEvent, GraphOrTableCmd, GT_CalcDepVals, GT_DE_Init_Conds, GT_Trace, GZ_Fit, index_if_pushed_qquad_info, InitTimeSeq, next_token, NG_setup_graph_fun, push_ans_entry, push_format, push_gcd_then_cofactors, push_make_proper, push_parse_prgm_or_func_text, push_simplify, push_sq_matrix_to_whole_number, push_user_func, recall_data_var, Regraph, replace_top_with_post_simplified, run_one_seq, seqWebInit, SP_Define, spike_in_editor, spike_optionD, spike_titles_in_editor, tokenize_if_TI_92_or_text, FolderDel, FolderRename, HSymDel, SymFindFolderName, VarStore, ROM Call 0x437, ROM Call 0x438, ROM Call 0x455, ROM Call 0x45B, ROM Call 0x46F, ROM Call 0x494, ROM Call 0x495, ROM Call 0x4E6

See also: ER_throw, ErrorCodes, PASS