1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164
|
/******************************** -*- C -*- ****************************
*
* External definitions for C - Smalltalk interface module
*
*
***********************************************************************/
/***********************************************************************
*
* Copyright 1988,89,90,91,92,94,95,99,2000,2001,2002,2006
* Free Software Foundation, Inc.
* Written by Steve Byrne.
*
* This file is part of GNU Smalltalk.
*
* GNU Smalltalk is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation; either version 2, or (at your option) any later
* version.
*
* Linking GNU Smalltalk statically or dynamically with other modules is
* making a combined work based on GNU Smalltalk. Thus, the terms and
* conditions of the GNU General Public License cover the whole
* combination.
*
* In addition, as a special exception, the Free Software Foundation
* give you permission to combine GNU Smalltalk with free software
* programs or libraries that are released under the GNU LGPL and with
* independent programs running under the GNU Smalltalk virtual machine.
*
* You may copy and distribute such a system following the terms of the
* GNU GPL for GNU Smalltalk and the licenses of the other code
* concerned, provided that you include the source code of that other
* code when and as the GNU GPL requires distribution of source code.
*
* Note that people who make modified versions of GNU Smalltalk are not
* obligated to grant this special exception for their modified
* versions; it is their choice whether to do so. The GNU General
* Public License gives permission to release a modified version without
* this exception; this exception also makes it possible to release a
* modified version which carries forward this exception.
*
* GNU Smalltalk is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* GNU Smalltalk; see the file COPYING. If not, write to the Free Software
* Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
***********************************************************************/
#ifndef GST_CINT_H
#define GST_CINT_H
typedef enum
{ /* types for C parameters */
CDATA_CHAR,
CDATA_UCHAR,
CDATA_SHORT,
CDATA_USHORT,
CDATA_LONG,
CDATA_ULONG,
CDATA_FLOAT,
CDATA_DOUBLE,
CDATA_STRING,
CDATA_OOP, /* no conversion to-from C (OOP) */
CDATA_INT,
CDATA_UINT,
CDATA_LONG_DOUBLE,
CDATA_UNKNOWN, /* when there is no type a priori */
CDATA_STRING_OUT, /* for things that modify string params */
CDATA_SYMBOL,
CDATA_BYTEARRAY,
CDATA_BYTEARRAY_OUT,
CDATA_BOOLEAN,
CDATA_VOID, /* valid only as a return type */
CDATA_VARIADIC, /* for parameters, this param is an
array to be interpreted as
arguments. Note that only simple
conversions are performed in this
case. */
CDATA_VARIADIC_OOP, /* for parameters, this param is an
array whose elements are OOPs to be
passed. */
CDATA_COBJECT, /* a C object is being passed */
CDATA_COBJECT_PTR, /* a C object pointer is being passed */
CDATA_SELF, /* pass self as the corresponding
argument */
CDATA_SELF_OOP, /* pass self as an OOP */
CDATA_WCHAR,
CDATA_WSTRING,
CDATA_WSTRING_OUT,
CDATA_SYMBOL_OUT
}
cdata_type;
/* Value of errno which is checked by the Smalltalk base classes. */
extern int _gst_errno
ATTRIBUTE_HIDDEN;
/* Element type for the name-to-C-function mapping table. */
typedef void (*p_void_func) ();
typedef struct gst_cfunc_descriptor
{
OBJ_HEADER;
OOP cFunction; /* gst_cobject whose C value is func
addr */
OOP cFunctionName; /* Name of C function in mapping table */
OOP returnType; /* Smalltalk return type */
OOP numFixedArgs; /* number of real arguments passed from
smalltalk (excluding "self" parameters
which are synthetically added when
calling the C function). */
OOP argTypes[1]; /* variable length, really numFixedArgs
long */
}
*gst_cfunc_descriptor;
/* Invokes a C routine. Arguments passed from Smalltalk are stored starting
from ARGS, and the object to which the message that called-out was
sent is RECEIVER. CFUNCOOP is the C function descriptor used
to control the mapping of argument types from Smalltalk to C types
and determines the mapping of the C function's return type into a
Smalltalk type. The result is NULL if the call was not successful,
an OOP holding the result otherwise. */
extern OOP _gst_invoke_croutine (OOP cFuncOOP,
OOP receiver,
OOP *args)
ATTRIBUTE_HIDDEN;
/* Defines the mapping between a string function name FUNCNAME and the
address FUNCADDR of that function, for later use in
lookup_function. The mapping table will expand as needed to
hold new entries as they are added. */
extern void _gst_define_cfunc (const char *funcName, PTR funcAddr)
ATTRIBUTE_HIDDEN;
/* Adds to the mapping table the standard C functions supported by
GNU Smalltalk. */
extern void _gst_init_cfuncs (void)
ATTRIBUTE_HIDDEN;
/* Makes a C based descriptor for a callout method. Returns a
gst_cfunc_descriptor object which holds onto the descriptor. This
descriptor is subsequently used when the called out function
FUNCNAMEOOP (a Smalltalk String) is invoked. RETURNOOP is a Symbol
or CType which indicates the return type and ARGSOOP is a Smalltalk
Array containing the argument types (as Symbols). */
extern OOP _gst_make_descriptor (OOP funcNameOOP,
OOP returnTypeOOP,
OOP argsOOP)
ATTRIBUTE_HIDDEN;
/* Set the value of errno which is checked by Smalltalk to be errnum. */
extern void _gst_set_errno(int errnum)
ATTRIBUTE_HIDDEN;
#endif /* GST_CINT_H */
|