Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
custom:atcodes [2019/07/10 15:02] – [Format Modifiers] Document the -W / -> switchero and about truncation due to screen width digital man | custom:atcodes [2019/08/04 23:45] – [Terminal Information / Control] Added POS:n, YESCHAR, NOCHAR, QUITCHAR, DELAY:n digital man |
---|
| |
^ Modifier ^ Purpose ^ | ^ Modifier ^ Purpose ^ |
| -L | Pad and left-justify an expanded @-code | | | ''-L'' | Pad and left-justify an expanded @-code | |
| -R | Pad and right-justify an expanded @-code | | | ''-R'' | Pad and right-justify an expanded @-code | |
| -C | Pad and center an expanded @-code (added in v3.17b) | | | ''-C'' | Pad and center an expanded @-code (added in v3.17b) | |
| -W | Displays double-wide using "fullwidth" Unicode code points if possible, spaces between the characters otherwise | | | ''-W'' | Displays double-wide using "fullwidth" Unicode code points if possible, spaces between the characters otherwise | |
| -Z | Zero-pad and right-justify an expanded @-code (added in v3.17b) | | | ''-Z'' | Zero-pad and right-justify an expanded @-code (added in v3.17b) | |
| -> | Allow the terminal to wrap (don't truncate) overly-long expanded @-codes (added in v3.17c) | | | ''->'' | Allow the terminal to wrap (don't truncate) overly-long expanded @-codes (added in v3.17c) | |
| |
=== Width Specificity === | === Width Specificity === |
|KBLIMIT |DLKLIMIT, MAXDK |User's free credits per day (in kilobytes) | | |KBLIMIT |DLKLIMIT, MAXDK |User's free credits per day (in kilobytes) | |
|MAILW | |Number of mail messages waiting for current user (includes SPAM)| | |MAILW | |Number of mail messages waiting for current user (includes SPAM)| |
|MAILW:x | |Number of mail messages waiting for current user #x (x=0 for all users)| | |MAILW://x// |MAILW#//x// |Number of mail messages waiting for current user number //x// (x=0 for all users)| |
|MAILP | |Number of pending mail messages sent by current user| | |MAILP | |Number of pending mail messages sent by current user| |
|MAILP:x | |Number of pending mail messages sent by current user #x| | |MAILP://x// |MAILP#//x// |Number of pending mail messages sent by current user number //x// | |
|MEMO | |Date of user's last password modification | | |MEMO | |Date of user's last password modification | |
|MSGLEFT |MSGSLEFT |Total number of messages posted by user | | |MSGLEFT |MSGSLEFT |Total number of messages posted by user | |
|SINCE | |Date of user's first call (in "MM/DD/YY" or "DD/MM/YY" format)| | |SINCE | |Date of user's first call (in "MM/DD/YY" or "DD/MM/YY" format)| |
|SPAMW | |Number of SPAM messages waiting | | |SPAMW | |Number of SPAM messages waiting | |
|SPAMW:x | |Number of SPAM messages waiting for user #x | | |SPAMW://x// |SPAMW#//x// |Number of SPAM messages waiting for user number //x// | |
|SPLITP | |Split-screen private chat enabled status (e.g. "On" or "Off")| | |SPLITP | |Split-screen private chat enabled status (e.g. "On" or "Off")| |
|STATE | |User's state (from location)| | |STATE | |User's state (from location)| |
|CRLF | |Send a carriage return/line-feed pair | | |CRLF | |Send a carriage return/line-feed pair | |
|CHECKMARK | |Send a check mark symbol appropriate for the user's terminal | | |CHECKMARK | |Send a check mark symbol appropriate for the user's terminal | |
| |COPY | |Send a copyright symbol appropriate for the user's terminal, e.g. "(c)" | |
| |SOUNDCOPY | |Send a sound-copyright symbol appropriate for the user's terminal, e.g. "(P)" | |
| |REGISTERED | |Send a registered mark appropriate for the user's terminal, e.g. "(r)" | |
| |TRADEMARK | |Send a trademark symbol appropriate for the user's terminal, e.g. "(tm)" | |
| |ELLIPSIS | |Send a ellipsis (...) appropriate for the user's terminal | |
| |DEGREE_C | |Send a degree Celsius symbol appropriate for the user's terminal | |
| |DEGREE_F | |Send a degree Fahrenheit symbol appropriate for the user's terminal | |
| |YESCHAR | |Print the character that corresponds with an affirmative "Yes" answer key (e.g. ''Y'') | |
| |NOCHAR | |Print the character that corresponds with an negative "No" answer key (e.g. ''N'') | |
| |QUITCHAR | |Print the character that corresponds with a "quit" command key (e.g. ''Q'') | |
|EOF | |End-of-file (stop parsing/displaying) | | |EOF | |End-of-file (stop parsing/displaying) | |
|PAUSE |MORE |Force a screen pause (hit a key) prompt| | |PAUSE |MORE |Force a screen pause (hit a key) prompt| |
|POFF |NOPAUSE |Toggle automatic screen pause off | | |POFF |NOPAUSE |Toggle automatic screen pause off | |
|RESETPAUSE | |Reset the automatic screen pause line counter | | |RESETPAUSE | |Reset the automatic screen pause line counter | |
| |DELAY://n// | |Wait //n// 10ths of a second before continuing | |
|UP://n// | |Move cursor up //n// rows | | |UP://n// | |Move cursor up //n// rows | |
|DOWN://n// | |Move cursor down //n// rows | | |DOWN://n// | |Move cursor down //n// rows | |
|LEFT://n// | |Move cursor left //n// columns | | |LEFT://n// | |Move cursor left //n// columns | |
|GOTOXY://x,y// | |Move cursor to //x/////y// coordinate (1-based) | | |GOTOXY://x,y// | |Move cursor to //x/////y// coordinate (1-based) | |
| |POS://x// | |Move cursor to column //x// (1-based) | |
|HOME | |Home cursor (to upper left), don't clear| | |HOME | |Home cursor (to upper left), don't clear| |
|CLRLINE | |Clear the current line (cursor to first column)| | |CLRLINE | |Clear the current line (cursor to first column)| |
|WIDE://text// | |Display specified //text// double-wide, using Unicode "fullwidth" characters if possible | | |WIDE://text// | |Display specified //text// double-wide, using Unicode "fullwidth" characters if possible | |
|U+//code// | |Send a Unicode character code point (in hexadecimal) to UTF-8 terminal or an automatic fallback character, if supported((Not all Unicode code points support fallback characters for ASCII/CP437/PETSCII terminals)) | | |U+//code// | |Send a Unicode character code point (in hexadecimal) to UTF-8 terminal or an automatic fallback character, if supported((Not all Unicode code points support fallback characters for ASCII/CP437/PETSCII terminals)) | |
|U+//code/////char// | | Send a Unicode character code point, specifying fallback character value in hexadecimal (or ''0'' for //none//) | | |U+//code//://text// | | Send a Unicode character code point, specifying fallback string) | |
| |U+//code//,//char// | | Send a Unicode character code point, specifying fallback character value in hexadecimal (or ''0'' for //none//) | |
|U+//code//!//char// | | Send a Unicode character code point, specifying fallback character only to used when no automatic fallback is available | | |U+//code//!//char// | | Send a Unicode character code point, specifying fallback character only to used when no automatic fallback is available | |
| |
==== Unicode ==== | ==== Unicode ==== |
Only UTF-8 terminals support Unicode. For other terminals (TTY/ASCII, CP437, and PETSCII), an equivalent "fallback" character may be automatically available or explicitly specified in the @-code itself. | Only UTF-8 terminals support Unicode. For other terminals (TTY/ASCII, CP437, and PETSCII), an equivalent "fallback" character may be automatically available or when using the ''U+'' @-codes, explicitly specified in the @-code itself. |
| |
The 'U+' @-code supports additional syntax to allow the sysop to specify the CP437 fallback character: | The 'U+' @-code supports additional syntax to allow the sysop to specify the CP437 fallback character: |
* ''@U+<code>/<char>@'': Send a Unicode character with specified fallback character, in hexadecimal (specify ''0'' to send //no// character to non-UTF-8 terminals) | * ''@U+<code>:<text>@'': Send a Unicode character with specified fallback character sequence (string) |
| * ''@U+<code>,<char>@'': Send a Unicode character with specified fallback character, in hexadecimal (specify ''0'' to send //no// character to non-UTF-8 terminals) |
* ''@U+<code>!<char>@'': Send a Unicode character with specified fallback character to be used //only// when no automatic fallback character is supported | * ''@U+<code>!<char>@'': Send a Unicode character with specified fallback character to be used //only// when no automatic fallback character is supported |
| |
| === Examples === |
| |
| ^ @-code ^ UTF-8 ^ CP437 ^ US-ASCII ^ |
| | WIDE:Test | ''Test'' | ''T e s t'' | ''T e s t'' | |
| | CHECKMARK | ''✓'' | ''√'' | ''+'' | |
| | COPY | ''©'' | ''(C)'' | ''(C)'' | |
| | TRADEMARK | ''™'' | ''(TM)'' | ''(TM)'' | |
| | ELLIPSIS | ''…'' | ''...'' | ''...'' | |
| | U+20AC | ''€'' | | | |
| | U+20AC,24 | ''€'' | ''$'' | ''$'' | |
| | U+2265 | ''≥'' | ''≥'' | ''>'' | |
| | U+2265!a8 | ''≥'' | ''≥'' | ''>'' | |
| | U+2265,a8 | ''≥'' | ''¿'' | ''?'' | |
| | U+1F609 | ''😉'' | | | |
| | U+1F609:;-) | ''😉'' | '';-)'' | '';-)'' | |
| |
| |
===== External Content ===== | ===== External Content ===== |
| |