{"id":6648,"date":"2022-12-20T19:19:34","date_gmt":"2022-12-20T22:19:34","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/tcl_cancel-man3\/"},"modified":"2022-12-20T19:19:34","modified_gmt":"2022-12-20T22:19:34","slug":"tcl_cancel-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/tcl_cancel-man3\/","title":{"rendered":"Tcl_Cancel (man3)"},"content":{"rendered":"

Tcl_Cancel<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
ARGUMENTS<\/a>
DESCRIPTION<\/a>
SEE ALSO<\/a>
KEYWORDS<\/a> <\/p>\n

\n

______________________________________________________________________________<\/p>\n

NAME <\/a> <\/h2>\n

Tcl_CancelEval, Tcl_Canceled \u2212 cancel Tcl scripts<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

#include <\/b>
int
Tcl_CancelEval<\/b>(interp, resultObjPtr, clientData, flags<\/i>)<\/p>\n

int
Tcl_Canceled<\/b>(interp, flags<\/i>)<\/p>\n

ARGUMENTS <\/a> <\/h2>\n\n\n\n\n\n
<\/td>\n\n

Tcl_Interp *interp<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Interpreter in which to cancel the script.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_Obj *resultObjPtr<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Error message to use in the cancellation, or NULL to use a default message. If not NULL, this object will have its reference count decremented before Tcl_CancelEval<\/b> returns.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

int flags<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

ORed combination of flag bits that specify additional options. For Tcl_CancelEval<\/b>, only TCL_CANCEL_UNWIND<\/b> is currently supported. For Tcl_Canceled<\/b>, only TCL_LEAVE_ERR_MSG<\/b> and TCL_CANCEL_UNWIND<\/b> are currently supported.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

ClientData clientData<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Currently reserved for future use. It should be set to NULL.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

______________________________________________________________________________<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

Tcl_CancelEval<\/b> cancels or unwinds the script in progress soon after the next invocation of asynchronous handlers, causing TCL_ERROR<\/b> to be the return code for that script. This function is thread-safe and may be called from any thread in the process.<\/p>\n

Tcl_Canceled<\/b> checks if the script in progress has been canceled and returns TCL_ERROR<\/b> if it has. Otherwise, TCL_OK<\/b> is returned. Extensions can use this function to check to see if they should abort a long running command. This function is thread sensitive and may only be called from the thread the interpreter was created in.<\/p>\n

FLAG BITS<\/b>
Any ORed combination of the following values may be used for the flags<\/i> argument to procedures such as Tcl_CancelEval<\/b>:<\/p>\n\n\n\n
<\/td>\n\n

TCL_CANCEL_UNWIND<\/b><\/p>\n<\/td>\n

<\/td>\n\n

This flag is used by Tcl_CancelEval<\/b> and Tcl_Canceled<\/b>. For Tcl_CancelEval<\/b>, if this flag is set, the script in progress is canceled and the evaluation stack for the interpreter is unwound. For Tcl_Canceled<\/b>, if this flag is set, the script in progress is considered to be canceled only if the evaluation stack for the interpreter is being unwound.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

TCL_LEAVE_ERR_MSG<\/b><\/p>\n<\/td>\n

<\/td>\n\n

This flag is only used by Tcl_Canceled<\/b>; it is ignored by other procedures. If an error is returned and this bit is set in flags<\/i>, then an error message will be left in the interpreter\u2019s result, where it can be retrieved with Tcl_GetObjResult<\/b> or Tcl_GetStringResult<\/b>. If this flag bit is not set then no error message is left and the interpreter\u2019s result will not be modified.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

SEE ALSO <\/a> <\/h2>\n

interp(n), Tcl_Eval(3), TIP 285<\/p>\n

KEYWORDS <\/a> <\/h2>\n

cancel, unwind<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

Tcl_CancelEval, Tcl_Canceled \u2212 cancel Tcl scripts <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2536],"tags":[2538,3007,3028],"class_list":["post-6648","post","type-post","status-publish","format-standard","hentry","category-3-llamadas-de-bibliotecas","tag-2538","tag-man3","tag-tcl_canceleval"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6648","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6648"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6648\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6648"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6648"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6648"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}