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=904fed6618b22e84597efd60c3784e57d44f3ef1;hp=0000000000000000000000000000000000000000;hpb=16a17e66c632c5f0a654a3999b57eeb61730a473;p=projects%2Fchimara%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. + + +