fix some db docs
[factor/jcg.git] / basis / hints / hints.factor
blobb6af773ce523389cb13e2c041617ba8762f32726
1 ! Copyright (C) 2008 Slava Pestov.
2 ! See http://factorcode.org/license.txt for BSD license.
3 USING: parser words definitions kernel sequences assocs arrays
4 kernel.private fry combinators accessors vectors strings sbufs
5 byte-arrays byte-vectors io.binary io.streams.string splitting
6 math generic generic.standard generic.standard.engines classes
7 hashtables ;
8 IN: hints
10 GENERIC: specializer-predicate ( spec -- quot )
12 M: class specializer-predicate "predicate" word-prop ;
14 M: object specializer-predicate '[ _ eq? ] ;
16 GENERIC: specializer-declaration ( spec -- class )
18 M: class specializer-declaration ;
20 M: object specializer-declaration class ;
22 : make-specializer ( specs -- quot )
23     dup length <reversed>
24     [ (picker) 2array ] 2map
25     [ drop object eq? not ] assoc-filter
26     [ [ t ] ] [
27         [ swap specializer-predicate append ] { } assoc>map
28         unclip [ swap [ f ] \ if 3array append [ ] like ] reduce
29     ] if-empty ;
31 : specializer-cases ( quot word -- default alist )
32     dup [ array? ] all? [ 1array ] unless [
33         [ make-specializer ] keep
34         [ specializer-declaration ] map '[ _ declare ] pick append
35     ] { } map>assoc ;
37 : method-declaration ( method -- quot )
38     [ "method-generic" word-prop dispatch# object <array> ]
39     [ "method-class" word-prop ]
40     bi prefix ;
42 : specialize-method ( quot method -- quot' )
43     method-declaration '[ _ declare ] prepend ;
45 : specialize-quot ( quot specializer -- quot' )
46     specializer-cases alist>quot ;
48 : standard-method? ( method -- ? )
49     dup method-body? [
50         "method-generic" word-prop standard-generic?
51     ] [ drop f ] if ;
53 : specialized-def ( word -- quot )
54     [ def>> ] keep
55     [ dup standard-method? [ specialize-method ] [ drop ] if ]
56     [ "specializer" word-prop [ specialize-quot ] when* ]
57     bi ;
59 : specialized-length ( specializer -- n )
60     dup [ array? ] all? [ first ] when length ;
62 : HINTS:
63     scan-object
64     dup method-spec? [ first2 method ] when
65     [ redefined ]
66     [ parse-definition "specializer" set-word-prop ] bi ;
67     parsing
69 ! Default specializers
70 { first first2 first3 first4 }
71 [ { array } "specializer" set-word-prop ] each
73 { peek pop* pop } [
74     { vector } "specializer" set-word-prop
75 ] each
77 \ push { { vector } { sbuf } } "specializer" set-word-prop
79 \ push-all
80 { { string sbuf } { array vector } { byte-array byte-vector } }
81 "specializer" set-word-prop
83 \ append
84 { { string string } { array array } }
85 "specializer" set-word-prop
87 \ subseq
88 { { fixnum fixnum string } { fixnum fixnum array } }
89 "specializer" set-word-prop
91 \ reverse-here
92 { { string } { array } }
93 "specializer" set-word-prop
95 \ mismatch
96 { string string }
97 "specializer" set-word-prop
99 \ find-last-sep { string sbuf } "specializer" set-word-prop
101 \ >string { sbuf } "specializer" set-word-prop
103 \ >array { { vector } } "specializer" set-word-prop
105 \ >vector { { array } { vector } } "specializer" set-word-prop
107 \ >sbuf { string } "specializer" set-word-prop
109 \ split, { string string } "specializer" set-word-prop
111 \ memq? { array } "specializer" set-word-prop
113 \ member? { array } "specializer" set-word-prop
115 \ assoc-stack { vector } "specializer" set-word-prop
117 \ >le { { fixnum fixnum } { bignum fixnum } } "specializer" set-word-prop
119 \ >be { { bignum fixnum } { fixnum fixnum } } "specializer" set-word-prop
121 \ hashtable \ at* method { { fixnum hashtable } { word hashtable } } "specializer" set-word-prop
123 \ hashtable \ set-at method { { object fixnum object } { object word object } } "specializer" set-word-prop