'\" te
.\"  Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
.TH euclen 3C "20 Dec 1996" "SunOS 5.11" "Standard C Library Functions"
.SH NAME
euclen, euccol, eucscol \- get byte length and display width of EUC characters
.SH SYNOPSIS
.LP
.nf
#include <euc.h>

\fBint\fR \fBeuclen\fR(\fBconst unsigned char *\fR\fIs\fR);
.fi

.LP
.nf
\fBint\fR \fBeuccol\fR(\fBconst unsigned char *\fR\fIs\fR);
.fi

.LP
.nf
\fBint\fR \fBeucscol\fR(\fBconst unsigned char *\fR\fIstr\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBeuclen()\fR function returns the length in bytes of the Extended Unix Code (EUC) character pointed to by \fIs\fR, including single-shift characters, if present.
.sp
.LP
The \fBeuccol()\fR function returns the screen column width of the \fBEUC\fR character pointed to by \fIs\fR.
.sp
.LP
The \fBeucscol()\fR function returns the screen column width of the \fBEUC\fR string pointed to by \fIstr\fR.
.sp
.LP
For the \fBeuclen()\fR and \fBeuccol()\fR, functions, \fIs\fR points to the first byte of the character. This byte is examined to determine its codeset. The character type table for the current \fIlocale\fR is used for codeset byte length and display width information.
.SH USAGE
.sp
.LP
These functions will work only with \fBEUC\fR locales.
.sp
.LP
These functions can be used safely in multithreaded applications, as long as \fBsetlocale\fR(3C) is not called to change the locale.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
lw(2.75i) lw(2.75i) 
lw(2.75i) lw(2.75i) 
.
\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR
MT-LevelMT-Safe with exceptions
.TE

.SH SEE ALSO
.sp
.LP
\fBgetwidth\fR(3C), \fBsetlocale\fR(3C), \fBattributes\fR(5)