From fa095a4504cbe668e4244547e2c141597bea4ecf Mon Sep 17 00:00:00 2001 From: Andreas Rottmann Date: Mon, 14 Sep 2009 12:32:44 +0200 Subject: Imported Upstream version 0.9.1 --- doc/libunistring_9.html | 141 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 doc/libunistring_9.html (limited to 'doc/libunistring_9.html') diff --git a/doc/libunistring_9.html b/doc/libunistring_9.html new file mode 100644 index 00000000..0586e0f2 --- /dev/null +++ b/doc/libunistring_9.html @@ -0,0 +1,141 @@ + + + + + +GNU libunistring: 9. Display width <uniwidth.h> + + + + + + + + + + + + + + + + + + + + + + + + + + +
[ << ][ >> ]           [Top][Contents][Index][ ? ]
+ +
+ + +

9. Display width <uniwidth.h>

+ +

This include file declares functions that return the display width, measured +in columns, of characters or strings, when output to a device that uses +non-proportional fonts. +

+ +

Note that for some rarely used characters the actual fonts or terminal +emulators can use a different width. There is no mechanism for communicating +the display width of characters across a Unix pseudo-terminal (tty). Also, +there are scripts with complex rendering, like the Indic scripts. For these +scripts, there is no such concept as non-proportional fonts. Therefore +the results of these functions usually work fine on most scripts and on +most characters but can fail to represent the actual display width. +

+

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

+ + + +
+
Function: int uc_width (ucs4_t uc, const char *encoding) + +
+

Determines and returns the number of column positions required for uc. +Returns -1 if uc is a control character that has an influence on the +column position when output. +

+ +
+
Function: int u8_width (const uint8_t *s, size_t n, const char *encoding) + +
+
Function: int u16_width (const uint16_t *s, size_t n, const char *encoding) + +
+
Function: int u32_width (const uint32_t *s, size_t n, const char *encoding) + +
+

Determines and returns the number of column positions required for first +n units (or fewer if s ends before this) in s. This +function ignores control characters in the string. +

+ +
+
Function: int u8_strwidth (const uint8_t *s, const char *encoding) + +
+
Function: int u16_strwidth (const uint16_t *s, const char *encoding) + +
+
Function: int u32_strwidth (const uint32_t *s, const char *encoding) + +
+

Determines and returns the number of column positions required for s. +This function ignores control characters in the string. +

+
+ + + + + + + + + + + + +
[ << ][ >> ]           [Top][Contents][Index][ ? ]
+

+ + This document was generated by Bruno Haible on July, 1 2009 using texi2html 1.78a. + +
+ +

+ + -- cgit v1.2.3