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

Tcl_IntObj<\/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_NewIntObj, Tcl_NewLongObj, Tcl_NewWideIntObj, Tcl_SetIntObj, Tcl_SetLongObj, Tcl_SetWideIntObj, Tcl_GetIntFromObj, Tcl_GetLongFromObj, Tcl_GetWideIntFromObj, Tcl_NewBignumObj, Tcl_SetBignumObj, Tcl_GetBignumFromObj, Tcl_TakeBignumFromObj \u2212 manipulate Tcl values as integers<\/p>\n

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

#include <\/b><\/p>\n

Tcl_Obj bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_NewIntObj<\/b>(intValue<\/i>)<\/p>\n

Tcl_Obj bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_NewLongObj<\/b>(longValue<\/i>)<\/p>\n

Tcl_Obj bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_NewWideIntObj<\/b>(wideValue<\/i>)<\/p>\n

Tcl_SetIntObj<\/b>(objPtr, intValue<\/i>)<\/p>\n

Tcl_SetLongObj<\/b>(objPtr, longValue<\/i>)<\/p>\n

Tcl_SetWideIntObj<\/b>(objPtr, wideValue<\/i>)<\/p>\n

int
Tcl_GetIntFromObj<\/b>(interp, objPtr, intPtr<\/i>)<\/p>\n

int
Tcl_GetLongFromObj<\/b>(interp, objPtr, longPtr<\/i>)<\/p>\n

int
Tcl_GetWideIntFromObj<\/b>(interp, objPtr, widePtr<\/i>)<\/p>\n

#include <\/b><\/p>\n

Tcl_Obj bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_NewBignumObj<\/b>(bigValue<\/i>)<\/p>\n

Tcl_SetBignumObj<\/b>(objPtr, bigValue<\/i>)<\/p>\n

int
Tcl_GetBignumFromObj<\/b>(interp, objPtr, bigValue<\/i>)<\/p>\n

int
Tcl_TakeBignumFromObj<\/b>(interp, objPtr, bigValue<\/i>)<\/p>\n

int
Tcl_InitBignumFromDouble<\/b>(interp, doubleValue, bigValue<\/i>)<\/p>\n

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

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

<\/td>\n\n

Integer value used to initialize or set a Tcl value.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

long longValue<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Long integer value used to initialize or set a Tcl value.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_WideInt wideValue<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Wide integer value used to initialize or set a Tcl value.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

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

<\/td>\n\n

For Tcl_SetIntObj<\/b>, Tcl_SetLongObj<\/b>, Tcl_SetWideIntObj<\/b>, and Tcl_SetBignumObj<\/b>, this points to the value in which to store an integral value. For Tcl_GetIntFromObj<\/b>, Tcl_GetLongFromObj<\/b>, Tcl_GetWideIntFromObj<\/b>, Tcl_GetBignumFromObj<\/b>, and Tcl_TakeBignumFromObj<\/b>, this refers to the value from which to retrieve an integral value.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

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

<\/td>\n\n

When non-NULL, an error message is left here when integral value retrieval fails.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

int *intPtr<\/i> (out)<\/p>\n<\/td>\n

<\/td>\n\n

Points to place to store the integer value retrieved from objPtr<\/i>.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

long *longPtr<\/i> (out)<\/p>\n<\/td>\n

<\/td>\n\n

Points to place to store the long integer value retrieved from objPtr<\/i>.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_WideInt *widePtr<\/i> (out)<\/p>\n<\/td>\n

<\/td>\n\n

Points to place to store the wide integer value retrieved from objPtr<\/i>.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

mp_int *bigValue<\/i> (in\/out)<\/p>\n<\/td>\n

<\/td>\n\n

Points to a multi-precision integer structure declared by the LibTomMath library.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

double doubleValue<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Double value from which the integer part is determined and used to initialize a multi-precision integer value.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

______________________________________________________________________________<\/p>\n

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

These procedures are used to create, modify, and read Tcl values that hold integral values.<\/p>\n

The different routines exist to accommodate different integral types in C with which values might be exchanged. The C integral types for which Tcl provides value exchange routines are int<\/b>, long int<\/b>, Tcl_WideInt<\/b>, and mp_int<\/b>. The int<\/b> and long int<\/b> types are provided by the C language standard. The Tcl_WideInt<\/b> type is a typedef defined to be whatever signed integral type covers at least the 64-bit integer range (-9223372036854775808 to 9223372036854775807). Depending on the platform and the C compiler, the actual type might be long int<\/b>, long long int<\/b>, __int64<\/b>, or something else. The mp_int<\/b> type is a multiple-precision integer type defined by the LibTomMath multiple-precision integer library.<\/p>\n

The Tcl_NewIntObj<\/b>, Tcl_NewLongObj<\/b>, Tcl_NewWideIntObj<\/b>, and Tcl_NewBignumObj<\/b> routines each create and return a new Tcl value initialized to the integral value of the argument. The returned Tcl value is unshared.<\/p>\n

The Tcl_SetIntObj<\/b>, Tcl_SetLongObj<\/b>, Tcl_SetWideIntObj<\/b>, and Tcl_SetBignumObj<\/b> routines each set the value of an existing Tcl value pointed to by objPtr<\/i> to the integral value provided by the other argument. The objPtr<\/i> argument must point to an unshared Tcl value. Any attempt to set the value of a shared Tcl value violates Tcl\u2019s copy-on-write policy. Any existing string representation or internal representation in the unshared Tcl value will be freed as a consequence of setting the new value.<\/p>\n

The Tcl_GetIntFromObj<\/b>, Tcl_GetLongFromObj<\/b>, Tcl_GetWideIntFromObj<\/b>, Tcl_GetBignumFromObj<\/b>, and Tcl_TakeBignumFromObj<\/b> routines attempt to retrieve an integral value of the appropriate type from the Tcl value objPtr<\/i>. If the attempt succeeds, then TCL_OK<\/b> is returned, and the value is written to the storage provided by the caller. The attempt might fail if objPtr<\/i> does not hold an integral value, or if the value exceeds the range of the target type. If the attempt fails, then TCL_ERROR<\/b> is returned, and if interp<\/i> is non-NULL, an error message is left in interp<\/i>. The Tcl_ObjType<\/b> of objPtr<\/i> may be changed to make subsequent calls to the same routine more efficient. Unlike the other functions, Tcl_TakeBignumFromObj<\/b> may set the content of the Tcl value objPtr<\/i> to an empty string in the process of retrieving the multiple-precision integer value.<\/p>\n

The choice between Tcl_GetBignumFromObj<\/b> and Tcl_TakeBignumFromObj<\/b> is governed by how the caller will continue to use objPtr<\/i>. If after the mp_int<\/b> value is retrieved from objPtr<\/i>, the caller will make no more use of objPtr<\/i>, then using Tcl_TakeBignumFromObj<\/b> permits Tcl to detect when an unshared objPtr<\/i> permits the value to be moved instead of copied, which should be more efficient. If anything later in the caller requires objPtr<\/i> to continue to hold the same value, then Tcl_GetBignumFromObj<\/b> must be chosen.<\/p>\n

The Tcl_InitBignumFromDouble<\/b> routine is a utility procedure that extracts the integer part of doubleValue<\/i> and stores that integer value in the mp_int<\/b> value bigValue<\/i>.<\/p>\n

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

Tcl_NewObj, Tcl_DecrRefCount, Tcl_IncrRefCount, Tcl_GetObjResult<\/p>\n

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

integer, integer value, integer type, internal representation, value, value type, string representation<\/p>\n

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

Tcl_NewIntObj, Tcl_NewLongObj, Tcl_NewWideIntObj, Tcl_SetIntObj, Tcl_SetLongObj, Tcl_SetWideIntObj, Tcl_GetIntFromObj, Tcl_GetLongFromObj, Tcl_GetWideIntFromObj, Tcl_NewBignumObj, Tcl_SetBignumObj, Tcl_GetBignumFromObj, Tcl_TakeBignumFromObj \u2212 manipulate Tcl values as integers <\/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,3008],"class_list":["post-6627","post","type-post","status-publish","format-standard","hentry","category-3-llamadas-de-bibliotecas","tag-2538","tag-man3","tag-tcl_newwideintobj"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6627","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=6627"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6627\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6627"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6627"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6627"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}