[BACK]Return to gforth.ds CVS log [TXT] [DIR] Up to [gforth] / gforth / doc

Diff for /gforth/doc/gforth.ds between versions 1.235 and 1.236

version 1.235, 2012/02/08 17:08:19 version 1.236, 2012/02/09 18:23:29
Line 274  Defining Words Line 274  Defining Words
 * Values::                      Initialised variables  * Values::                      Initialised variables
 * Colon Definitions::             * Colon Definitions::           
 * Anonymous Definitions::       Definitions without names  * Anonymous Definitions::       Definitions without names
   * Quotations::                  
 * Supplying names::             Passing definition names as strings  * Supplying names::             Passing definition names as strings
 * User-defined Defining Words::    * User-defined Defining Words::  
 * Deferred Words::              Allow forward references  * Deferred Words::              Allow forward references
Line 332  Other I/O Line 333  Other I/O
 * Formatted numeric output::    Formatted (pictured) output  * Formatted numeric output::    Formatted (pictured) output
 * String Formats::              How Forth stores strings in memory  * String Formats::              How Forth stores strings in memory
 * Displaying characters and strings::  Other stuff  * Displaying characters and strings::  Other stuff
   * String words::                Gforth's little string library
 * Terminal output::             Cursor positioning etc.  * Terminal output::             Cursor positioning etc.
 * Single-key input::              * Single-key input::            
 * Line input and conversion::     * Line input and conversion::   
Line 6025  Defining words are used to extend Forth Line 6027  Defining words are used to extend Forth
 * Values::                      Initialised variables  * Values::                      Initialised variables
 * Colon Definitions::             * Colon Definitions::           
 * Anonymous Definitions::       Definitions without names  * Anonymous Definitions::       Definitions without names
   * Quotations::                  
 * Supplying names::             Passing definition names as strings  * Supplying names::             Passing definition names as strings
 * User-defined Defining Words::    * User-defined Defining Words::  
 * Deferred Words::              Allow forward references  * Deferred Words::              Allow forward references
Line 6281  doc-: Line 6284  doc-:
 doc-;  doc-;
   
   
 @node Anonymous Definitions, Supplying names, Colon Definitions, Defining Words  @node Anonymous Definitions, Quotations, Colon Definitions, Defining Words
 @subsection Anonymous Definitions  @subsection Anonymous Definitions
 @cindex colon definitions  @cindex colon definitions
 @cindex defining words without name  @cindex defining words without name
Line 6336  latestxt . : foo [ latestxt . ] ; ' foo Line 6339  latestxt . : foo [ latestxt . ] ; ' foo
 @noindent  @noindent
 prints 3 numbers; the last two are the same.  prints 3 numbers; the last two are the same.
   
 @node Supplying names, User-defined Defining Words, Anonymous Definitions, Defining Words  
   @node Quotations, Supplying names, Anonymous Definitions, Defining Words
   @subsection Quotations
   @cindex quotations
   @cindex nested colon definitions
   @cindex colon definitions, nesting
   
   A quotation is an anonymous colon definition inside another colon
   definition.  Quotations are useful when dealing with words that
   consume an execution token, like @code{catch} or
   @code{outfile-execute}.  E.g. consider the following example of using
   @code{outfile-execute} (@pxref{Redirection}):
   
   @example
   : some-warning ( n -- )
       cr ." warning# " . ;
   
   : print-some-warning ( n -- )
       ['] some-warning stderr outfile-execute ;
   @end example
   
   Here we defined @code{some-warning} as a helper word whose xt we could
   pass to outfile-execute.  Instead, we can use a quotation to define
   such a word anonymously inside @code{print-some-warning}:
   
   @example
   : print-some-warning ( n -- )
     [: cr ." warning# " . ;] stderr outfile-execute ;
   @end example
   
   The quotation is bouded by @code{[:} and @code{;]}.  It produces an
   execution token at run-time.
   
   doc-[:
   doc-;]
   
   
   @node Supplying names, User-defined Defining Words, Quotations, Defining Words
 @subsection Supplying the name of a defined word  @subsection Supplying the name of a defined word
 @cindex names for defined words  @cindex names for defined words
 @cindex defining words, name given in a string  @cindex defining words, name given in a string
Removed from v.1.235  
changed lines
  Added in v.1.236

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