changeset 7268 | 8b9571baf00a |
parent 5810 | 76203f2cf39d |
child 7273 | 4ca0c1aeae9b |
7267:a018f837e213 | 7268:8b9571baf00a |
---|---|
234 .fi |
234 .fi |
235 |
235 |
236 .SH DESCRIPTION |
236 .SH DESCRIPTION |
237 .sp |
237 .sp |
238 .LP |
238 .LP |
239 The \fBgl_get_line()\fR function is part of the \fBlibtecla\fR(3LIB) library. If the user is typing at a terminal, each call prompts them for an line of input, then provides interactive editing facilities, similar to those of the UNIX \fBtcsh\fR shell. In addition to simple command-line editing, it supports recall of previously entered command lines, TAB completion of file names, and in-line wild-card expansion of filenames. Documentation of both the user-level command-line editing features and all user configuration options can be found on the \fBtecla\fR(5) manual page. |
239 The \fBgl_get_line()\fR function is part of the \fBlibtecla\fR(3LIB) library. If the user is typing at a terminal, each call prompts them for an line of input, then provides interactive editing facilities, similar to those of the UNIX \fBtcsh\fR shell. In addition to simple command-line editing, it supports recall of previously entered command lines, TAB completion of file names, and in-line wild-card expansion of filenames. Documentation of both the user-level command-line editing features and all user configuration options can be found on the \fBtecla\fR(7) manual page. |
240 .SS "An Example" |
240 .SS "An Example" |
241 .sp |
241 .sp |
242 .LP |
242 .LP |
243 The following shows a complete example of how to use the \fBgl_get_line()\fR function to get input from the user: |
243 The following shows a complete example of how to use the \fBgl_get_line()\fR function to get input from the user: |
244 .sp |
244 .sp |
1749 .in -2 |
1749 .in -2 |
1750 .sp |
1750 .sp |
1751 |
1751 |
1752 .sp |
1752 .sp |
1753 .LP |
1753 .LP |
1754 at the shell prompt. Further documentation on how the user can make use of this to enter international characters can be found in the \fBtecla\fR(5) man page. |
1754 at the shell prompt. Further documentation on how the user can make use of this to enter international characters can be found in the \fBtecla\fR(7) man page. |
1755 .SS "Thread Safety" |
1755 .SS "Thread Safety" |
1756 .sp |
1756 .sp |
1757 .LP |
1757 .LP |
1758 Unfortunately neither \fBterminfo\fR nor \fBtermcap\fR were designed to be reentrant, so you cannot safely use the functions of the getline module in multiple threads (you can use the separate file-expansion and word-completion modules in multiple threads, see the corresponding man pages for details). However due to the use of POSIX reentrant functions for looking up home directories, it is safe to use this module from a single thread of a multi-threaded program, provided that your other threads do not use any \fBtermcap\fR or \fBterminfo\fR functions. |
1758 Unfortunately neither \fBterminfo\fR nor \fBtermcap\fR were designed to be reentrant, so you cannot safely use the functions of the getline module in multiple threads (you can use the separate file-expansion and word-completion modules in multiple threads, see the corresponding man pages for details). However due to the use of POSIX reentrant functions for looking up home directories, it is safe to use this module from a single thread of a multi-threaded program, provided that your other threads do not use any \fBtermcap\fR or \fBterminfo\fR functions. |
1759 .SH ATTRIBUTES |
1759 .SH ATTRIBUTES |