X-Git-Url: https://thelambdalab.xyz/gitweb/index.cgi?a=blobdiff_plain;f=src%2Flib.4th;h=955cadfe236e34a1c286d4e98c9f5659b5245676;hb=d2b2b3e5b33f882c18c9e7cf8c6623f4e863c2dd;hp=6b2d8aef17be80a6634fe2b2c201b9bc3bf8a012;hpb=bb362c83787c336261014bdb16f5cf0841c8b506;p=forth.jl.git diff --git a/src/lib.4th b/src/lib.4th index 6b2d8ae..955cadf 100644 --- a/src/lib.4th +++ b/src/lib.4th @@ -1,3 +1,10 @@ +: \ IMMEDIATE + KEY + 10 = 0BRANCH [ -5 , ] +; \ We can now comment! + +\ BASIC DEFINITIONS ---------------------------------------------------------------------- + : / /MOD SWAP DROP ; : MOD /MOD DROP ; : */ -ROT * SWAP / ; @@ -8,7 +15,16 @@ : FALSE 0 ; : NOT 0= ; -: CELLS ; \ Allow for slightly more portable code +\ Translate a number of cells into memory units +\ (in our case 1 cell = 1 memory unit) +: CELLS ; + +\ Since the smallest unit of memory in our system is 64 bits and since strings +\ are stored as arrays of 64 bit integers, the character store/fetch words are +\ just aliases of the standard store/fetch words. +: C! ! ; +: C@ @ ; +: C, , ; : DEPTH PSP@ PSP0 @ - ; @@ -17,17 +33,10 @@ : LITERAL IMMEDIATE ['] LIT , , ; -: ':' [ CHAR : ] LITERAL ; -: ';' [ CHAR ; ] LITERAL ; -: '(' [ CHAR ( ] LITERAL ; -: ')' [ CHAR ) ] LITERAL ; -: '<' [ CHAR < ] LITERAL ; -: '>' [ CHAR > ] LITERAL ; -: '"' [ CHAR " ] LITERAL ; -: 'A' [ CHAR A ] LITERAL ; -: '0' [ CHAR 0 ] LITERAL ; -: '-' [ CHAR - ] LITERAL ; -: '.' [ CHAR . ] LITERAL ; +: [CHAR] IMMEDIATE + CHAR + ['] LIT , , +; : CR '\n' emit ; : SPACE BL emit ; @@ -207,11 +216,11 @@ 1 \ allowed nested parens by keeping track of depth BEGIN KEY \ read next character - DUP '(' = IF \ open paren? + DUP [CHAR] ( = IF \ open paren? DROP \ drop the open paren 1+ \ depth increases ELSE - ')' = IF \ close paren? + [CHAR] ) = IF \ close paren? 1- \ depth decreases THEN THEN @@ -283,10 +292,10 @@ ( print the remainder ) DUP 10 < IF - '0' ( decimal digits 0..9 ) + [CHAR] 0 ( decimal digits 0..9 ) ELSE 10 - ( hex and beyond digits A..Z ) - 'A' + [CHAR] A THEN + EMIT @@ -339,7 +348,7 @@ SWAP ( u flag ) IF ( was it negative? print the - character ) - '-' EMIT + [CHAR] - EMIT THEN U. @@ -348,7 +357,7 @@ : . 0 .R SPACE ; : .S ( -- ) - '<' EMIT DEPTH U. '>' EMIT SPACE + [CHAR] < EMIT DEPTH U. [CHAR] > EMIT SPACE PSP0 @ 1+ BEGIN DUP PSP@ 2 - <= @@ -383,11 +392,6 @@ ( STRINGS ---------------------------------------------------------------------- ) -( Since the smallest unit of memory in our system is 64 bits and since strings - are stored as arrays of 64 bit integers, the character store/fetch words are - just aliases of the standard store/fetch words. ) -: C! ! ; -: C@ @ ; ( Block copy, however, is important and novel: ) : CMOVE ( src dest length -- ) @@ -422,7 +426,7 @@ KEY DROP BEGIN KEY ( get next character of the string ) - DUP '"' <> + DUP [CHAR] " <> WHILE C, ( copy character ) REPEAT @@ -436,7 +440,7 @@ KEY DROP BEGIN KEY - DUP '"' <> + DUP [CHAR] " <> WHILE OVER C! ( save next character ) 1+ ( increment address ) @@ -449,22 +453,20 @@ ; : ." IMMEDIATE ( -- ) - STATE @ IF ( compiling? ) - [COMPILE] S" ( read the string, and compile LITSTRING, etc. ) - ['] TELL , ( compile the final TELL ) - ELSE - ( In immediate mode, just read characters and print them until we get - to the ending double quote. ) - KEY DROP - BEGIN - KEY - DUP '"' = IF - DROP ( drop the double quote character ) - EXIT ( return from this function ) - THEN - EMIT - AGAIN - THEN + [COMPILE] S" ( read the string, and compile LITSTRING, etc. ) + ['] TELL , ( compile the final TELL ) +; + +: .( + KEY DROP + BEGIN + KEY + DUP [CHAR] ) = IF + DROP ( drop the double quote character ) + EXIT ( return from this function ) + THEN + EMIT + AGAIN ; @@ -478,18 +480,13 @@ ['] EXIT , ( append the codeword EXIT ) ; -: ALLOT ( n -- addr ) - HERE @ SWAP ( here n ) +: ALLOT ( n -- ) HERE +! ( adds n to HERE, after this the old value of HERE is still on the stack ) ; : VARIABLE + CREATE 1 CELLS ALLOT ( allocate 1 cell of memory, push the pointer to this memory ) - WORD HEADER ( make the dictionary entry (the name follows VARIABLE) ) - DOCOL , ( append DOCOL (the codeword field of this word) ) - ['] LIT , ( append the codeword LIT ) - , ( append the pointer to the new memory ) - ['] EXIT , ( append the codeword EXIT ) ; @@ -530,6 +527,17 @@ THEN ; +( Fill u ints, starting at a, with the value b ) +: FILL ( a u b -- ) + -ROT OVER + SWAP ?DO + DUP I ! + LOOP + DROP +; + +: ERASE ( a u -- ) + 0 FILL +; ( PRINTING THE DICTIONARY ------------------------------------------------------ ) @@ -634,7 +642,7 @@ DUP >CFA @ CASE DOCOL OF \ Colon definition - ':' EMIT SPACE DUP ID. SPACE + [CHAR] : EMIT SPACE DUP ID. SPACE DUP ?IMMEDIATE IF ." IMMEDIATE " THEN CR ENDOF DOVAR OF @@ -654,7 +662,7 @@ ENDCASE ( begin the definition with : NAME [IMMEDIATE] ) - ( ':' EMIT SPACE DUP ID. SPACE + ( [CHAR] : EMIT SPACE DUP ID. SPACE DUP ?IMMEDIATE IF ." IMMEDIATE " THEN CR 4 ) 4 SPACES @@ -673,11 +681,11 @@ . ( and print it ) ENDOF ['] LITSTRING OF ( is it LITSTRING ? ) - [ CHAR S ] LITERAL EMIT '"' EMIT SPACE ( print S" ) + [CHAR] S EMIT [CHAR] " EMIT SPACE ( print S" ) 1+ DUP @ ( get the length word ) SWAP 1+ SWAP ( end start+1 length ) 2DUP TELL ( print the string ) - '"' EMIT SPACE ( finish the string with a final quote ) + [CHAR] " EMIT SPACE ( finish the string with a final quote ) + ( end start+1+len, aligned ) 1- ( because we're about to add 4 below ) ENDOF @@ -718,8 +726,13 @@ 1+ ( end start+1 ) REPEAT - ';' EMIT CR + [CHAR] ; EMIT CR 2DROP ( restore stack ) ; + +( MEMORY ------------------------------------------------------------------ ) + +: UNUSED ( -- cells ) + MEMSIZE HERE @ - ;