1 ! Copyright (C) 2004, 2010 Slava Pestov.
2 ! See https://factorcode.org/license.txt for BSD license.
3 USING: accessors assocs byte-arrays byte-vectors continuations
4 continuations.private kernel kernel.private math namespaces
6 USE: init ! required but does not reference words
9 BUILTIN: alien { underlying c-ptr read-only initial: f } expired ;
10 BUILTIN: dll { path byte-array read-only initial: B{ } } ;
12 PRIMITIVE: <callback> ( word return-rewind -- alien )
13 PRIMITIVE: <displaced-alien> ( displacement c-ptr -- alien )
14 PRIMITIVE: alien-address ( c-ptr -- addr )
15 PRIMITIVE: free-callback ( alien -- )
18 PRIMITIVE: current-callback ( -- n )
21 PREDICATE: pinned-alien < alien underlying>> not ;
23 UNION: pinned-c-ptr pinned-alien POSTPONE: f ;
25 GENERIC: element-size ( seq -- n ) flushable
27 M: byte-array element-size drop 1 ; inline
29 M: byte-vector element-size drop 1 ; inline
31 M: slice element-size seq>> element-size ; inline
33 M: f element-size drop 1 ; inline
35 GENERIC: byte-length ( obj -- n ) flushable
37 M: object byte-length [ length ] [ element-size ] bi * ; inline
39 GENERIC: >c-ptr ( obj -- c-ptr ) flushable
41 M: c-ptr >c-ptr ; inline
44 [ [ from>> ] [ element-size ] bi * ] [ seq>> >c-ptr ] bi
45 <displaced-alien> ; inline
49 M: object >c-ptr underlying>> ; inline
51 : binary-object ( obj -- c-ptr n )
52 [ >c-ptr ] [ byte-length ] bi ; inline
54 GENERIC: expired? ( c-ptr -- ? ) flushable
56 M: alien expired? expired>> ;
58 M: f expired? drop t ;
60 : <alien> ( address -- alien )
61 f <displaced-alien> { pinned-c-ptr } declare ; inline
63 : <bad-alien> ( -- alien )
64 -1 <alien> t >>expired ; inline
68 2dup [ expired? ] either? [
71 [ alien-address ] same?
77 M: pinned-alien hashcode*
78 nip dup expired>> [ drop 1234 ] [ alien-address ] if ;
80 SINGLETONS: stdcall thiscall fastcall cdecl mingw ;
82 UNION: abi stdcall thiscall fastcall cdecl mingw ;
84 : callee-cleanup? ( abi -- ? )
85 { stdcall fastcall thiscall } member? ;
87 ERROR: callsite-not-compiled word ;
89 : alien-assembly ( args... return parameters abi quot -- return... )
90 \ alien-assembly callsite-not-compiled ;
92 : alien-callback ( return parameters abi quot -- alien )
93 \ alien-callback callsite-not-compiled ;
95 : alien-indirect ( args... funcptr return parameters abi -- return... )
96 \ alien-indirect callsite-not-compiled ;
98 : alien-invoke ( args... return library function parameters varargs? -- return... )
99 \ alien-invoke callsite-not-compiled ;
103 ! Callbacks are registered in a global hashtable. Note that they
104 ! are also pinned in a special callback area, so clearing this
105 ! hashtable will not reclaim callbacks. It should only be
106 ! cleared on startup.
109 STARTUP-HOOK: [ H{ } clone callbacks set-global ]
111 ! Used by compiler.codegen to wrap callback bodies
112 : do-callback ( callback-quot wait-quot: ( callback -- ) -- )
113 t CONTEXT-OBJ-IN-CALLBACK-P set-context-object
117 [ 2drop call ] [ swap call( callback -- ) drop ] 3bi ; inline
119 ! A utility for defining global variables that are recompiled in
121 TUPLE: expiry-check object alien ;
123 : recompute-value? ( check -- ? )
124 [ alien>> expired? ] [ t ] if* ;
126 : delete-values ( value assoc -- )
127 [ nipd = ] with assoc-reject! drop ;
131 : unregister-and-free-callback ( alien -- )
132 [ callbacks get delete-values ] [ free-callback ] bi ;
134 : with-callback ( alien quot -- )
135 over [ unregister-and-free-callback ] curry finally ; inline
137 : initialize-alien ( symbol quot -- )
138 swap dup get-global dup recompute-value?
139 [ drop [ call dup 31337 <alien> expiry-check boa ] dip set-global ]
140 [ 2nip object>> ] if ; inline