[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Unicode string width functions

From: Bruno Haible
Subject: Unicode string width functions
Date: Sat, 7 Jul 2007 18:58:42 +0200
User-agent: KMail/1.5.4

The fifth part of the Unicode string library: functions for determining the
display width of Unicode characters and strings (assuming non-proportional

Like wcwidth, this can never be perfect, because terminal emulators don't
behave exactly the same way. But it should be good enough for many languages
and xterm.

2007-07-07  Bruno Haible  <address@hidden>

        * MODULES.html.sh (Unicode string functions): Add the new modules.

        * tests/uniwidth/test-u32-strwidth.c: New file.
        * modules/uniwidth/u32-strwidth-tests: New file.

        * lib/uniwidth/u32-strwidth.c: New file.
        * modules/uniwidth/u32-strwidth: New file.

        * tests/uniwidth/test-u16-strwidth.c: New file.
        * modules/uniwidth/u16-strwidth-tests: New file.

        * lib/uniwidth/u16-strwidth.c: New file.
        * modules/uniwidth/u16-strwidth: New file.

        * tests/uniwidth/test-u8-strwidth.c: New file.
        * modules/uniwidth/u8-strwidth-tests: New file.

        * lib/uniwidth/u8-strwidth.c: New file.
        * modules/uniwidth/u8-strwidth: New file.

        * tests/uniwidth/test-u32-width.c: New file.
        * modules/uniwidth/u32-width-tests: New file.

        * lib/uniwidth/u32-width.c: New file.
        * modules/uniwidth/u32-width: New file.

        * tests/uniwidth/test-u16-width.c: New file.
        * modules/uniwidth/u16-width-tests: New file.

        * lib/uniwidth/u16-width.c: New file.
        * modules/uniwidth/u16-width: New file.

        * tests/uniwidth/test-u8-width.c: New file.
        * modules/uniwidth/u8-width-tests: New file.

        * lib/uniwidth/u8-width.c: New file.
        * modules/uniwidth/u8-width: New file.

        * tests/uniwidth/test-uc_width.c: New file.
        * modules/uniwidth/width-tests: New file.

        * lib/uniwidth/width.c: New file, from GNU libiconv.
        * lib/uniwidth/cjk.h: New file, from GNU libiconv.
        * modules/uniwidth/width: New file.

        * lib/uniwidth.h: New file, from GNU libiconv.
        * modules/uniwidth/base: New file.

============================= lib/uniwidth.h ==============================
/* Display width functions.
   Copyright (C) 2001-2002, 2005, 2007 Free Software Foundation, Inc.

   This program is free software; you can redistribute it and/or modify it
   under the terms of the GNU Library General Public License as published
   by the Free Software Foundation; either version 2, or (at your option)
   any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
   USA.  */

#ifndef _UNIWIDTH_H
#define _UNIWIDTH_H

#include "unitypes.h"

/* Get size_t.  */
#include <stddef.h>

/* Get locale_charset() declaration.  */
#include "localcharset.h"

#ifdef __cplusplus
extern "C" {

/* Display width.  */

/* These functions are locale dependent.  The encoding argument identifies
   the encoding (e.g. "ISO-8859-2" for Polish).  */

/* Determine number of column positions required for UC.  */
extern int
       uc_width (ucs4_t uc, const char *encoding);

/* Determine number of column positions required for first N units
   (or fewer if S ends before this) in S.  */
extern int
       u8_width (const uint8_t *s, size_t n, const char *encoding);
extern int
       u16_width (const uint16_t *s, size_t n, const char *encoding);
extern int
       u32_width (const uint32_t *s, size_t n, const char *encoding);

/* Determine number of column positions required for S.  */
extern int
       u8_strwidth (const uint8_t *s, const char *encoding);
extern int
       u16_strwidth (const uint16_t *s, const char *encoding);
extern int
       u32_strwidth (const uint32_t *s, const char *encoding);

#ifdef __cplusplus

#endif /* _UNIWIDTH_H */

reply via email to

[Prev in Thread] Current Thread [Next in Thread]