'\" te
.\"  Copyright (c) 1990, 1995 by Mortice Kern Systems Inc.  All Rights Reserved  Portions Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
.TH longname 3XCURSES "5 Jun 2002" "SunOS 5.11" "X/Open Curses Library Functions"
.SH NAME
longname \- return full terminal type name
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-I\fR /usr/xpg4/include \fB -L \fR /usr/xpg4/lib \e
\fB -R \fR /usr/xpg4/lib \fB -lcurses \fR [ \fIlibrary\fR... ]

\fBc89\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lcurses\fR [ \fIlibrary\fR... ]

#include <curses.h>

\fBconst char *\fR\fBlongname\fR(\fBvoid\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBlongname()\fR function returns a pointer to a static area containing a  verbose description (128 characters or fewer) of the terminal.  The area is defined after calls to \fBinitscr\fR(3XCURSES), \fBnewterm\fR(3XCURSES), or \fBsetupterm\fR(3XCURSES). The value should be saved if \fBlongname()\fR is going to be used with  multiple terminals since it will be overwritten with a new value after each  call to \fBnewterm()\fR or \fB setupterm()\fR.
.SH RETURN VALUES
.sp
.LP
On success, the \fBlongname()\fR function returns a pointer to a verbose  description of the terminal. Otherwise, it returns a null pointer.
.SH ERRORS
.sp
.LP
None.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelUnsafe
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBinitscr\fR(3XCURSES), \fBlibcurses\fR(3XCURSES), \fBnewterm\fR(3XCURSES), \fBsetupterm\fR(3XCURSES), \fBattributes\fR(5), \fBstandards\fR(5)