adoc/p_literal_string_compile.adoc

   1 //compile.asm:  WORD p_literal_string_compile,'S"',fasm ;; " (fool emacs)
   2
   3 anchor:p_literal_string_compile[]
   4
   5 === Word: S"
   6
   7 ....
   8 Data stack: ( -- )  Input stream: " chars"
   9 ....
  10
  11 "S"" is an immediate function word that compiles the subseqent
  12 characters up to terminating double-quote into the current definition,
  13 preceded by a <<p_literal_string,LIT-STRING>> cell, and the count of
  14 bytes scanned. The inline text includes a terminating NUL character
  15 which also is included in the inlined count.
  16
  17 Note that "S"" uses <<p_double_quote,">> for reading the string.
  18