// // SWIG pointer conversion and utility library // // Dave Beazley // April 19, 1997 // // Tcl specific implementation. This file is included // by the file ../pointer.i #if defined(SWIGTCL8) // ----------------------------------------------------------------- // Define a hack for GetPtr on Tcl 8 // // ----------------------------------------------------------------- %{ static char *_SWIG_GetPtr(Tcl_Interp *interp, char *s, void **ptr, char *type) { Tcl_Obj *obj; char *c; obj = Tcl_NewStringObj(s, strlen(s)); c = SWIG_GetPointerObj(interp, obj, ptr, type); if (c) { c = strstr(s,c); } Tcl_DecrRefCount(obj); return c; } #define SWIG_GetPtr(a,b,c) _SWIG_GetPtr(interp, a,b,c) %} #endif %{ #include /*------------------------------------------------------------------ ptrcast(value,type) Constructs a new pointer value. Value may either be a string or an integer. Type is a string corresponding to either the C datatype or mangled datatype. ptrcast(0,"Vector *") or ptrcast(0,"Vector_p") ------------------------------------------------------------------ */ static int ptrcast(Tcl_Interp *interp, char *_ptrvalue, char *type) { char *r,*s; void *ptr; char *typestr,*c; int pv; int error = 0; /* Produce a "mangled" version of the type string. */ typestr = (char *) malloc(strlen(type)+2); /* Go through and munge the typestring */ r = typestr; *(r++) = '_'; c = type; while (*c) { if (!isspace(*c)) { if ((*c == '*') || (*c == '&')) { *(r++) = 'p'; } else *(r++) = *c; } else { *(r++) = '_'; } c++; } *(r++) = 0; /* Check to see what kind of object _PTRVALUE is */ if (Tcl_GetInt(interp,_ptrvalue,&pv) == TCL_OK) { ptr = (void *) pv; /* Received a numerical value. Make a pointer out of it */ r = (char *) malloc(strlen(typestr)+22); if (ptr) { SWIG_MakePtr(r, ptr, typestr); } else { sprintf(r,"_0%s",typestr); } Tcl_SetResult(interp,r,TCL_VOLATILE); free(r); } else { /* Have a string. Try to get the real pointer value */ s = _ptrvalue; r = (char *) malloc(strlen(type)+22); /* Now extract the pointer value */ if (!SWIG_GetPtr(s,&ptr,0)) { if (ptr) { SWIG_MakePtr(r,ptr,typestr); } else { sprintf(r,"_0%s",typestr); } Tcl_SetResult(interp,r,TCL_VOLATILE); } else { error = 1; } free(r); } free(typestr); if (error) { Tcl_SetResult(interp,"Type error in ptrcast. Argument is not a valid pointer value.",TCL_VOLATILE); return TCL_ERROR; } return TCL_OK; } /*------------------------------------------------------------------ ptrvalue(ptr,type = 0) Attempts to dereference a pointer value. If type is given, it will try to use that type. Otherwise, this function will attempt to "guess" the proper datatype by checking against all of the builtin C datatypes. ------------------------------------------------------------------ */ static int ptrvalue(Tcl_Interp *interp, char *_ptrvalue, int index, char *type) { void *ptr; char *s; int error = 0; if (type) { if (strlen(type) == 0) type = 0; } s = _ptrvalue; if (SWIG_GetPtr(s,&ptr,0)) { Tcl_SetResult(interp,"Type error in ptrvalue. Argument is not a valid pointer value.", TCL_STATIC); return TCL_ERROR; } /* If no datatype was passed, try a few common datatypes first */ if (!type) { /* No datatype was passed. Type to figure out if it's a common one */ if (!SWIG_GetPtr(s,&ptr,"_int_p")) { type = "int"; } else if (!SWIG_GetPtr(s,&ptr,"_double_p")) { type = "double"; } else if (!SWIG_GetPtr(s,&ptr,"_short_p")) { type = "short"; } else if (!SWIG_GetPtr(s,&ptr,"_long_p")) { type = "long"; } else if (!SWIG_GetPtr(s,&ptr,"_float_p")) { type = "float"; } else if (!SWIG_GetPtr(s,&ptr,"_char_p")) { type = "char"; } else if (!SWIG_GetPtr(s,&ptr,"_char_pp")) { type = "char *"; } else { type = "unknown"; } } if (!ptr) { Tcl_SetResult(interp,"Unable to dereference NULL pointer.",TCL_STATIC); return TCL_ERROR; } /* Now we have a datatype. Try to figure out what to do about it */ if (strcmp(type,"int") == 0) { sprintf(interp->result,"%ld",(long) *(((int *) ptr) + index)); } else if (strcmp(type,"double") == 0) { Tcl_PrintDouble(interp,(double) *(((double *) ptr)+index), interp->result); } else if (strcmp(type,"short") == 0) { sprintf(interp->result,"%ld",(long) *(((short *) ptr) + index)); } else if (strcmp(type,"long") == 0) { sprintf(interp->result,"%ld",(long) *(((long *) ptr) + index)); } else if (strcmp(type,"float") == 0) { Tcl_PrintDouble(interp,(double) *(((float *) ptr)+index), interp->result); } else if (strcmp(type,"char") == 0) { Tcl_SetResult(interp,((char *) ptr) + index, TCL_VOLATILE); } else if (strcmp(type,"char *") == 0) { char *c = *(((char **) ptr)+index); if (c) Tcl_SetResult(interp,(char *) c, TCL_VOLATILE); else Tcl_SetResult(interp,"NULL", TCL_VOLATILE); } else { Tcl_SetResult(interp,"Unable to dereference unsupported datatype.",TCL_STATIC); return TCL_ERROR; } return TCL_OK; } /*------------------------------------------------------------------ ptrcreate(type,value = 0,numelements = 1) Attempts to create a new object of given type. Type must be a basic C datatype. Will not create complex objects. ------------------------------------------------------------------ */ static int ptrcreate(Tcl_Interp *interp, char *type, char *_ptrvalue, int numelements) { void *ptr; int sz; char *cast; char temp[40]; /* Check the type string against a variety of possibilities */ if (strcmp(type,"int") == 0) { sz = sizeof(int)*numelements; cast = "_int_p"; } else if (strcmp(type,"short") == 0) { sz = sizeof(short)*numelements; cast = "_short_p"; } else if (strcmp(type,"long") == 0) { sz = sizeof(long)*numelements; cast = "_long_p"; } else if (strcmp(type,"double") == 0) { sz = sizeof(double)*numelements; cast = "_double_p"; } else if (strcmp(type,"float") == 0) { sz = sizeof(float)*numelements; cast = "_float_p"; } else if (strcmp(type,"char") == 0) { sz = sizeof(char)*numelements; cast = "_char_p"; } else if (strcmp(type,"char *") == 0) { sz = sizeof(char *)*(numelements+1); cast = "_char_pp"; } else if (strcmp(type,"void") == 0) { sz = numelements; } else { Tcl_SetResult(interp,"Unable to create unknown datatype.",TCL_STATIC); return TCL_ERROR; } /* Create the new object */ ptr = (void *) malloc(sz); if (!ptr) { Tcl_SetResult(interp,"Out of memory in ptrcreate.",TCL_STATIC); return TCL_ERROR; } /* Now try to set its default value */ if (_ptrvalue) { if (strcmp(type,"int") == 0) { int *ip,i,ivalue; Tcl_GetInt(interp,_ptrvalue,&ivalue); ip = (int *) ptr; for (i = 0; i < numelements; i++) ip[i] = ivalue; } else if (strcmp(type,"short") == 0) { short *ip; int i, ivalue; Tcl_GetInt(interp,_ptrvalue,&ivalue); ip = (short *) ptr; for (i = 0; i < numelements; i++) ip[i] = (short) ivalue; } else if (strcmp(type,"long") == 0) { long *ip; int i, ivalue; Tcl_GetInt(interp,_ptrvalue,&ivalue); ip = (long *) ptr; for (i = 0; i < numelements; i++) ip[i] = (long) ivalue; } else if (strcmp(type,"double") == 0) { double *ip,ivalue; int i; Tcl_GetDouble(interp,_ptrvalue,&ivalue); ip = (double *) ptr; for (i = 0; i < numelements; i++) ip[i] = ivalue; } else if (strcmp(type,"float") == 0) { float *ip; double ivalue; int i; Tcl_GetDouble(interp,_ptrvalue,&ivalue); ip = (float *) ptr; for (i = 0; i < numelements; i++) ip[i] = (double) ivalue; } else if (strcmp(type,"char") == 0) { char *ip,*ivalue; ivalue = (char *) _ptrvalue; ip = (char *) ptr; strncpy(ip,ivalue,numelements-1); } else if (strcmp(type,"char *") == 0) { char **ip, *ivalue; int i; ivalue = (char *) _ptrvalue; ip = (char **) ptr; for (i = 0; i < numelements; i++) { if (ivalue) { ip[i] = (char *) malloc(strlen(ivalue)+1); strcpy(ip[i],ivalue); } else { ip[i] = 0; } } ip[numelements] = 0; } } /* Create the pointer value */ SWIG_MakePtr(temp,ptr,cast); Tcl_SetResult(interp,temp,TCL_VOLATILE); return TCL_OK; } /*------------------------------------------------------------------ ptrset(ptr,value,index = 0,type = 0) Attempts to set the value of a pointer variable. If type is given, we will use that type. Otherwise, we'll guess the datatype. ------------------------------------------------------------------ */ static int ptrset(Tcl_Interp *interp, char *_PTRVALUE, char *_VALUE, int index, char *type) { void *ptr; char *s; s = _PTRVALUE; if (SWIG_GetPtr(s,&ptr,0)) { Tcl_SetResult(interp,"Type error in ptrset. Argument is not a valid pointer value.", TCL_STATIC); return TCL_ERROR; } /* If no datatype was passed, try a few common datatypes first */ if (!type) { /* No datatype was passed. Type to figure out if it's a common one */ if (!SWIG_GetPtr(s,&ptr,"_int_p")) { type = "int"; } else if (!SWIG_GetPtr(s,&ptr,"_double_p")) { type = "double"; } else if (!SWIG_GetPtr(s,&ptr,"_short_p")) { type = "short"; } else if (!SWIG_GetPtr(s,&ptr,"_long_p")) { type = "long"; } else if (!SWIG_GetPtr(s,&ptr,"_float_p")) { type = "float"; } else if (!SWIG_GetPtr(s,&ptr,"_char_p")) { type = "char"; } else if (!SWIG_GetPtr(s,&ptr,"_char_pp")) { type = "char *"; } else { type = "unknown"; } } if (!ptr) { Tcl_SetResult(interp,"Unable to set NULL pointer.",TCL_STATIC); return TCL_ERROR; } /* Now we have a datatype. Try to figure out what to do about it */ if (strcmp(type,"int") == 0) { int ivalue; Tcl_GetInt(interp,_VALUE, &ivalue); *(((int *) ptr)+index) = ivalue; } else if (strcmp(type,"double") == 0) { double ivalue; Tcl_GetDouble(interp,_VALUE, &ivalue); *(((double *) ptr)+index) = (double) ivalue; } else if (strcmp(type,"short") == 0) { int ivalue; Tcl_GetInt(interp,_VALUE, &ivalue); *(((short *) ptr)+index) = (short) ivalue; } else if (strcmp(type,"long") == 0) { int ivalue; Tcl_GetInt(interp,_VALUE, &ivalue); *(((long *) ptr)+index) = (long) ivalue; } else if (strcmp(type,"float") == 0) { double ivalue; Tcl_GetDouble(interp,_VALUE, &ivalue); *(((float *) ptr)+index) = (float) ivalue; } else if (strcmp(type,"char") == 0) { char *c = _VALUE; strcpy(((char *) ptr)+index, c); } else if (strcmp(type,"char *") == 0) { char *c = _VALUE; char **ca = (char **) ptr; if (ca[index]) free(ca[index]); if (strcmp(c,"NULL") == 0) { ca[index] = 0; } else { ca[index] = (char *) malloc(strlen(c)+1); strcpy(ca[index],c); } } else { Tcl_SetResult(interp,"Unable to set unsupported datatype.",TCL_STATIC); return TCL_ERROR; } return TCL_OK; } /*------------------------------------------------------------------ ptradd(ptr,offset) Adds a value to an existing pointer value. Will do a type-dependent add for basic datatypes. For other datatypes, will do a byte-add. ------------------------------------------------------------------ */ static int ptradd(Tcl_Interp *interp, char *_PTRVALUE, int offset) { char *r,*s; void *ptr,*junk; char *type; /* Check to see what kind of object _PTRVALUE is */ s = _PTRVALUE; /* Try to handle a few common datatypes first */ if (!SWIG_GetPtr(s,&ptr,"_int_p")) { ptr = (void *) (((int *) ptr) + offset); } else if (!SWIG_GetPtr(s,&ptr,"_double_p")) { ptr = (void *) (((double *) ptr) + offset); } else if (!SWIG_GetPtr(s,&ptr,"_short_p")) { ptr = (void *) (((short *) ptr) + offset); } else if (!SWIG_GetPtr(s,&ptr,"_long_p")) { ptr = (void *) (((long *) ptr) + offset); } else if (!SWIG_GetPtr(s,&ptr,"_float_p")) { ptr = (void *) (((float *) ptr) + offset); } else if (!SWIG_GetPtr(s,&ptr,"_char_p")) { ptr = (void *) (((char *) ptr) + offset); } else if (!SWIG_GetPtr(s,&ptr,0)) { ptr = (void *) (((char *) ptr) + offset); } else { Tcl_SetResult(interp,"Type error in ptradd. Argument is not a valid pointer value.",TCL_STATIC); return TCL_ERROR; } type = SWIG_GetPtr(s,&junk,"INVALID POINTER"); r = (char *) malloc(strlen(type)+20); if (ptr) { SWIG_MakePtr(r,ptr,type); } else { sprintf(r,"_0%s",type); } Tcl_SetResult(interp,r,TCL_VOLATILE); free(r); return TCL_OK; } /*------------------------------------------------------------------ ptrmap(type1,type2) Allows a mapping between type1 and type2. (Like a typedef) ------------------------------------------------------------------ */ static void ptrmap(char *type1, char *type2) { char *typestr1,*typestr2,*c,*r; /* Produce a "mangled" version of the type string. */ typestr1 = (char *) malloc(strlen(type1)+2); /* Go through and munge the typestring */ r = typestr1; *(r++) = '_'; c = type1; while (*c) { if (!isspace(*c)) { if ((*c == '*') || (*c == '&')) { *(r++) = 'p'; } else *(r++) = *c; } else { *(r++) = '_'; } c++; } *(r++) = 0; typestr2 = (char *) malloc(strlen(type2)+2); /* Go through and munge the typestring */ r = typestr2; *(r++) = '_'; c = type2; while (*c) { if (!isspace(*c)) { if ((*c == '*') || (*c == '&')) { *(r++) = 'p'; } else *(r++) = *c; } else { *(r++) = '_'; } c++; } *(r++) = 0; SWIG_RegisterMapping(typestr1,typestr2,0); SWIG_RegisterMapping(typestr2,typestr1,0); } /*------------------------------------------------------------------ ptrfree(ptr) Destroys a pointer value ------------------------------------------------------------------ */ int ptrfree(Tcl_Interp *interp, char *_PTRVALUE) { void *ptr, *junk; char *s; s = _PTRVALUE; if (SWIG_GetPtr(s,&ptr,0)) { Tcl_SetResult(interp,"Type error in ptrfree. Argument is not a valid pointer value.",TCL_STATIC); return TCL_ERROR; } /* Check to see if this pointer is a char ** */ if (!SWIG_GetPtr(s,&junk,"_char_pp")) { char **c = (char **) ptr; if (c) { int i = 0; while (c[i]) { free(c[i]); i++; } } } if (ptr) free((char *) ptr); return TCL_OK; } %} %typemap(tcl,out) int ptrcast, int ptrvalue, int ptrcreate, int ptrset, int ptradd, int ptrfree { return $source; } %typemap(tcl8,out) int ptrcast, int ptrvalue, int ptrcreate, int ptrset, int ptradd, int ptrfree { return $source; } // Ignore the Tcl_Interp * value, but set it to a value %typemap(tcl,ignore) Tcl_Interp * { $target = interp; } %typemap(tcl8,ignore) Tcl_Interp * { $target = interp; } int ptrcast(Tcl_Interp *interp, char *ptr, char *type); // Casts a pointer ptr to a new datatype given by the string type. // type may be either the SWIG generated representation of a datatype // or the C representation. For example : // // ptrcast $ptr double_p # Tcl representation // ptrcast $ptr "double *" # C representation // // A new pointer value is returned. ptr may also be an integer // value in which case the value will be used to set the pointer // value. For example : // // set a [ptrcast 0 Vector_p] // // Will create a NULL pointer of type "Vector_p" // // The casting operation is sensitive to formatting. As a result, // "double *" is different than "double*". As a result of thumb, // there should always be exactly one space between the C datatype // and any pointer specifiers (*). int ptrvalue(Tcl_Interp *interp, char *ptr, int index = 0, char *type = 0); // Returns the value that a pointer is pointing to (ie. dereferencing). // The type is automatically inferred by the pointer type--thus, an // integer pointer will return an integer, a double will return a double, // and so on. The index and type fields are optional parameters. When // an index is specified, this function returns the value of ptr[index]. // This allows array access. When a type is specified, it overrides // the given pointer type. Examples : // // ptrvalue $a # Returns the value *a // ptrvalue $a 10 # Returns the value a[10] // ptrvalue $a 10 double # Returns a[10] assuming a is a double * int ptrset(Tcl_Interp *interp, char *ptr, char *value, int index = 0, char *type = 0); // Sets the value pointed to by a pointer. The type is automatically // inferred from the pointer type so this function will work for // integers, floats, doubles, etc... The index and type fields are // optional. When an index is given, it provides array access. When // type is specified, it overrides the given pointer type. Examples : // // ptrset $a 3 # Sets the value *a = 3 // ptrset $a 3 10 # Sets a[10] = 3 // ptrset $a 3 10 int # Sets a[10] = 3 assuming a is a int * int ptrcreate(Tcl_Interp *interp, char *type, char *value = 0, int nitems = 1); // Creates a new object and returns a pointer to it. This function // can be used to create various kinds of objects for use in C functions. // type specifies the basic C datatype to create and value is an // optional parameter that can be used to set the initial value of the // object. nitems is an optional parameter that can be used to create // an array. This function results in a memory allocation using // malloc(). Examples : // // set a [ptrcreate "double"] # Create a new double, return pointer // set a [ptrcreate int 7] # Create an integer, set value to 7 // set a [ptrcreate int 0 1000] # Create an integer array with initial // # values all set to zero // // This function only recognizes a few common C datatypes as listed below : // // int, short, long, float, double, char, char *, void // // All other datatypes will result in an error. However, other // datatypes can be created by using the ptrcast function. For // example: // // set a [ptrcast [ptrcreate int 0 100],"unsigned int *"] int ptrfree(Tcl_Interp *interp, char *ptr); // Destroys the memory pointed to by ptr. This function calls free() // and should only be used with objects created by ptrcreate(). Since // this function calls free, it may work with other objects, but this // is generally discouraged unless you absolutely know what you're // doing. int ptradd(Tcl_Interp *interp, char *ptr, int offset); // Adds a value to the current pointer value. For the C datatypes of // int, short, long, float, double, and char, the offset value is the // number of objects and works in exactly the same manner as in C. For // example, the following code steps through the elements of an array // // set a [ptrcreate double 0 100] # Create an array double a[100] // set b $a // for {set i 0} {$i < 100} {incr i 1} { // ptrset $b [expr{0.0025*$i}] # set *b = 0.0025*i // set b [ptradd $b 1] # b++ (go to next double) // } // // In this case, adding one to b goes to the next double. // // For all other datatypes (including all complex datatypes), the // offset corresponds to bytes. This function does not perform any // bounds checking and negative offsets are perfectly legal. void ptrmap(char *type1, char *type2); // This is a rarely used function that performs essentially the same // operation as a C typedef. To manage datatypes at run-time, SWIG // modules manage an internal symbol table of type mappings. This // table keeps track of which types are equivalent to each other. The // ptrmap() function provides a mechanism for scripts to add symbols // to this table. For example : // // ptrmap double_p Real_p // // would make the types "double_p" and "Real_p" equivalent to each // other. Pointers of either type could now be used interchangably. // // Normally this function is not needed, but it can be used to // circumvent SWIG's normal type-checking behavior or to work around // weird type-handling bugs. // Clear the ignore typemap %typemap(tcl,ignore) Tcl_Interp *; %typemap(tcl8,ignore) Tcl_Interp *;