X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=docs%2Freference%2Fglk-line-input.sgml;fp=docs%2Freference%2Fglk-line-input.sgml;h=f88692c3dc3139ab911d14aa1a4bdbb8fe54d087;hb=062bbb9e7322c8e3f5162f86fc2f93bfc587b830;hp=0000000000000000000000000000000000000000;hpb=db0f0fc8ee25926da8d34b826a3fc80d6186adbb;p=rodin%2Fchimara.git diff --git a/docs/reference/glk-line-input.sgml b/docs/reference/glk-line-input.sgml new file mode 100644 index 0000000..f88692c --- /dev/null +++ b/docs/reference/glk-line-input.sgml @@ -0,0 +1,33 @@ + + + + +Line Input +3 +CHIMARA Library + + +Line Input +Reading lines of text + + +Description + +You can request that the player enter a line of text. See Line Input Events. + + +This text will be placed in a buffer of your choice. There is no length field or null terminator in the buffer. (The length of the text is returned as part of the line-input event.) + + +If you use the basic text API, the buffer will contain only printable Latin-1 characters (32 to 126, 160 to 255). + + +A particular implementation of Glk may not be able to accept all Latin-1 printable characters as input. It is guaranteed to be able to accept the ASCII characters (32 to 126.) + + +You can test for this by using the #gestalt_LineInput selector. + + +