summaryrefslogtreecommitdiffstats
path: root/lib/mbsalign.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/mbsalign.h')
-rw-r--r--lib/mbsalign.h63
1 files changed, 63 insertions, 0 deletions
diff --git a/lib/mbsalign.h b/lib/mbsalign.h
new file mode 100644
index 0000000..37a9af5
--- /dev/null
+++ b/lib/mbsalign.h
@@ -0,0 +1,63 @@
+/* Align/Truncate a string in a given screen width
+ Copyright (C) 2009-2023 Free Software Foundation, Inc.
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, 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
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>. */
+
+#include <stddef.h>
+#include <stdlib.h>
+
+typedef enum { MBS_ALIGN_LEFT, MBS_ALIGN_RIGHT, MBS_ALIGN_CENTER } mbs_align_t;
+
+enum {
+ /* Use unibyte mode for invalid multibyte strings
+ or when heap memory is exhausted. */
+ MBA_UNIBYTE_FALLBACK = 0x0001,
+
+ /* As an optimization, don't do multibyte processing
+ when we know no multibyte characters are present. */
+ MBA_UNIBYTE_ONLY = 0x0002,
+
+ /* Don't add leading padding. */
+ MBA_NO_LEFT_PAD = 0x0004,
+
+ /* Don't add trailing padding. */
+ MBA_NO_RIGHT_PAD = 0x0008
+
+#if 0 /* Other possible options. */
+ /* Skip invalid multibyte chars rather than failing. */
+ MBA_IGNORE_INVALID
+
+ /* Align multibyte strings using "figure space" (\u2007). */
+ MBA_USE_FIGURE_SPACE
+
+ /* Don't truncate. */
+ MBA_NO_TRUNCATE
+
+ /* Ensure no leading whitespace. */
+ MBA_LSTRIP
+
+ /* Ensure no trailing whitespace. */
+ MBA_RSTRIP
+#endif
+};
+
+size_t
+mbsalign (char const *src, char *dest, size_t dest_size,
+ size_t *width, mbs_align_t align, int flags)
+ _GL_ATTRIBUTE_NONNULL ();
+
+char *
+ambsalign (char const *src, size_t *width, mbs_align_t align, int flags)
+ _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE
+ _GL_ATTRIBUTE_NONNULL ();