1 /****************************************************************************
2 * Copyright 2019-2020,2021 Thomas E. Dickey *
3 * Copyright 2001-2016,2017 Free Software Foundation, Inc. *
5 * Permission is hereby granted, free of charge, to any person obtaining a *
6 * copy of this software and associated documentation files (the *
7 * "Software"), to deal in the Software without restriction, including *
8 * without limitation the rights to use, copy, modify, merge, publish, *
9 * distribute, distribute with modifications, sublicense, and/or sell *
10 * copies of the Software, and to permit persons to whom the Software is *
11 * furnished to do so, subject to the following conditions: *
13 * The above copyright notice and this permission notice shall be included *
14 * in all copies or substantial portions of the Software. *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
19 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
22 * THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
24 * Except as contained in this notice, the name(s) of the above copyright *
25 * holders shall not be used in advertising or otherwise to promote the *
26 * sale, use or other dealings in this Software without prior written *
28 ****************************************************************************/
33 ** The routines setcchar() and getcchar().
37 #include <curses.priv.h>
40 MODULE_ID("$Id: lib_cchar.c,v 1.37 2021/06/17 21:11:08 tom Exp $")
43 * The SuSv2 description leaves some room for interpretation. We'll assume wch
44 * points to a string which is L'\0' terminated, contains at least one
45 * character with strictly positive width, which must be the first, and
46 * contains no characters of negative width.
49 setcchar(cchar_t *wcval,
52 NCURSES_PAIRS_T pair_arg,
56 int color_pair = pair_arg;
59 TR(TRACE_CCALLS, (T_CALLED("setcchar(%p,%s,attrs=%lu,pair=%d,%p)"),
60 (void *) wcval, _nc_viswbuf(wch),
61 (unsigned long) attrs, color_pair, opts));
63 set_extended_pair(opts, color_pair);
65 || ((len = (unsigned) wcslen(wch)) > 1 && _nc_wacs_width(wch[0]) < 0)
75 * If we have a following spacing-character, stop at that point. We
76 * are only interested in adding non-spacing characters.
78 for (i = 1; i < len; ++i) {
79 if (_nc_wacs_width(wch[i]) != 0) {
85 memset(wcval, 0, sizeof(*wcval));
88 SetAttr(*wcval, attrs);
89 SetPair(CHDEREF(wcval), color_pair);
90 memcpy(&wcval->chars, wch, len * sizeof(wchar_t));
91 TR(TRACE_CCALLS, ("copy %d wchars, first is %s", len,
92 _tracecchar_t(wcval)));
96 TR(TRACE_CCALLS, (T_RETURN("%d"), code));
101 getcchar(const cchar_t *wcval,
104 NCURSES_PAIRS_T *pair_arg,
109 TR(TRACE_CCALLS, (T_CALLED("getcchar(%p,%p,%p,%p,%p)"),
110 (const void *) wcval,
116 #if !NCURSES_EXT_COLORS
125 len = ((wp = wmemchr(wcval->chars, L'\0', (size_t) CCHARW_MAX))
126 ? (int) (wp - wcval->chars)
131 * If the value is a null, set the length to 1.
132 * If the value is not a null, return the length plus 1 for null.
134 code = (len < CCHARW_MAX) ? (len + 1) : CCHARW_MAX;
135 } else if (attrs == 0 || pair_arg == 0) {
137 } else if (len >= 0) {
140 TR(TRACE_CCALLS, ("copy %d wchars, first is %s", len,
141 _tracecchar_t(wcval)));
142 *attrs = AttrOf(*wcval) & A_ATTRIBUTES;
143 color_pair = GetPair(*wcval);
144 get_extended_pair(opts, color_pair);
145 *pair_arg = limit_PAIRS(color_pair);
146 wmemcpy(wch, wcval->chars, (size_t) len);
153 TR(TRACE_CCALLS, (T_RETURN("%d"), code));