Annotation of gforth/kernel/comp.fs, revision 1.78
1.1 pazsan 1: \ compiler definitions 14sep97jaw
2:
1.74 anton 3: \ Copyright (C) 1995,1996,1997,1998,2000,2003,2004,2005 Free Software Foundation, Inc.
1.6 anton 4:
5: \ This file is part of Gforth.
6:
7: \ Gforth is free software; you can redistribute it and/or
8: \ modify it under the terms of the GNU General Public License
9: \ as published by the Free Software Foundation; either version 2
10: \ of the License, or (at your option) any later version.
11:
12: \ This program is distributed in the hope that it will be useful,
13: \ but WITHOUT ANY WARRANTY; without even the implied warranty of
14: \ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15: \ GNU General Public License for more details.
16:
17: \ You should have received a copy of the GNU General Public License
18: \ along with this program; if not, write to the Free Software
1.29 anton 19: \ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
1.6 anton 20:
1.1 pazsan 21: \ \ Revisions-Log
22:
23: \ put in seperate file 14sep97jaw
24:
25: \ \ here allot , c, A, 17dec92py
26:
1.14 jwilke 27: [IFUNDEF] allot
28: [IFUNDEF] forthstart
29: : allot ( n -- ) \ core
30: dup unused u> -8 and throw
31: dp +! ;
32: [THEN]
33: [THEN]
34:
35: \ we default to this version if we have nothing else 05May99jaw
36: [IFUNDEF] allot
1.1 pazsan 37: : allot ( n -- ) \ core
1.23 anton 38: \G Reserve @i{n} address units of data space without
39: \G initialization. @i{n} is a signed number, passing a negative
40: \G @i{n} releases memory. In ANS Forth you can only deallocate
41: \G memory from the current contiguous region in this way. In
42: \G Gforth you can deallocate anything in this way but named words.
43: \G The system does not check this restriction.
1.12 anton 44: here +
45: dup 1- usable-dictionary-end forthstart within -8 and throw
46: dp ! ;
1.14 jwilke 47: [THEN]
1.1 pazsan 48:
1.22 crook 49: : c, ( c -- ) \ core c-comma
1.15 crook 50: \G Reserve data space for one char and store @i{c} in the space.
1.1 pazsan 51: here 1 chars allot c! ;
52:
1.22 crook 53: : , ( w -- ) \ core comma
1.15 crook 54: \G Reserve data space for one cell and store @i{w} in the space.
1.1 pazsan 55: here cell allot ! ;
56:
57: : 2, ( w1 w2 -- ) \ gforth
1.15 crook 58: \G Reserve data space for two cells and store the double @i{w1
1.24 anton 59: \G w2} there, @i{w2} first (lower address).
1.1 pazsan 60: here 2 cells allot 2! ;
61:
62: \ : aligned ( addr -- addr' ) \ core
63: \ [ cell 1- ] Literal + [ -1 cells ] Literal and ;
64:
65: : align ( -- ) \ core
1.15 crook 66: \G If the data-space pointer is not aligned, reserve enough space to align it.
1.1 pazsan 67: here dup aligned swap ?DO bl c, LOOP ;
68:
1.22 crook 69: \ : faligned ( addr -- f-addr ) \ float f-aligned
1.1 pazsan 70: \ [ 1 floats 1- ] Literal + [ -1 floats ] Literal and ;
71:
1.22 crook 72: : falign ( -- ) \ float f-align
1.15 crook 73: \G If the data-space pointer is not float-aligned, reserve
74: \G enough space to align it.
1.1 pazsan 75: here dup faligned swap
76: ?DO
77: bl c,
78: LOOP ;
79:
1.9 anton 80: : maxalign ( -- ) \ gforth
1.23 anton 81: \G Align data-space pointer for all alignment requirements.
1.1 pazsan 82: here dup maxaligned swap
83: ?DO
84: bl c,
85: LOOP ;
86:
87: \ the code field is aligned if its body is maxaligned
88: ' maxalign Alias cfalign ( -- ) \ gforth
1.24 anton 89: \G Align data-space pointer for code field requirements (i.e., such
90: \G that the corresponding body is maxaligned).
1.1 pazsan 91:
92: ' , alias A, ( addr -- ) \ gforth
93:
94: ' NOOP ALIAS const
95:
96: \ \ Header 23feb93py
97:
98: \ input-stream, nextname and noname are quite ugly (passing
99: \ information through global variables), but they are useful for dealing
100: \ with existing/independent defining words
101:
102: defer (header)
103: defer header ( -- ) \ gforth
104: ' (header) IS header
105:
106: : string, ( c-addr u -- ) \ gforth
107: \G puts down string as cstring
108: dup c, here swap chars dup allot move ;
109:
1.30 anton 110: : longstring, ( c-addr u -- ) \ gforth
1.55 anton 111: \G puts down string as longcstring
1.30 anton 112: dup , here swap chars dup allot move ;
113:
1.1 pazsan 114: : header, ( c-addr u -- ) \ gforth
115: name-too-long?
1.53 anton 116: dup max-name-length @ max max-name-length !
1.1 pazsan 117: align here last !
118: current @ 1 or A, \ link field; before revealing, it contains the
119: \ tagged reveal-into wordlist
1.78 ! pazsan 120: [ has? f83headerstring [IF] ]
! 121: string,
! 122: [ [ELSE] ]
! 123: longstring, cfalign
! 124: [ [THEN] ]
1.1 pazsan 125: alias-mask lastflags cset ;
126:
127: : input-stream-header ( "name" -- )
128: name name-too-short? header, ;
129:
130: : input-stream ( -- ) \ general
131: \G switches back to getting the name from the input stream ;
132: ['] input-stream-header IS (header) ;
133:
134: ' input-stream-header IS (header)
135:
1.32 anton 136: 2variable nextname-string
1.1 pazsan 137:
1.33 pazsan 138: has? OS [IF]
1.1 pazsan 139: : nextname-header ( -- )
1.32 anton 140: nextname-string 2@ header,
141: nextname-string free-mem-var
1.1 pazsan 142: input-stream ;
1.33 pazsan 143: [THEN]
1.1 pazsan 144:
145: \ the next name is given in the string
146:
1.33 pazsan 147: has? OS [IF]
1.1 pazsan 148: : nextname ( c-addr u -- ) \ gforth
1.19 anton 149: \g The next defined word will have the name @var{c-addr u}; the
150: \g defining word will leave the input stream alone.
1.1 pazsan 151: name-too-long?
1.32 anton 152: nextname-string free-mem-var
153: save-mem nextname-string 2!
1.1 pazsan 154: ['] nextname-header IS (header) ;
1.33 pazsan 155: [THEN]
1.1 pazsan 156:
157: : noname-header ( -- )
158: 0 last ! cfalign
159: input-stream ;
160:
161: : noname ( -- ) \ gforth
1.19 anton 162: \g The next defined word will be anonymous. The defining word will
163: \g leave the input stream alone. The xt of the defined word will
1.56 anton 164: \g be given by @code{latestxt}.
1.1 pazsan 165: ['] noname-header IS (header) ;
166:
1.56 anton 167: : latestxt ( -- xt ) \ gforth
1.15 crook 168: \G @i{xt} is the execution token of the last word defined.
1.13 crook 169: \ The main purpose of this word is to get the xt of words defined using noname
1.1 pazsan 170: lastcfa @ ;
171:
1.56 anton 172: ' latestxt alias lastxt \ gforth-obsolete
173: \G old name for @code{latestxt}.
174:
175: : latest ( -- nt ) \ gforth
176: \G @var{nt} is the name token of the last word defined; it is 0 if the
177: \G last word has no name.
178: last @ ;
179:
1.1 pazsan 180: \ \ literals 17dec92py
181:
182: : Literal ( compilation n -- ; run-time -- n ) \ core
1.27 anton 183: \G Compilation semantics: compile the run-time semantics.@*
184: \G Run-time Semantics: push @i{n}.@*
185: \G Interpretation semantics: undefined.
1.14 jwilke 186: [ [IFDEF] lit, ]
187: lit,
188: [ [ELSE] ]
1.27 anton 189: postpone lit ,
1.14 jwilke 190: [ [THEN] ] ; immediate restrict
1.1 pazsan 191:
1.72 anton 192: : 2Literal ( compilation w1 w2 -- ; run-time -- w1 w2 ) \ double two-literal
193: \G Compile appropriate code such that, at run-time, @i{w1 w2} are
194: \G placed on the stack. Interpretation semantics are undefined.
195: swap postpone Literal postpone Literal ; immediate restrict
196:
1.1 pazsan 197: : ALiteral ( compilation addr -- ; run-time -- addr ) \ gforth
1.14 jwilke 198: [ [IFDEF] alit, ]
199: alit,
200: [ [ELSE] ]
201: postpone lit A,
202: [ [THEN] ] ; immediate restrict
1.1 pazsan 203:
1.70 pazsan 204: Defer char@ ( addr u -- char addr' u' )
205: :noname over c@ -rot 1 /string ; IS char@
206:
1.8 crook 207: : char ( '<spaces>ccc' -- c ) \ core
1.15 crook 208: \G Skip leading spaces. Parse the string @i{ccc} and return @i{c}, the
209: \G display code representing the first character of @i{ccc}.
1.70 pazsan 210: bl word count char@ 2drop ;
1.1 pazsan 211:
1.8 crook 212: : [char] ( compilation '<spaces>ccc' -- ; run-time -- c ) \ core bracket-char
1.10 crook 213: \G Compilation: skip leading spaces. Parse the string
1.15 crook 214: \G @i{ccc}. Run-time: return @i{c}, the display code
215: \G representing the first character of @i{ccc}. Interpretation
1.10 crook 216: \G semantics for this word are undefined.
1.1 pazsan 217: char postpone Literal ; immediate restrict
218:
219: \ \ threading 17mar93py
220:
221: : cfa, ( code-address -- ) \ gforth cfa-comma
222: here
223: dup lastcfa !
224: 0 A, 0 , code-address! ;
225:
1.14 jwilke 226: [IFUNDEF] compile,
1.34 anton 227: defer compile, ( xt -- ) \ core-ext compile-comma
228: \G Compile the word represented by the execution token @i{xt}
229: \G into the current definition.
230:
231: ' , is compile,
1.14 jwilke 232: [THEN]
1.1 pazsan 233:
1.40 anton 234: defer basic-block-end ( -- )
235:
1.60 anton 236: :noname ( -- )
237: 0 compile-prim1 ;
238: is basic-block-end
1.40 anton 239:
1.36 pazsan 240: has? peephole [IF]
1.40 anton 241:
242: \ dynamic only
1.49 anton 243: : peephole-compile, ( xt -- )
244: \ compile xt, appending its code to the current dynamic superinstruction
245: here swap , compile-prim1 ;
1.38 anton 246:
1.35 anton 247: : compile-to-prims, ( xt -- )
248: \G compile xt to use primitives (and their peephole optimization)
249: \G instead of ","-ing the xt.
250: \ !! all POSTPONEs here postpone primitives; this can be optimized
1.39 pazsan 251: dup >does-code if
1.66 anton 252: ['] does-exec peephole-compile, , EXIT
253: \ dup >body POSTPONE literal ['] call peephole-compile, >does-code , EXIT
1.35 anton 254: then
255: dup >code-address CASE
1.66 anton 256: docon: OF >body ['] lit@ peephole-compile, , EXIT ENDOF
257: \ docon: OF >body POSTPONE literal ['] @ peephole-compile, EXIT ENDOF
1.42 anton 258: \ docon is also used by VALUEs, so don't @ at compile time
1.66 anton 259: docol: OF >body ['] call peephole-compile, , EXIT ENDOF
260: dovar: OF >body ['] lit peephole-compile, , EXIT ENDOF
261: douser: OF >body @ ['] useraddr peephole-compile, , EXIT ENDOF
262: dodefer: OF >body ['] lit-perform peephole-compile, , EXIT ENDOF
263: dofield: OF >body @ ['] lit+ peephole-compile, , EXIT ENDOF
264: \ dofield: OF >body @ POSTPONE literal ['] + peephole-compile, EXIT ENDOF
1.48 anton 265: \ code words and ;code-defined words (code words could be optimized):
1.66 anton 266: dup in-dictionary? IF drop POSTPONE literal ['] execute peephole-compile, EXIT THEN
1.35 anton 267: ENDCASE
1.49 anton 268: peephole-compile, ;
1.35 anton 269:
270: ' compile-to-prims, IS compile,
1.36 pazsan 271: [ELSE]
272: ' , is compile,
273: [THEN]
1.34 anton 274:
1.1 pazsan 275: : !does ( addr -- ) \ gforth store-does
1.56 anton 276: latestxt does-code! ;
1.1 pazsan 277:
1.65 anton 278: \ !! unused, but ifdefed/gosted in some places
1.1 pazsan 279: : (does>) ( R: addr -- )
1.62 anton 280: r> cfaligned /does-handler + !does ; \ !! no gforth-native
1.1 pazsan 281:
1.64 anton 282: : (does>2) ( addr -- )
283: cfaligned /does-handler + !does ;
284:
1.1 pazsan 285: : dodoes, ( -- )
286: cfalign here /does-handler allot does-handler! ;
287:
1.61 pazsan 288: : (compile) ( -- ) \ gforth-obsolete: dummy
1.63 anton 289: true abort" (compile) doesn't work, use POSTPONE instead" ;
1.1 pazsan 290:
291: \ \ ticks
292:
293: : name>comp ( nt -- w xt ) \ gforth
1.15 crook 294: \G @i{w xt} is the compilation token for the word @i{nt}.
1.1 pazsan 295: (name>comp)
296: 1 = if
297: ['] execute
298: else
299: ['] compile,
300: then ;
301:
302: : [(')] ( compilation "name" -- ; run-time -- nt ) \ gforth bracket-paren-tick
303: (') postpone ALiteral ; immediate restrict
304:
305: : ['] ( compilation. "name" -- ; run-time. -- xt ) \ core bracket-tick
1.15 crook 306: \g @i{xt} represents @i{name}'s interpretation
307: \g semantics. Perform @code{-14 throw} if the word has no
1.1 pazsan 308: \g interpretation semantics.
309: ' postpone ALiteral ; immediate restrict
310:
1.5 anton 311: : COMP' ( "name" -- w xt ) \ gforth comp-tick
1.15 crook 312: \g Compilation token @i{w xt} represents @i{name}'s compilation semantics.
1.1 pazsan 313: (') name>comp ;
314:
315: : [COMP'] ( compilation "name" -- ; run-time -- w xt ) \ gforth bracket-comp-tick
1.15 crook 316: \g Compilation token @i{w xt} represents @i{name}'s compilation semantics.
1.1 pazsan 317: COMP' swap POSTPONE Aliteral POSTPONE ALiteral ; immediate restrict
318:
1.18 jwilke 319: : postpone, ( w xt -- ) \ gforth postpone-comma
1.26 anton 320: \g Compile the compilation semantics represented by the
321: \g compilation token @i{w xt}.
1.18 jwilke 322: dup ['] execute =
323: if
324: drop compile,
325: else
1.61 pazsan 326: swap POSTPONE aliteral compile,
1.18 jwilke 327: then ;
328:
329: : POSTPONE ( "name" -- ) \ core
330: \g Compiles the compilation semantics of @i{name}.
1.48 anton 331: COMP' postpone, ; immediate
1.18 jwilke 332:
1.1 pazsan 333: \ \ recurse 17may93jaw
334:
335: : recurse ( compilation -- ; run-time ?? -- ?? ) \ core
1.10 crook 336: \g Call the current definition.
1.56 anton 337: latestxt compile, ; immediate restrict
1.1 pazsan 338:
339: \ \ compiler loop
340:
1.72 anton 341: : compiler1 ( c-addr u -- ... xt )
1.1 pazsan 342: 2dup find-name dup
343: if ( c-addr u nt )
1.72 anton 344: nip nip name>comp
1.1 pazsan 345: else
346: drop
1.72 anton 347: 2dup 2>r snumber? dup
1.1 pazsan 348: IF
349: 0>
350: IF
1.72 anton 351: ['] 2literal
352: ELSE
353: ['] literal
1.1 pazsan 354: THEN
1.72 anton 355: 2rdrop
1.1 pazsan 356: ELSE
1.72 anton 357: drop 2r> compiler-notfound1
1.1 pazsan 358: THEN
359: then ;
360:
1.22 crook 361: : [ ( -- ) \ core left-bracket
1.8 crook 362: \G Enter interpretation state. Immediate word.
1.72 anton 363: ['] interpreter1 IS parser1 state off ; immediate
1.1 pazsan 364:
365: : ] ( -- ) \ core right-bracket
1.8 crook 366: \G Enter compilation state.
1.72 anton 367: ['] compiler1 IS parser1 state on ;
1.1 pazsan 368:
369: \ \ Strings 22feb93py
370:
1.44 anton 371: : S, ( addr u -- )
1.45 anton 372: \ allot string as counted string
1.44 anton 373: here over char+ allot place align ;
1.45 anton 374:
375: : mem, ( addr u -- )
376: \ allot the memory block HERE (do alignment yourself)
377: here over allot swap move ;
1.1 pazsan 378:
1.44 anton 379: : ," ( "string"<"> -- )
380: [char] " parse s, ;
1.1 pazsan 381:
382: \ \ Header states 23feb93py
383:
384: : cset ( bmask c-addr -- )
1.30 anton 385: tuck @ or swap ! ;
1.1 pazsan 386:
387: : creset ( bmask c-addr -- )
1.30 anton 388: tuck @ swap invert and swap ! ;
1.1 pazsan 389:
390: : ctoggle ( bmask c-addr -- )
1.30 anton 391: tuck @ xor swap ! ;
1.1 pazsan 392:
393: : lastflags ( -- c-addr )
394: \ the address of the flags byte in the last header
395: \ aborts if the last defined word was headerless
1.56 anton 396: latest dup 0= abort" last word was headerless" cell+ ;
1.1 pazsan 397:
398: : immediate ( -- ) \ core
1.10 crook 399: \G Make the compilation semantics of a word be to @code{execute}
400: \G the execution semantics.
1.1 pazsan 401: immediate-mask lastflags cset ;
402:
403: : restrict ( -- ) \ gforth
1.10 crook 404: \G A synonym for @code{compile-only}
1.1 pazsan 405: restrict-mask lastflags cset ;
1.18 jwilke 406:
1.1 pazsan 407: ' restrict alias compile-only ( -- ) \ gforth
1.10 crook 408: \G Remove the interpretation semantics of a word.
1.1 pazsan 409:
410: \ \ Create Variable User Constant 17mar93py
411:
1.15 crook 412: : Alias ( xt "name" -- ) \ gforth
1.1 pazsan 413: Header reveal
414: alias-mask lastflags creset
415: dup A, lastcfa ! ;
416:
417: doer? :dovar [IF]
418:
419: : Create ( "name" -- ) \ core
420: Header reveal dovar: cfa, ;
421: [ELSE]
422:
423: : Create ( "name" -- ) \ core
424: Header reveal here lastcfa ! 0 A, 0 , DOES> ;
425: [THEN]
426:
427: : Variable ( "name" -- ) \ core
428: Create 0 , ;
429:
430: : AVariable ( "name" -- ) \ gforth
431: Create 0 A, ;
432:
1.22 crook 433: : 2Variable ( "name" -- ) \ double two-variable
1.1 pazsan 434: create 0 , 0 , ;
435:
1.75 pazsan 436: has? no-userspace 0= [IF]
1.21 crook 437: : uallot ( n -- ) \ gforth
438: udp @ swap udp +! ;
1.1 pazsan 439:
440: doer? :douser [IF]
441:
442: : User ( "name" -- ) \ gforth
443: Header reveal douser: cfa, cell uallot , ;
444:
445: : AUser ( "name" -- ) \ gforth
446: User ;
447: [ELSE]
448:
449: : User Create cell uallot , DOES> @ up @ + ;
450:
451: : AUser User ;
1.75 pazsan 452: [THEN]
1.1 pazsan 453: [THEN]
454:
455: doer? :docon [IF]
456: : (Constant) Header reveal docon: cfa, ;
457: [ELSE]
458: : (Constant) Create DOES> @ ;
459: [THEN]
460:
1.76 pazsan 461: doer? :dovalue [IF]
462: : (Value) Header reveal dovalue: cfa, ;
463: [ELSE]
464: has? rom [IF]
465: : (Value) Create DOES> @ @ ;
466: [ELSE]
467: : (Value) Create DOES> @ ;
468: [THEN]
469: [THEN]
470:
1.1 pazsan 471: : Constant ( w "name" -- ) \ core
1.15 crook 472: \G Define a constant @i{name} with value @i{w}.
1.1 pazsan 473: \G
1.15 crook 474: \G @i{name} execution: @i{-- w}
1.1 pazsan 475: (Constant) , ;
476:
477: : AConstant ( addr "name" -- ) \ gforth
478: (Constant) A, ;
479:
480: : Value ( w "name" -- ) \ core-ext
1.76 pazsan 481: (Value) , ;
1.1 pazsan 482:
1.37 jwilke 483: : AValue ( w "name" -- ) \ core-ext
1.76 pazsan 484: (Value) A, ;
1.37 jwilke 485:
1.22 crook 486: : 2Constant ( w1 w2 "name" -- ) \ double two-constant
1.1 pazsan 487: Create ( w1 w2 "name" -- )
488: 2,
489: DOES> ( -- w1 w2 )
490: 2@ ;
491:
492: doer? :dofield [IF]
493: : (Field) Header reveal dofield: cfa, ;
494: [ELSE]
495: : (Field) Create DOES> @ + ;
496: [THEN]
1.39 pazsan 497:
498: \ \ interpret/compile:
499:
500: struct
501: >body
502: cell% field interpret/compile-int
503: cell% field interpret/compile-comp
504: end-struct interpret/compile-struct
505:
506: : interpret/compile: ( interp-xt comp-xt "name" -- ) \ gforth
507: Create immediate swap A, A,
508: DOES>
509: abort" executed primary cfa of an interpret/compile: word" ;
510: \ state @ IF cell+ THEN perform ;
511:
1.1 pazsan 512: \ IS Defer What's Defers TO 24feb93py
513:
1.68 anton 514: defer defer-default ( -- )
1.69 anton 515: ' abort is defer-default
516: \ default action for deferred words (overridden by a warning later)
1.67 anton 517:
1.1 pazsan 518: doer? :dodefer [IF]
519:
520: : Defer ( "name" -- ) \ gforth
1.67 anton 521: \G Define a deferred word @i{name}; its execution semantics can be
522: \G set with @code{defer!} or @code{is} (and they have to, before first
523: \G executing @i{name}.
1.1 pazsan 524: Header Reveal dodefer: cfa,
1.67 anton 525: ['] defer-default A, ;
1.18 jwilke 526:
1.1 pazsan 527: [ELSE]
528:
1.77 pazsan 529: has? rom [IF]
530: : Defer ( "name" -- ) \ gforth
531: Create ['] defer-default A,
532: DOES> @ @ execute ;
533: [ELSE]
534: : Defer ( "name" -- ) \ gforth
535: Create ['] defer-default A,
536: DOES> @ execute ;
537: [THEN]
1.1 pazsan 538: [THEN]
539:
1.67 anton 540: : defer@ ( xt-deferred -- xt ) \ gforth defer-fetch
541: \G @i{xt} represents the word currently associated with the deferred
542: \G word @i{xt-deferred}.
543: >body @ ;
544:
1.25 anton 545: : Defers ( compilation "name" -- ; run-time ... -- ... ) \ gforth
546: \G Compiles the present contents of the deferred word @i{name}
547: \G into the current definition. I.e., this produces static
548: \G binding as if @i{name} was not deferred.
1.67 anton 549: ' defer@ compile, ; immediate
1.18 jwilke 550:
551: :noname
552: dodoes, here !does ]
553: defstart :-hook ;
554: :noname
555: ;-hook ?struc
556: [ has? xconds [IF] ] exit-like [ [THEN] ]
1.64 anton 557: here 5 cells + postpone aliteral postpone (does>2) [compile] exit
558: finish-code dodoes,
1.18 jwilke 559: defstart :-hook ;
560: interpret/compile: DOES> ( compilation colon-sys1 -- colon-sys2 ; run-time nest-sys -- ) \ core does
561:
1.73 anton 562: : defer! ( xt xt-deferred -- ) \ gforth defer-store
1.67 anton 563: \G Changes the @code{defer}red word @var{xt-deferred} to execute @var{xt}.
564: >body ! ;
565:
1.20 anton 566: : <IS> ( "name" xt -- ) \ gforth
567: \g Changes the @code{defer}red word @var{name} to execute @var{xt}.
1.67 anton 568: ' defer! ;
1.20 anton 569:
570: : [IS] ( compilation "name" -- ; run-time xt -- ) \ gforth bracket-is
571: \g At run-time, changes the @code{defer}red word @var{name} to
572: \g execute @var{xt}.
1.67 anton 573: ' postpone ALiteral postpone defer! ; immediate restrict
1.18 jwilke 574:
1.20 anton 575: ' <IS>
1.18 jwilke 576: ' [IS]
1.67 anton 577: interpret/compile: IS ( compilation/interpretation "name-deferred" -- ; run-time xt -- ) \ gforth
578: \G Changes the @code{defer}red word @var{name} to execute @var{xt}.
579: \G Its compilation semantics parses at compile time.
1.18 jwilke 580:
1.20 anton 581: ' <IS>
582: ' [IS]
583: interpret/compile: TO ( w "name" -- ) \ core-ext
1.18 jwilke 584:
585: : interpret/compile? ( xt -- flag )
586: >does-code ['] DOES> >does-code = ;
1.1 pazsan 587:
588: \ \ : ; 24feb93py
589:
590: defer :-hook ( sys1 -- sys2 )
591:
592: defer ;-hook ( sys2 -- sys1 )
593:
1.16 jwilke 594: 0 Constant defstart
595:
1.14 jwilke 596: [IFDEF] docol,
597: : (:noname) ( -- colon-sys )
598: \ common factor of : and :noname
1.34 anton 599: docol, ]comp
1.14 jwilke 600: [ELSE]
1.7 anton 601: : (:noname) ( -- colon-sys )
602: \ common factor of : and :noname
1.34 anton 603: docol: cfa,
1.14 jwilke 604: [THEN]
1.40 anton 605: defstart ] :-hook ;
1.7 anton 606:
1.1 pazsan 607: : : ( "name" -- colon-sys ) \ core colon
1.7 anton 608: Header (:noname) ;
609:
610: : :noname ( -- xt colon-sys ) \ core-ext colon-no-name
611: 0 last !
612: cfalign here (:noname) ;
1.1 pazsan 613:
1.14 jwilke 614: [IFDEF] fini,
615: : ; ( compilation colon-sys -- ; run-time nest-sys ) \ core semicolon
616: ;-hook ?struc fini, comp[ reveal postpone [ ; immediate restrict
617: [ELSE]
1.1 pazsan 618: : ; ( compilation colon-sys -- ; run-time nest-sys ) \ core semicolon
1.57 pazsan 619: ;-hook ?struc [compile] exit
620: [ has? peephole [IF] ] finish-code [ [THEN] ]
621: reveal postpone [ ; immediate restrict
1.14 jwilke 622: [THEN]
1.1 pazsan 623:
624: \ \ Search list handling: reveal words, recursive 23feb93py
625:
626: : last? ( -- false / nfa nfa )
1.56 anton 627: latest ?dup ;
1.1 pazsan 628:
629: : (reveal) ( nt wid -- )
1.3 pazsan 630: wordlist-id dup >r
1.1 pazsan 631: @ over ( name>link ) !
632: r> ! ;
633:
634: \ make entry in wordlist-map
635: ' (reveal) f83search reveal-method !
636:
637: Variable warnings ( -- addr ) \ gforth
638: G -1 warnings T !
639:
640: : check-shadow ( addr count wid -- )
1.2 pazsan 641: \G prints a warning if the string is already present in the wordlist
642: >r 2dup 2dup r> (search-wordlist) warnings @ and ?dup if
643: >stderr
644: ." redefined " name>string 2dup type
1.43 anton 645: str= 0= if
1.2 pazsan 646: ." with " type
647: else
648: 2drop
649: then
650: space space EXIT
651: then
652: 2drop 2drop ;
1.1 pazsan 653:
654: : reveal ( -- ) \ gforth
655: last?
656: if \ the last word has a header
657: dup ( name>link ) @ 1 and
658: if \ it is still hidden
659: dup ( name>link ) @ 1 xor ( nt wid )
660: 2dup >r name>string r> check-shadow ( nt wid )
661: dup wordlist-map @ reveal-method perform
662: else
663: drop
664: then
665: then ;
666:
667: : rehash ( wid -- )
668: dup wordlist-map @ rehash-method perform ;
669:
670: ' reveal alias recursive ( compilation -- ; run-time -- ) \ gforth
1.10 crook 671: \g Make the current definition visible, enabling it to call itself
1.1 pazsan 672: \g recursively.
673: immediate restrict
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>