Annotation of gforth/kernel/quotes.fs, revision 1.1

1.1     ! jwilke      1: \ quote: S" and ." words
        !             2: 
        !             3: \ Copyright (C) 1996,1998 Free Software Foundation, Inc.
        !             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
        !            19: \ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
        !            20: 
        !            21: \ this file comes last, because these words override cross' words.
        !            22: 
        !            23: require ./vars.fs
        !            24: 
        !            25: create s"-buffer /line chars allot
        !            26: has? compiler 0= 
        !            27: [IF] : s" [ELSE] :noname [THEN]
        !            28:        [char] " parse
        !            29:        /line min >r s"-buffer r@ cmove
        !            30:        s"-buffer r> ;
        !            31: has? compiler [IF]
        !            32: :noname [char] " parse postpone SLiteral ;
        !            33: interpret/compile: S" ( compilation 'ccc"' -- ; run-time -- c-addr u ) \ core,file     s-quote
        !            34:   \G Compilation: Parse a string @i{ccc} delimited by a @code{"}
        !            35:   \G (double quote). At run-time, return the length, @i{u}, and the
        !            36:   \G start address, @i{c-addr} of the string. Interpretation: parse
        !            37:   \G the string as before, and return @i{c-addr}, @i{u}. The
        !            38:   \G string is stored in a temporary buffer which may be overwritten
        !            39:   \G by subsequent uses of @code{S"}.
        !            40: [THEN]
        !            41: 
        !            42: :noname    [char] " parse type ;
        !            43: :noname    postpone (.") ,"  align ;
        !            44: interpret/compile: ." ( compilation 'ccc"' -- ; run-time -- )  \ core  dot-quote
        !            45:   \G Compilation: Parse a string @i{ccc} delimited by a " (double
        !            46:   \G quote). At run-time, display the string. Interpretation semantics
        !            47:   \G for this word are undefined in ANS Forth. Gforth's interpretation
        !            48:   \G semantics are to display the string. This is the simplest way to
        !            49:   \G display a string from within a definition; see examples below.
        !            50: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>