version 1.16, 2007/05/31 18:10:39
|
version 1.62, 2009/12/27 01:00:52
|
Line 1
|
Line 1
|
\ libcc.fs foreign function interface implemented using a C compiler |
\ libcc.fs foreign function interface implemented using a C compiler |
|
|
\ Copyright (C) 2006 Free Software Foundation, Inc. |
\ Copyright (C) 2006,2007,2008 Free Software Foundation, Inc. |
|
|
\ This file is part of Gforth. |
\ This file is part of Gforth. |
|
|
\ Gforth is free software; you can redistribute it and/or |
\ Gforth is free software; you can redistribute it and/or |
\ modify it under the terms of the GNU General Public License |
\ modify it under the terms of the GNU General Public License |
\ as published by the Free Software Foundation; either version 2 |
\ as published by the Free Software Foundation, either version 3 |
\ of the License, or (at your option) any later version. |
\ of the License, or (at your option) any later version. |
|
|
\ This program is distributed in the hope that it will be useful, |
\ This program is distributed in the hope that it will be useful, |
Line 15
|
Line 15
|
\ GNU General Public License for more details. |
\ GNU General Public License for more details. |
|
|
\ You should have received a copy of the GNU General Public License |
\ You should have received a copy of the GNU General Public License |
\ along with this program; if not, write to the Free Software |
\ along with this program. If not, see http://www.gnu.org/licenses/. |
\ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA. |
|
|
|
|
|
\ What this implementation does is this: if it sees a declaration like |
\ What this implementation does is this: if it sees a declaration like |
Line 68
|
Line 67
|
\ The files are built in .../lib/gforth/$VERSION/libcc/ or |
\ The files are built in .../lib/gforth/$VERSION/libcc/ or |
\ ~/.gforth/libcc/$HOST/. |
\ ~/.gforth/libcc/$HOST/. |
|
|
\ other things to do: |
\ Todo: conversion between function pointers and xts (both directions) |
|
|
\ c-variable forth-name c-name |
\ taking an xt and turning it into a function pointer: |
\ c-constant forth-name c-name |
|
|
\ e.g., assume we have the xt of + and want to create a C function int |
|
\ gforth_callback_plus(int, int), and then pass the pointer to that |
|
\ function: |
|
|
|
\ There should be Forth code like this: |
|
\ ] + 0 (bye) |
|
\ Assume that the start of this code is START |
|
|
|
\ Now, there should be a C function: |
|
|
|
\ int gforth_callback_plus(int p1, int p2) |
|
\ { |
|
\ Cell *sp = gforth_SP; |
|
\ Float *fp = gforth_FP; |
|
\ Float *fp = gforth_FP; |
|
\ Address lp = gforth_LP; |
|
\ sp -= 2; |
|
\ sp[0] = p1; |
|
\ sp[1] = p2; |
|
\ gforth_engine(START, sp, rp, fp, lp); |
|
\ sp += 1; |
|
\ gforth_RP = rp; |
|
\ gforth_SP = sp; |
|
\ gforth_FP = fp; |
|
\ gforth_LP = lp; |
|
\ return sp[0]; |
|
\ } |
|
|
|
\ and the pointer to that function is the C function pointer for the XT of +. |
|
|
|
\ Future problems: |
|
\ how to combine the Forth code generation with inlining |
|
\ START is not a constant across executions (when caching the C files) |
|
\ Solution: make START a variable, and store into it on startup with dlsym |
|
|
|
\ Syntax: |
|
\ callback <rettype> <params> <paramtypes> -- <rettype> |
|
|
|
|
\ data structures |
\ data structures |
Line 82
|
Line 118
|
\ first-time word, then to the run-time word; the run-time word calls |
\ first-time word, then to the run-time word; the run-time word calls |
\ the c function. |
\ the c function. |
|
|
|
[ifundef] parse-name |
|
' parse-word alias parse-name |
|
[then] |
|
[ifundef] defer! |
|
: defer! ( xt xt-deferred -- ) \ gforth defer-store |
|
\G Changes the @code{defer}red word @var{xt-deferred} to execute @var{xt}. |
|
>body [ has? rom [IF] ] @ [ [THEN] ] ! ; |
|
[then] |
|
|
|
\ : delete-file 2drop 0 ; |
|
|
require struct.fs |
require struct.fs |
|
require mkdir.fs |
|
|
\ counted-string |
|
|
|
\ c-function-ft word body: |
\ c-function-ft word body: |
struct |
struct |
cell% field cff-cfr \ xt of c-function-rt word |
cell% field cff-cfr \ xt of c-function-rt word |
cell% field cff-deferred \ xt of c-function deferred word |
cell% field cff-deferred \ xt of c-function deferred word |
cell% field cff-lha \ address of the lib-handle for the lib that |
cell% field cff-lha \ address of the lib-handle for the lib that |
\ contains the wrapper function of the word |
\ contains the wrapper function of the word |
|
char% field cff-ctype \ call type (function=1, value=0) |
char% field cff-rtype \ return type |
char% field cff-rtype \ return type |
char% field cff-np \ number of parameters |
char% field cff-np \ number of parameters |
1 0 field cff-ptypes \ #npar parameter types |
1 0 field cff-ptypes \ #npar parameter types |
Line 104 variable c-source-file-id \ contains the
|
Line 150 variable c-source-file-id \ contains the
|
variable lib-handle-addr \ points to the library handle of the current batch. |
variable lib-handle-addr \ points to the library handle of the current batch. |
\ the library handle is 0 if the current |
\ the library handle is 0 if the current |
\ batch is not yet compiled. |
\ batch is not yet compiled. |
2variable lib-filename \ filename without extension |
here 0 , lib-handle-addr ! \ just make sure LIB-HANDLE always works |
|
2variable lib-filename \ filename without extension |
|
2variable lib-modulename \ basename of the file without extension |
|
2variable libcc-named-dir-v \ directory for named libcc wrapper libraries |
|
0 value libcc-path \ pointer to path of library directories |
|
|
|
defer replace-rpath ( c-addr1 u1 -- c-addr2 u2 ) |
|
' noop is replace-rpath |
|
|
: .nb ( n -- ) |
: .nb ( n -- ) |
0 .r ; |
0 .r ; |
Line 140 variable lib-handle-addr \ points to the
|
Line 193 variable lib-handle-addr \ points to the
|
|
|
\ linked list stuff (should go elsewhere) |
\ linked list stuff (should go elsewhere) |
|
|
hex |
|
|
|
struct |
struct |
cell% field list-next |
cell% field list-next |
1 0 field list-payload |
1 0 field list-payload |
Line 164 end-struct list%
|
Line 215 end-struct list%
|
node list-next @ |
node list-next @ |
repeat ; |
repeat ; |
|
|
|
2variable c-libs \ library names in a string (without "lib") |
|
|
|
: add-lib ( c-addr u -- ) \ gforth |
|
\G Add library lib@i{string} to the list of libraries, where |
|
\G @i{string} is represented by @i{c-addr u}. |
|
c-libs 2@ d0= IF 0 allocate throw 0 c-libs 2! THEN |
|
c-libs 2@ s" -l" append 2swap append c-libs 2! ; |
|
|
|
: add-libpath ( c-addr u -- ) \ gforth |
|
\G Add path @i{string} to the list of library search pathes, where |
|
\G @i{string} is represented by @i{c-addr u}. |
|
c-libs 2@ d0= IF 0 allocate throw 0 c-libs 2! THEN |
|
c-libs 2@ s" -L" append 2swap append c-libs 2! ; |
|
|
\ C prefix lines |
\ C prefix lines |
|
|
\ linked list of longcstrings: [ link | count-cell | characters ] |
\ linked list of longcstrings: [ link | count-cell | characters ] |
Line 182 variable c-prefix-lines-end c-prefix-lin
|
Line 247 variable c-prefix-lines-end c-prefix-lin
|
: print-c-prefix-lines ( -- ) |
: print-c-prefix-lines ( -- ) |
c-prefix-lines @ ['] print-c-prefix-line list-map ; |
c-prefix-lines @ ['] print-c-prefix-line list-map ; |
|
|
: save-c-prefix-line ( c-addr u -- ) |
: write-c-prefix-line ( c-addr u -- ) |
c-source-file-id @ ?dup-if |
c-source-file-id @ dup if |
>r 2dup r> write-line throw |
write-line throw |
then |
else |
|
drop 2drop |
|
then ; |
|
|
|
: save-c-prefix-line1 ( c-addr u -- ) |
|
2dup write-c-prefix-line |
align here 0 , c-prefix-lines-end list-append ( c-addr u ) |
align here 0 , c-prefix-lines-end list-append ( c-addr u ) |
longstring, ; |
longstring, ; |
|
|
: \c ( "rest-of-line" -- ) |
defer save-c-prefix-line ( c-addr u -- ) |
|
' save-c-prefix-line1 is save-c-prefix-line |
|
|
|
: \c ( "rest-of-line" -- ) \ gforth backslash-c |
|
\G One line of C declarations for the C interface |
-1 parse save-c-prefix-line ; |
-1 parse save-c-prefix-line ; |
|
|
\c #include "engine/libcc.h" |
s" #include <gforth/" version-string s+ s" /libcc.h>" append ( c-addr u ) |
|
2dup save-c-prefix-line drop free throw |
|
|
\ Types (for parsing) |
\ Types (for parsing) |
|
|
Line 213 drop
|
Line 288 drop
|
|
|
set-current |
set-current |
|
|
: parse-libcc-type ( "libcc-type" -- u ) |
\ call types |
parse-name libcc-types search-wordlist 0= -13 and throw execute ; |
0 |
|
const+ c-func |
|
const+ c-val |
|
const+ c-var |
|
drop |
|
|
|
: libcc-type ( c-addr u -- u2 ) |
|
libcc-types search-wordlist 0= -13 and throw execute ; |
|
|
: parse-function-types ( "{libcc-type}" "--" "libcc-type" -- ) |
: parse-libcc-type ( "libcc-type" -- u ) parse-name libcc-type ; |
here 2 chars allot here begin |
|
|
: parse-return-type ( "libcc-type" -- u ) |
|
parse-libcc-type dup 0< -32 and throw ; |
|
|
|
: parse-function-types ( "{libcc-type}" "--" "libcc-type" -- addr ) |
|
c-func c, here |
|
dup 2 chars allot here begin |
parse-libcc-type dup 0>= while |
parse-libcc-type dup 0>= while |
c, |
c, |
repeat |
repeat |
drop here swap - over char+ c! |
drop here swap - over char+ c! |
parse-libcc-type dup 0< -32 and throw swap c! ; |
parse-return-type swap c! ; |
|
|
|
: parse-value-type ( "{--}" "libcc-type" -- addr ) |
|
c-val c, here |
|
parse-libcc-type dup 0< if drop parse-return-type then |
|
c, 0 c, ; |
|
|
|
: parse-variable-type ( -- addr ) |
|
c-var c, here |
|
s" a" libcc-type c, 0 c, ; |
|
|
: type-letter ( n -- c ) |
: type-letter ( n -- c ) |
chars s" nadrfv" drop + c@ ; |
chars s" nadrfv" drop + c@ ; |
Line 294 create gen-par-types
|
Line 391 create gen-par-types
|
|
|
\ the call itself |
\ the call itself |
|
|
: gen-wrapped-call { d: pars d: c-name fp-change1 sp-change1 -- } |
: gen-wrapped-func { d: pars d: c-name fp-change1 sp-change1 -- } |
c-name type ." (" |
c-name type ." (" |
fp-change1 sp-change1 pars over + swap u+do |
fp-change1 sp-change1 pars over + swap u+do |
i c@ gen-par |
i c@ gen-par |
Line 304 create gen-par-types
|
Line 401 create gen-par-types
|
loop |
loop |
2drop ." )" ; |
2drop ." )" ; |
|
|
|
: gen-wrapped-const { d: pars d: c-name fp-change1 sp-change1 -- } |
|
." (" c-name type ." )" ; |
|
|
|
: gen-wrapped-var { d: pars d: c-name fp-change1 sp-change1 -- } |
|
." &(" c-name type ." )" ; |
|
|
|
create gen-call-types |
|
' gen-wrapped-func , |
|
' gen-wrapped-const , |
|
' gen-wrapped-var , |
|
|
|
: gen-wrapped-call ( pars c-name fp-change1 sp-change1 -- ) |
|
5 pick 3 chars - c@ cells gen-call-types + @ execute ; |
|
|
\ calls for various kinds of return values |
\ calls for various kinds of return values |
|
|
: gen-wrapped-void ( pars c-name fp-change1 sp-change1 -- fp-change sp-change ) |
: gen-wrapped-void ( pars c-name fp-change1 sp-change1 -- fp-change sp-change ) |
Line 320 create gen-par-types
|
Line 431 create gen-par-types
|
." ," gen-par-n ." ," gen-par-n ." )" ; |
." ," gen-par-n ." ," gen-par-n ." )" ; |
|
|
: gen-wrapped-r ( pars c-name fp-change1 sp-change1 -- fp-change sp-change ) |
: gen-wrapped-r ( pars c-name fp-change1 sp-change1 -- fp-change sp-change ) |
2dup gen-par-r 2>r ." =" gen-wrapped-void 2r> ; |
2dup gen-par-r 2>r ." =" gen-wrapped-call 2r> ; |
|
|
: gen-wrapped-func ( pars c-name fp-change1 sp-change1 -- fp-change sp-change ) |
: gen-wrapped-func ( pars c-name fp-change1 sp-change1 -- fp-change sp-change ) |
gen-wrapped-a ; |
gen-wrapped-a ; |
Line 355 create gen-wrapped-types
|
Line 466 create gen-wrapped-types
|
\ addr points to the return type index of a c-function descriptor |
\ addr points to the return type index of a c-function descriptor |
dup { descriptor } |
dup { descriptor } |
count { ret } count 2dup { d: pars } chars + count { d: c-name } |
count { ret } count 2dup { d: pars } chars + count { d: c-name } |
." void " descriptor wrapper-function-name 2dup type drop free throw |
." void " lib-modulename 2@ type ." _LTX_" descriptor wrapper-function-name 2dup type drop free throw |
.\" (void)\n" |
.\" (GFORTH_ARGS)\n" |
.\" {\n Cell MAYBE_UNUSED *sp = gforth_SP;\n Float MAYBE_UNUSED *fp = gforth_FP;\n " |
.\" {\n Cell MAYBE_UNUSED *sp = gforth_SP;\n Float MAYBE_UNUSED *fp = gforth_FP;\n " |
pars c-name 2over count-stacks ret gen-wrapped-stmt .\" ;\n" |
pars c-name 2over count-stacks ret gen-wrapped-stmt .\" ;\n" |
?dup-if |
?dup-if |
Line 367 create gen-wrapped-types
|
Line 478 create gen-wrapped-types
|
endif |
endif |
.\" }\n" ; |
.\" }\n" ; |
|
|
: tempdir ( -- c-addr u ) |
: scan-back { c-addr u1 c -- c-addr u2 } |
s" TMPDIR" getenv dup 0= if |
\ the last occurence of c in c-addr u1 is at u2-1; if it does not |
2drop s" /tmp" |
\ occur, u2=0. |
then ; |
c-addr 1- c-addr u1 + 1- u-do |
|
i c@ c = if |
|
c-addr i over - 1+ unloop exit endif |
|
1 -loop |
|
c-addr 0 ; |
|
|
|
: dirname ( c-addr1 u1 -- c-addr2 u2 ) |
|
\ directory name of the file name c-addr1 u1, including the final "/". |
|
'/ scan-back ; |
|
|
|
: basename ( c-addr1 u1 -- c-addr2 u2 ) |
|
\ file name without directory component |
|
2dup dirname nip /string ; |
|
|
: gen-filename ( x -- c-addr u ) |
: gen-filename ( x -- c-addr u ) |
\ generates a filename without extension for lib-handle-addr X |
\ generates a file basename for lib-handle-addr X |
0 <<# ['] #s $10 base-execute #> |
0 <<# ['] #s $10 base-execute #> |
tempdir s" /gforth-c-" s+ 2swap append #>> ; |
s" gforth_c_" 2swap s+ #>> ; |
|
|
|
: libcc-named-dir ( -- c-addr u ) |
|
libcc-named-dir-v 2@ ; |
|
|
|
: libcc-tmp-dir ( -- c-addr u ) |
|
s" ~/.gforth/libcc-tmp/" ; |
|
|
|
: prepend-dirname ( c-addr1 u1 c-addr2 u2 -- c-addr3 u3 ) |
|
2over s+ 2swap drop free throw ; |
|
|
|
: open-wrappers ( -- addr|0 ) |
|
lib-filename 2@ s" .la" s+ |
|
2dup libcc-named-dir string-prefix? if ( c-addr u ) |
|
\ see if we can open it in the path |
|
libcc-named-dir nip /string |
|
libcc-path open-path-file if |
|
0 exit endif |
|
( wfile-id c-addr2 u2 ) rot close-file throw save-mem ( c-addr2 u2 ) |
|
endif |
|
\ 2dup cr type |
|
2dup open-lib >r |
|
drop free throw r> ; |
|
|
|
: c-library-name-setup ( c-addr u -- ) |
|
assert( c-source-file-id @ 0= ) |
|
{ d: filename } |
|
here 0 , lib-handle-addr ! filename lib-filename 2! |
|
filename basename lib-modulename 2! |
|
['] write-c-prefix-line is save-c-prefix-line ; |
|
|
|
: c-library-name-create ( -- ) |
|
lib-filename 2@ s" .c" s+ 2dup w/o create-file throw |
|
c-source-file-id ! |
|
drop free throw ; |
|
|
|
: c-named-library-name ( c-addr u -- ) |
|
\ set up filenames for a (possibly new) library; c-addr u is the |
|
\ basename of the library |
|
libcc-named-dir prepend-dirname c-library-name-setup |
|
open-wrappers dup if |
|
lib-handle-addr @ ! |
|
else |
|
libcc-named-dir $1ff mkdir-parents drop |
|
drop c-library-name-create |
|
c-prefix-lines @ ['] print-c-prefix-line \ first line only |
|
c-source-file-id @ outfile-execute |
|
endif ; |
|
|
|
: c-tmp-library-name ( c-addr u -- ) |
|
\ set up filenames for a new library; c-addr u is the basename of |
|
\ the library |
|
libcc-tmp-dir 2dup $1ff mkdir-parents drop |
|
prepend-dirname c-library-name-setup c-library-name-create |
|
['] print-c-prefix-lines c-source-file-id @ outfile-execute ; |
|
|
|
: lib-handle ( -- addr ) |
|
lib-handle-addr @ @ ; |
|
|
: init-c-source-file ( -- ) |
: init-c-source-file ( -- ) |
c-source-file-id @ 0= if |
lib-handle 0= if |
here 0 , dup lib-handle-addr ! gen-filename 2dup lib-filename 2! |
c-source-file-id @ 0= if |
s" .c" s+ 2dup w/o create-file throw dup c-source-file-id ! |
here gen-filename c-tmp-library-name |
['] print-c-prefix-lines swap outfile-execute |
endif |
drop free throw |
|
endif ; |
endif ; |
|
|
: c-source-file ( -- file-id ) |
: c-source-file ( -- file-id ) |
c-source-file-id @ assert( dup ) ; |
c-source-file-id @ assert( dup ) ; |
|
|
: compile-wrapper-function ( -- ) |
: notype-execute ( ... xt -- ... ) |
c-source-file close-file throw |
what's type { oldtype } try |
0 c-source-file-id ! |
['] 2drop is type execute 0 |
s" gcc -I. -fPIC -shared -Wl,-soname," lib-filename 2@ s+ |
restore |
s" .so.1 -Wl,-export_dynamic -o " append lib-filename 2@ append |
oldtype is type |
s" .so.1 -O " append lib-filename 2@ append s" .c" append ( c-addr u ) |
endtry |
2dup system drop free throw |
throw ; |
$? abort" compiler generated error" \ !! call dlerror |
|
lib-filename 2@ s" .so.1" s+ |
: c-source-file-execute ( ... xt -- ... ) |
2dup open-lib dup 0= abort" open-lib failed" \ !! call dlerror |
\ direct the output of xt to c-source-file, or nothing |
( lib-handle ) lib-handle-addr @ ! |
lib-handle if |
2dup delete-file throw drop free throw |
notype-execute |
lib-filename 2@ s" .c" s+ 2dup delete-file throw drop free throw |
else |
|
c-source-file outfile-execute |
|
endif ; |
|
|
|
: .lib-error ( -- ) |
|
[ifdef] lib-error |
|
['] cr stderr outfile-execute |
|
lib-error ['] type stderr outfile-execute |
|
[then] ; |
|
|
|
DEFER compile-wrapper-function ( -- ) |
|
: compile-wrapper-function1 ( -- ) |
|
lib-handle 0= if |
|
c-source-file close-file throw |
|
0 c-source-file-id ! |
|
[ libtool-command s" --silent --mode=compile " s+ |
|
libtool-cc append s" -I '" append |
|
s" includedir" getenv append s" '" append ] sliteral |
|
s" -O -c " s+ lib-filename 2@ append s" .c -o " append |
|
lib-filename 2@ append s" .lo" append ( c-addr u ) |
|
\ 2dup type cr |
|
2dup system drop free throw $? abort" libtool compile failed" |
|
[ libtool-command s" --silent --mode=link " s+ |
|
libtool-cc append libtool-flags append s" -module -rpath " s+ ] sliteral |
|
lib-filename 2@ dirname replace-rpath s+ s" " append |
|
lib-filename 2@ append s" .lo -o " append |
|
lib-filename 2@ append s" .la" append ( c-addr u ) |
|
c-libs 2@ append |
|
\ 2dup type cr |
|
2dup system drop free throw $? abort" libtool link failed" |
|
open-wrappers dup 0= if |
|
.lib-error true abort" open-lib failed" |
|
endif |
|
( lib-handle ) lib-handle-addr @ ! |
|
endif |
lib-filename 2@ drop free throw 0 0 lib-filename 2! ; |
lib-filename 2@ drop free throw 0 0 lib-filename 2! ; |
|
' compile-wrapper-function1 IS compile-wrapper-function |
\ s" ar rcs xxx.a xxx.o" system |
\ s" ar rcs xxx.a xxx.o" system |
\ $? abort" ar generated error" ; |
\ $? abort" ar generated error" ; |
|
|
: link-wrapper-function { cff -- sym } |
: link-wrapper-function { cff -- sym } |
cff cff-rtype wrapper-function-name { d: wrapper-name } |
cff cff-rtype wrapper-function-name { d: wrapper-name } |
wrapper-name cff cff-lha @ @ assert( dup ) lib-sym dup 0= -&32 and throw |
wrapper-name cff cff-lha @ @ assert( dup ) lib-sym dup 0= if |
|
.lib-error -&32 throw |
|
endif |
wrapper-name drop free throw ; |
wrapper-name drop free throw ; |
|
|
: c-function-ft ( xt-defr xt-cfr "c-name" "{libcc-type}" "--" "libcc-type" -- ) |
: c-function-ft ( xt-defr xt-cfr xt-parse "c-name" "type signature" -- ) |
\ build time/first time action for c-function |
\ build time/first time action for c-function |
init-c-source-file |
{ xt-parse-types } init-c-source-file |
noname create 2, lib-handle-addr @ , |
noname create 2, lib-handle-addr @ , |
parse-name { d: c-name } |
parse-name { d: c-name } |
here parse-function-types c-name string, |
xt-parse-types execute c-name string, |
['] gen-wrapper-function c-source-file outfile-execute |
['] gen-wrapper-function c-source-file-execute |
does> ( ... -- ... ) |
does> ( ... -- ... ) |
dup 2@ { xt-defer xt-cfr } |
dup 2@ { xt-defer xt-cfr } |
dup cff-lha @ @ 0= if |
dup cff-lha @ @ 0= if |
Line 433 create gen-wrapped-types
|
Line 649 create gen-wrapped-types
|
does> ( ... -- ... ) |
does> ( ... -- ... ) |
@ call-c ; |
@ call-c ; |
|
|
: c-function ( "forth-name" "c-name" "{libcc-type}" "--" "libcc-type" -- ) |
: (c-function) ( xt-parse "forth-name" "c-name" "{stack effect}" -- ) |
defer lastxt dup c-function-rt lastxt c-function-ft |
{ xt-parse-types } defer lastxt dup c-function-rt |
|
lastxt xt-parse-types c-function-ft |
lastxt swap defer! ; |
lastxt swap defer! ; |
|
|
s" Library not found" exception constant err-nolib |
: c-function ( "forth-name" "c-name" "@{type@}" "---" "type" -- ) \ gforth |
|
\G Define a Forth word @i{forth-name}. @i{Forth-name} has the |
|
\G specified stack effect and calls the C function @code{c-name}. |
|
['] parse-function-types (c-function) ; |
|
|
|
: c-value ( "forth-name" "c-name" "[---]" "type" -- ) \ gforth |
|
\G Define a Forth word @i{forth-name}. @i{Forth-name} has the |
|
\G specified stack effect and gives the C value of @code{c-name}. |
|
['] parse-value-type (c-function) ; |
|
|
|
: c-variable ( "forth-name" "c-name" -- ) \ gforth |
|
\G Define a Forth word @i{forth-name}. @i{Forth-name} returns the |
|
\G address of @code{c-name}. |
|
['] parse-variable-type (c-function) ; |
|
|
|
: clear-libs ( -- ) \ gforth |
|
\G Clear the list of libs |
|
c-source-file-id @ if |
|
compile-wrapper-function |
|
endif |
|
0. c-libs 2! ; |
|
clear-libs |
|
|
|
: c-library-incomplete ( -- ) |
|
true abort" Called function of unfinished named C library" ; |
|
|
|
: c-library-name ( c-addr u -- ) \ gforth |
|
\G Start a C library interface with name @i{c-addr u}. |
|
clear-libs |
|
['] c-library-incomplete is compile-wrapper-function |
|
c-named-library-name ; |
|
|
|
: c-library ( "name" -- ) \ gforth |
|
\G Parsing version of @code{c-library-name} |
|
parse-name save-mem c-library-name ; |
|
|
|
: end-c-library ( -- ) \ gforth |
|
\G Finish and (if necessary) build the latest C library interface. |
|
['] save-c-prefix-line1 is save-c-prefix-line |
|
['] compile-wrapper-function1 is compile-wrapper-function |
|
compile-wrapper-function1 ; |
|
|
|
: init-libcc ( -- ) |
|
s" ~/.gforth/libcc-named/" libcc-named-dir-v 2! |
|
[IFDEF] make-path |
|
make-path to libcc-path |
|
libcc-named-dir libcc-path also-path |
|
[ s" libccdir" getenv ] sliteral libcc-path also-path |
|
[THEN] |
|
; |
|
|
|
init-libcc |
|
|
: library ( "name" "file" -- ) \ gforth |
:noname ( -- ) |
\G Dynamically links the library specified by @i{file}. Defines a |
defers 'cold |
\G word @i{name} ( -- lib ) that starts the declaration of a |
init-libcc ; |
\G function from that library. |
is 'cold |
create parse-name open-lib dup 0= err-nolib and throw , |
|
does> ( -- lib ) |
|
@ ; |
|