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>