version 1.4, 2006/02/19 17:27:13
|
version 1.10, 2007/10/17 15:50:01
|
Line 1
|
Line 1
|
\ extended characters (either 8bit or UTF-8, possibly other encodings) |
\ extended characters (either 8bit or UTF-8, possibly other encodings) |
\ and their fixed-size variant |
\ and their fixed-size variant |
|
|
\ Copyright (C) 2005 Free Software Foundation, Inc. |
\ Copyright (C) 2005,2006 Free Software Foundation, Inc. |
|
|
\ This file is part of Gforth. |
\ This file is part of Gforth. |
|
|
Line 23
|
Line 23
|
\ utf-8 words with an appropriate setting of max-single-byte, but I |
\ utf-8 words with an appropriate setting of max-single-byte, but I |
\ like to see how an 8bit setting without UTF-8 stuff looks like. |
\ like to see how an 8bit setting without UTF-8 stuff looks like. |
|
|
DEFER XEMIT ( xc -- ) |
Defer xemit ( xc -- ) \ xchar-ext |
DEFER XKEY ( -- xc ) |
\G Prints an xchar on the terminal. |
DEFER XCHAR+ ( xc-addr1 -- xc-addr2 ) |
Defer xkey ( -- xc ) \ xchar-ext |
DEFER XCHAR- ( xc-addr1 -- xc-addr2 ) |
\G Reads an xchar from the terminal. This will discard all input |
DEFER +X/STRING ( xc-addr1 u1 -- xc-addr2 u2 ) |
\G events up to the completion of the xchar. |
DEFER -X/STRING ( xc-addr1 u1 -- xc-addr2 u2 ) |
Defer xchar+ ( xc-addr1 -- xc-addr2 ) \ xchar-ext |
DEFER XC@ ( xc-addr -- xc ) |
\G Adds the size of the xchar stored at @var{xc-addr1} to this address, |
DEFER XC!+? ( xc xc-addr1 u1 -- xc-addr2 u2 f ) \ f if operation succeeded |
\G giving @var{xc-addr2}. |
DEFER XC@+ ( xc-addr1 -- xc-addr2 xc ) |
Defer xchar- ( xc-addr1 -- xc-addr2 ) \ xchar-ext |
DEFER XC-SIZE ( xc -- u ) \ size in cs |
\G Goes backward from @var{xc_addr1} until it finds an xchar so that |
DEFER X-WIDTH ( addr u -- n ) \ size in fixed chars |
\G the size of this xchar added to @var{xc_addr2} gives |
DEFER -TRAILING-GARBAGE ( addr u1 -- addr u2 ) \ remove trailing incomplete xc |
\G @var{xc_addr1}. |
|
Defer +x/string ( xc-addr1 u1 -- xc-addr2 u2 ) \ xchar plus-x-slash-string |
|
\G Step forward by one xchar in the buffer defined by address |
|
\G @var{xc-addr1}, size @var{u1} pchars. @var{xc-addr2} is the address |
|
\G and u2 the size in pchars of the remaining buffer after stepping |
|
\G over the first xchar in the buffer. |
|
Defer x\string- ( xc-addr1 u1 -- xc-addr1 u2 ) \ xchar x-back-string-minus |
|
\G Step backward by one xchar in the buffer defined by address |
|
\G @var{xc-addr1} and size @var{u1} in pchars, starting at the end of |
|
\G the buffer. @var{xc-addr1} is the address and @var{u2} the size in |
|
\G pchars of the remaining buffer after stepping backward over the |
|
\G last xchar in the buffer. |
|
Defer xc@ ( xc-addr -- xc ) \ xchar-ext xc-fetch |
|
\G Fetchs the xchar @var{xc} at @var{xc-addr1}. |
|
Defer xc!+? ( xc xc-addr1 u1 -- xc-addr2 u2 f ) \ xchar-ext xc-store-plus-query |
|
\G Stores the xchar @var{xc} into the buffer starting at address |
|
\G @var{xc-addr1}, @var{u1} pchars large. @var{xc-addr2} points to the |
|
\G first memory location after @var{xc}, @var{u2} is the remaining |
|
\G size of the buffer. If the xchar @var{xc} did fit into the buffer, |
|
\G @var{f} is true, otherwise @var{f} is false, and @var{xc-addr2} |
|
\G @var{u2} equal @var{xc-addr1} @var{u1}. XC!+? is safe for buffer |
|
\G overflows, and therefore preferred over XC!+. |
|
Defer xc@+ ( xc-addr1 -- xc-addr2 xc ) \ xchar-ext xc-fetch-plus |
|
\G Fetchs the xchar @var{xc} at @var{xc-addr1}. @var{xc-addr2} points |
|
\G to the first memory location after @var{xc}. |
|
Defer xc-size ( xc -- u ) \ xchar-ext |
|
\G Computes the memory size of the xchar @var{xc} in pchars. |
|
Defer x-size ( xc-addr u1 -- u2 ) \ xchar |
|
\G Computes the memory size of the first xchar stored at @var{xc-addr} |
|
\G in pchars. |
|
Defer x-width ( xc-addr u -- n ) \ xchar-ext |
|
\G @var{n} is the number of monospace ASCII pchars that take the same |
|
\G space to display as the the xchar string starting at @var{xc-addr}, |
|
\G using @var{u} pchars; assuming a monospaced display font, |
|
\G i.e. pchar width is always an integer multiple of the width of an |
|
\G ASCII pchar. |
|
Defer -trailing-garbage ( xc-addr u1 -- addr u2 ) \ xchar-ext |
|
\G Examine the last XCHAR in the buffer @var{xc-addr} @var{u1}---if |
|
\G the encoding is correct and it repesents a full pchar, @var{u2} |
|
\G equals @var{u1}, otherwise, @var{u2} represents the string without |
|
\G the last (garbled) xchar. |
|
|
\ derived words, faster implementations are probably possible |
\ derived words, faster implementations are probably possible |
|
|
: X@+/string ( xc-addr1 u1 -- xc-addr2 u2 xc ) |
: x@+/string ( xc-addr1 u1 -- xc-addr2 u2 xc ) |
\ !! check for errors? |
\ !! check for errors? |
over >r +x/string |
over >r +x/string |
r> xc@ ; |
r> xc@ ; |
|
|
|
Create xholdbuf 8 allot |
|
: xhold ( xc -- ) |
|
\G Put xc into the pictured numeric output |
|
xholdbuf 8 xc!+? 2drop |
|
BEGIN 1- dup xholdbuf u>= WHILE dup c@ hold REPEAT drop ; |
|
|
\ fixed-size versions of these words |
\ fixed-size versions of these words |
|
|
: char- ( c-addr1 -- c-addr2 ) |
: char- ( c-addr1 -- c-addr2 ) |
[ 1 chars ] literal - ; |
[ 1 chars ] literal - ; |
|
|
: 1/string ( c-addr1 u1 -- c-addr2 u2 ) |
: +string ( c-addr1 u1 -- c-addr2 u2 ) |
1 /string ; |
1 /string ; |
|
: string- ( c-addr1 u1 -- c-addr1 u2 ) |
: -1/string ( c-addr1 u1 -- c-addr2 u2 ) |
1- ; |
-1 /string ; |
|
|
|
: c!+? ( c c-addr1 u1 -- c-addr2 u2 f ) |
: c!+? ( c c-addr1 u1 -- c-addr2 u2 f ) |
dup 1 chars u< if \ or use < ? |
dup 1 chars u< if \ or use < ? |
Line 70 DEFER -TRAILING-GARBAGE ( addr u1 -- add
|
Line 115 DEFER -TRAILING-GARBAGE ( addr u1 -- add
|
['] key is xkey |
['] key is xkey |
['] char+ is xchar+ |
['] char+ is xchar+ |
['] char- is xchar- |
['] char- is xchar- |
['] 1/string is +x/string |
['] +string is +x/string |
['] -1/string is -x/string |
['] string- is x\string- |
['] c@ is xc@ |
['] c@ is xc@ |
['] c!+? is xc!+? |
['] c!+? is xc!+? |
['] count is xc@+ |
['] count is xc@+ |
['] c-size is xc-size |
['] c-size is xc-size |
|
['] c-size is x-size |
['] nip IS x-width |
['] nip IS x-width |
['] noop is -trailing-garbage |
['] noop is -trailing-garbage |
; |
; |