\ lib.fs shared library support package 16aug03py
\ Copyright (C) 1995,1996,1997,1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
\ Gforth 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
\ of the License, or (at your option) any later version.
\ This program 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 this program; if not, write to the Free Software
\ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
Variable libs 0 libs !
\ links between libraries
Variable thisproc
Variable thislib
Variable revdec revdec off
\ turn revdec on to compile bigFORTH libraries
Variable revarg revarg off
\ turn revarg on to compile declarations with reverse arguments
Variable legacy legacy off
\ turn legacy on to compile bigFORTH legacy libraries
Vocabulary c-decl
Vocabulary cb-decl
: @lib ( lib -- )
\G obtains library handle
cell+ dup 2 cells + count open-lib
dup 0= abort" Library not found" swap ! ;
: @proc ( lib addr -- )
\G obtains symbol address
cell+ tuck cell+ @ count rot cell+ @
lib-sym dup 0= abort" Proc not found!" swap ! ;
: proc, ( lib -- )
\G allocates and initializes proc stub
\G stub format:
\G linked list in library
\G address of proc
\G ptr to OS name of symbol as counted string
\G threaded code for invocation
here dup thisproc !
swap 2 cells + dup @ A, !
0 , 0 A, ;
Defer legacy-proc ' noop IS legacy-proc
: proc: ( lib "name" -- )
\G Creates a named proc stub
Create proc, 0 also c-decl
legacy @ IF legacy-proc THEN
DOES> ( x1 .. xn -- r )
dup cell+ @ swap 3 cells + >r ;
: library ( "name" "file" -- )
\G loads library "file" and creates a proc defining word "name"
\G library format:
\G linked list of libraries
\G library handle
\G linked list of library's procs
\G OS name of library as counted string
Create here libs @ A, dup libs !
0 , 0 A, bl sword string, @lib
DOES> ( -- ) dup thislib ! proc: ;
: init-shared-libs ( -- )
defers 'cold libs
0 libs BEGIN @ dup WHILE dup REPEAT drop
BEGIN dup WHILE >r
r@ @lib
r@ 2 cells + BEGIN @ dup WHILE r@ over @proc REPEAT
drop rdrop
REPEAT drop ;
' init-shared-libs IS 'cold
: argtype ( revxt pushxt fwxt "name" -- )
Create , , , ;
: arg@ ( arg -- argxt pushxt )
revarg @ IF 2 cells + @ ['] noop swap ELSE 2@ THEN ;
: arg, ( xt -- )
dup ['] noop = IF drop EXIT THEN compile, ;
: decl, ( 0 arg1 .. argn call start -- )
2@ compile, >r
revdec @ IF 0 >r
BEGIN dup WHILE >r REPEAT
BEGIN r> dup WHILE arg@ arg, REPEAT drop
BEGIN dup WHILE arg, REPEAT drop
ELSE 0 >r
BEGIN dup WHILE arg@ arg, >r REPEAT drop
BEGIN r> dup WHILE arg, REPEAT drop
THEN
r> compile, postpone EXIT ;
: symbol, ( "c-symbol" -- )
here thisproc @ 2 cells + ! bl sword s,
thislib @ thisproc @ @proc ;
: rettype ( endxt startxt "name" -- )
Create 2,
DOES> decl, symbol, previous revarg off ;
also c-decl definitions
: <rev> revarg on ;
' av-int ' av-int-r ' >r argtype int
' av-float ' av-float-r ' f>l argtype sf
' av-double ' av-double-r ' f>l argtype df
' av-longlong ' av-longlong-r ' 2>r argtype llong
' av-ptr ' av-ptr-r ' >r argtype ptr
' av-call-void ' av-start-void rettype (void)
' av-call-int ' av-start-int rettype (int)
' av-call-float ' av-start-float rettype (sf)
' av-call-double ' av-start-double rettype (fp)
' av-call-longlong ' av-start-longlong rettype (llong)
' av-call-ptr ' av-start-ptr rettype (ptr)
previous definitions
\ legacy support for old library interfaces
\ interface to old vararg stuff not implemented yet
also c-decl
:noname ( n 0 -- 0 int1 .. intn )
legacy @ 0< revarg !
swap 0 ?DO int LOOP (int)
; IS legacy-proc
: (int) ( n -- )
>r ' execute r> 0 ?DO int LOOP (int) ;
: (void) ( n -- )
>r ' execute r> 0 ?DO int LOOP (void) ;
: (float) ( n -- )
>r ' execute r> 0 ?DO df LOOP (fp) ;
previous
\ callback stuff
Variable callbacks
\G link between callbacks
: callback ( -- )
Create 0 ] postpone >r also cb-decl
DOES>
Create here >r 0 , callbacks @ A, r@ callbacks !
swap postpone Literal postpone call , postpone EXIT
r> dup cell+ cell+ alloc-callback swap !
DOES> @ ;
: callback; ( 0 xt1 .. xtn -- )
BEGIN over WHILE compile, REPEAT
postpone r> postpone execute compile, drop
postpone EXIT postpone [ previous ; immediate
: va-ret ( xt xt -- )
Create A, A, immediate
DOES> 2@ compile, ;
: init-callbacks ( -- )
defers 'cold callbacks 1 cells -
BEGIN cell+ @ dup WHILE dup cell+ cell+ alloc-callback over !
REPEAT drop ;
' init-callbacks IS 'cold
also cb-decl definitions
\ arguments
' va-arg-int Alias int
' va-arg-float Alias sf
' va-arg-double Alias df
' va-arg-longlong Alias llong
' va-arg-ptr Alias ptr
' va-return-void ' va-start-void va-ret (void)
' va-return-int ' va-start-int va-ret (int)
' va-return-float ' va-start-float va-ret (sf)
' va-return-double ' va-start-double va-ret (fp)
' va-return-longlong ' va-start-longlong va-ret (llong)
' va-return-ptr ' va-start-ptr va-ret (ptr)
previous definitions
\ testing stuff
[ifdef] testing
library libc libc.so.6
libc sleep int (int) sleep
libc open int int ptr (int) open
libc lseek int llong int (llong) lseek64
libc read int ptr int (int) read
libc close int (int) close
library libm libm.so.6
libm fmodf sf sf (sf) fmodf
libm fmod df df (fp) fmod
\ example for a windows callback
callback wincall (int) int int int int callback;
:noname ( a b c d -- e ) 2drop 2drop 0 ; wincall do_timer
\ test a callback
callback 2:1 (int) int int callback;
: cb-test ( a b -- c )
cr ." Testing callback"
cr ." arguments: " .s
cr ." result " + .s cr ;
' cb-test 2:1 c_plus
: test c_plus av-start-int >r >r av-int-r av-int-r av-call-int ;
\ 3 4 test
\ bigFORTH legacy library test
library libX11 libX11.so.6
legacy on
1 libX11 XOpenDisplay XOpenDisplay ( name -- dpy )
5 libX11 XInternAtoms XInternAtoms ( atoms flag count names dpy -- status )
legacy off
[then]
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>