subrotina wcwidth

Propósito

Determina a largura de exibição de caracteres amplos.

Biblioteca

Biblioteca C Padrão (libc.a)

Sintaxe

#include <string.h>
int wcwidth ( WC)
wchar_t WC;

Descrição

A subroutine wcwidth determina o número de colunas de exibição a serem ocupadas pelo amplo caractere especificado pelo parâmetro WC . A subroutine LC_CTYPE afeta o comportamento da subroutina wcwidth .

Parâmetros

Item Descrição
WC Especifica um caráter amplo.

Valores De Retorno

O subroutine wcwidth retorna o número de colunas de exibição a serem ocupadas pelo parâmetro WC . Se o parâmetro WC for um caractere amplo nulo, um valor de 0 será retornado. Se o parâmetro WC apontar para um código de caractere largo inutilizável, será retornado -1.

Exemplos

Para encontrar a largura da coluna de exibição de um caractere amplo, utilize o seguinte:

#include <string.h>
#include <locale.h>
#include <stdlib.h>
 
main()
{
   wchar_t wc;
   int   retval;
 
   (void)setlocale(LC_ALL, "");
   /* Let wc be the wide character whose
   ** display width is to be found.
   */
   retval= wcwidth( wc );
   if(retval == -1){
            /* 
            ** Error handling. Invalid wide character in wc.
            */
   }
}