2010-03-08 12:29:01 -06:00
|
|
|
/* Align/Truncate a string in a given screen width
|
|
|
|
Copyright (C) 2009-2010 Free Software Foundation, Inc.
|
2014-01-29 07:09:54 -06:00
|
|
|
Copyright (C) 2010-2013 Karel Zak <kzak@redhat.com>
|
2010-03-08 12:29:01 -06:00
|
|
|
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
2013-03-15 04:48:37 -05:00
|
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
|
|
the Free Software Foundation, either version 2.1 of the License, or
|
2010-03-08 12:29:01 -06:00
|
|
|
(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 <http://www.gnu.org/licenses/>. */
|
2014-01-29 07:09:54 -06:00
|
|
|
#ifndef UTIL_LINUX_MBSALIGN_H
|
|
|
|
# define UTIL_LINUX_MBSALIGN_H
|
|
|
|
# include <stddef.h>
|
2010-03-08 12:29:01 -06:00
|
|
|
|
|
|
|
typedef enum { MBS_ALIGN_LEFT, MBS_ALIGN_RIGHT, MBS_ALIGN_CENTER } mbs_align_t;
|
|
|
|
|
|
|
|
enum {
|
|
|
|
/* Use unibyte mode for invalid multibyte strings or
|
|
|
|
or when heap memory is exhausted. */
|
|
|
|
MBA_UNIBYTE_FALLBACK = 0x0001,
|
|
|
|
|
|
|
|
#if 0 /* Other possible options. */
|
|
|
|
/* Skip invalid multibyte chars rather than failing */
|
|
|
|
MBA_IGNORE_INVALID = 0x0002,
|
|
|
|
|
|
|
|
/* Align multibyte strings using "figure space" (\u2007) */
|
|
|
|
MBA_USE_FIGURE_SPACE = 0x0004,
|
|
|
|
|
|
|
|
/* Don't add any padding */
|
|
|
|
MBA_TRUNCATE_ONLY = 0x0008,
|
|
|
|
|
|
|
|
/* Don't truncate */
|
|
|
|
MBA_PAD_ONLY = 0x0010,
|
|
|
|
#endif
|
|
|
|
};
|
|
|
|
|
2010-05-07 07:12:26 -05:00
|
|
|
extern size_t mbs_truncate(char *str, size_t *width);
|
|
|
|
|
|
|
|
extern size_t mbsalign (const char *src, char *dest,
|
|
|
|
size_t dest_size, size_t *width,
|
|
|
|
mbs_align_t align, int flags);
|
2014-01-29 07:09:54 -06:00
|
|
|
|
2016-01-22 09:51:59 -06:00
|
|
|
extern size_t mbsalign_with_padding (const char *src, char *dest, size_t dest_size,
|
|
|
|
size_t *width, mbs_align_t align, int flags,
|
|
|
|
int padchar);
|
|
|
|
|
2014-04-15 08:25:18 -05:00
|
|
|
extern size_t mbs_safe_nwidth(const char *buf, size_t bufsz, size_t *sz);
|
2014-01-29 07:09:54 -06:00
|
|
|
extern size_t mbs_safe_width(const char *s);
|
2014-04-15 06:58:34 -05:00
|
|
|
|
2020-04-22 05:22:29 -05:00
|
|
|
extern size_t mbs_nwidth(const char *buf, size_t bufsz);
|
|
|
|
extern size_t mbs_width(const char *s);
|
|
|
|
|
2014-01-29 07:09:54 -06:00
|
|
|
extern char *mbs_safe_encode(const char *s, size_t *width);
|
2016-09-06 03:51:25 -05:00
|
|
|
extern char *mbs_safe_encode_to_buffer(const char *s, size_t *width, char *buf, const char *safechars);
|
2014-04-15 06:58:34 -05:00
|
|
|
extern size_t mbs_safe_encode_size(size_t bytes);
|
2014-01-29 07:09:54 -06:00
|
|
|
|
2017-11-22 07:41:10 -06:00
|
|
|
extern char *mbs_invalid_encode(const char *s, size_t *width);
|
|
|
|
extern char *mbs_invalid_encode_to_buffer(const char *s, size_t *width, char *buf);
|
|
|
|
|
2014-01-29 07:09:54 -06:00
|
|
|
#endif /* UTIL_LINUX_MBSALIGN_H */
|