.TH tgoto() "" "" "termcap Function (libterm)"
.PC "Read/interpret termcap cursor-addressing string"
.B "#include <curses.h>"
.B "#include <term.h>"
\fBchar *tgoto(\fIcm, destcol, destline\^\fB)\fR
\fBchar *\fIcm\fB; int \fIscrcol\^\fB, \fIscrline\^\fB;\fR
.PP
.B tgoto()
is one of a set of functions that read a
.B termcap
terminal description.
It decodes
a cursor-addressing string from the
.I cm
.B termcap
feature, and writes it onto the screen, at column
.I scrcol
and line
.IR destline .
.B tgoto()
uses the external variables
.B UP
(from the
.B up
feature) and
.B BC
(if
.B bc
is given rather than \fBbs\fR)
if it is necessary to avoid placing \fB\en, <ctrl-D>\fR, or \fB<ctrl-@>\fR
into the returned string.
Programs calling
.B tgoto()
should turn off the
.B XTABS
bits, as
.B tgoto()
may write a tab.
If a \*(Ql%\*(Qr sequence is given that is not understood,
.B tgoto()
returns \*(QLOOPS\*(QR.
.SH Files
\fB/etc/termcap\fR \(em Terminal capabilities data base
.br
\fB/usr/lib/libterm.a\fR \(em Function library
.SH "See Also"
.Xr "termcap" termcap
