139f2269fSPeter Wemm /****************************************************************************
25ca44d1cSRong-En Fan  * Copyright 2019-2020,2021 Thomas E. Dickey                                *
339f2269fSPeter Wemm  * Copyright 2001-2016,2017 Free Software Foundation, Inc.                  *
439f2269fSPeter Wemm  *                                                                          *
539f2269fSPeter Wemm  * Permission is hereby granted, free of charge, to any person obtaining a  *
639f2269fSPeter Wemm  * copy of this software and associated documentation files (the            *
739f2269fSPeter Wemm  * "Software"), to deal in the Software without restriction, including      *
839f2269fSPeter Wemm  * without limitation the rights to use, copy, modify, merge, publish,      *
939f2269fSPeter Wemm  * distribute, distribute with modifications, sublicense, and/or sell       *
1039f2269fSPeter Wemm  * copies of the Software, and to permit persons to whom the Software is    *
1139f2269fSPeter Wemm  * furnished to do so, subject to the following conditions:                 *
1239f2269fSPeter Wemm  *                                                                          *
1339f2269fSPeter Wemm  * The above copyright notice and this permission notice shall be included  *
1439f2269fSPeter Wemm  * in all copies or substantial portions of the Software.                   *
1539f2269fSPeter Wemm  *                                                                          *
1639f2269fSPeter Wemm  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
1739f2269fSPeter Wemm  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
1839f2269fSPeter Wemm  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
1939f2269fSPeter Wemm  * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
2039f2269fSPeter Wemm  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
2139f2269fSPeter Wemm  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
2239f2269fSPeter Wemm  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
2339f2269fSPeter Wemm  *                                                                          *
2439f2269fSPeter Wemm  * Except as contained in this notice, the name(s) of the above copyright   *
2539f2269fSPeter Wemm  * holders shall not be used in advertising or otherwise to promote the     *
2639f2269fSPeter Wemm  * sale, use or other dealings in this Software without prior written       *
2739f2269fSPeter Wemm  * authorization.                                                           *
2839f2269fSPeter Wemm  ****************************************************************************/
2939f2269fSPeter Wemm 
3039f2269fSPeter Wemm /*
3139f2269fSPeter Wemm **	lib_cchar.c
3239f2269fSPeter Wemm **
3339f2269fSPeter Wemm **	The routines setcchar() and getcchar().
3439f2269fSPeter Wemm **
3539f2269fSPeter Wemm */
3639f2269fSPeter Wemm 
3739f2269fSPeter Wemm #include <curses.priv.h>
385ca44d1cSRong-En Fan #include <wchar.h>
3939f2269fSPeter Wemm 
4039f2269fSPeter Wemm MODULE_ID("$Id: lib_cchar.c,v 1.35 2021/01/17 00:04:08 tom Exp $")
4139f2269fSPeter Wemm 
424a1a9510SRong-En Fan /*
434a1a9510SRong-En Fan  * The SuSv2 description leaves some room for interpretation.  We'll assume wch
444a1a9510SRong-En Fan  * points to a string which is L'\0' terminated, contains at least one
4539f2269fSPeter Wemm  * character with strictly positive width, which must be the first, and
4639f2269fSPeter Wemm  * contains no characters of negative width.
474a1a9510SRong-En Fan  */
NCURSES_EXPORT(int)484a1a9510SRong-En Fan NCURSES_EXPORT(int)
494a1a9510SRong-En Fan setcchar(cchar_t *wcval,
504a1a9510SRong-En Fan 	 const wchar_t *wch,
514a1a9510SRong-En Fan 	 const attr_t attrs,
5239f2269fSPeter Wemm 	 NCURSES_PAIRS_T pair_arg,
5339f2269fSPeter Wemm 	 const void *opts)
5439f2269fSPeter Wemm {
5539f2269fSPeter Wemm     int code = OK;
5639f2269fSPeter Wemm     int color_pair = pair_arg;
575ca44d1cSRong-En Fan     unsigned len;
585ca44d1cSRong-En Fan 
595ca44d1cSRong-En Fan     TR(TRACE_CCALLS, (T_CALLED("setcchar(%p,%s,attrs=%lu,pair=%d,%p)"),
6039f2269fSPeter Wemm 		      (void *) wcval, _nc_viswbuf(wch),
614a1a9510SRong-En Fan 		      (unsigned long) attrs, color_pair, opts));
624a1a9510SRong-En Fan 
634a1a9510SRong-En Fan     set_extended_pair(opts, color_pair);
6439f2269fSPeter Wemm     if (wch == NULL
6539f2269fSPeter Wemm 	|| ((len = (unsigned) wcslen(wch)) > 1 && _nc_wacs_width(wch[0]) < 0)
664a1a9510SRong-En Fan 	|| color_pair < 0) {
674a1a9510SRong-En Fan 	code = ERR;
6839f2269fSPeter Wemm     } else {
694a1a9510SRong-En Fan 	unsigned i;
704a1a9510SRong-En Fan 
714a1a9510SRong-En Fan 	if (len > CCHARW_MAX)
724a1a9510SRong-En Fan 	    len = CCHARW_MAX;
7339f2269fSPeter Wemm 
7439f2269fSPeter Wemm 	/*
754a1a9510SRong-En Fan 	 * If we have a following spacing-character, stop at that point.  We
7639f2269fSPeter Wemm 	 * are only interested in adding non-spacing characters.
7739f2269fSPeter Wemm 	 */
7839f2269fSPeter Wemm 	for (i = 1; i < len; ++i) {
7939f2269fSPeter Wemm 	    if (_nc_wacs_width(wch[i]) != 0) {
8039f2269fSPeter Wemm 		len = i;
8139f2269fSPeter Wemm 		break;
8239f2269fSPeter Wemm 	    }
834a1a9510SRong-En Fan 	}
844a1a9510SRong-En Fan 
8539f2269fSPeter Wemm 	memset(wcval, 0, sizeof(*wcval));
8639f2269fSPeter Wemm 
8739f2269fSPeter Wemm 	if (len != 0) {
8839f2269fSPeter Wemm 	    SetAttr(*wcval, attrs);
8939f2269fSPeter Wemm 	    SetPair(CHDEREF(wcval), color_pair);
9039f2269fSPeter Wemm 	    memcpy(&wcval->chars, wch, len * sizeof(wchar_t));
9139f2269fSPeter Wemm 	    TR(TRACE_CCALLS, ("copy %d wchars, first is %s", len,
9239f2269fSPeter Wemm 			      _tracecchar_t(wcval)));
9339f2269fSPeter Wemm 	}
9439f2269fSPeter Wemm     }
9539f2269fSPeter Wemm 
964a1a9510SRong-En Fan     TR(TRACE_CCALLS, (T_RETURN("%d"), code));
974a1a9510SRong-En Fan     return (code);
984a1a9510SRong-En Fan }
994a1a9510SRong-En Fan 
1004a1a9510SRong-En Fan NCURSES_EXPORT(int)
getcchar(const cchar_t * wcval,wchar_t * wch,attr_t * attrs,NCURSES_PAIRS_T * pair_arg,void * opts)10139f2269fSPeter Wemm getcchar(const cchar_t *wcval,
10239f2269fSPeter Wemm 	 wchar_t *wch,
10339f2269fSPeter Wemm 	 attr_t *attrs,
10439f2269fSPeter Wemm 	 NCURSES_PAIRS_T *pair_arg,
10539f2269fSPeter Wemm 	 void *opts)
10639f2269fSPeter Wemm {
10739f2269fSPeter Wemm     int code = ERR;
10839f2269fSPeter Wemm     int color_pair;
10939f2269fSPeter Wemm 
11039f2269fSPeter Wemm     TR(TRACE_CCALLS, (T_CALLED("getcchar(%p,%p,%p,%p,%p)"),
11139f2269fSPeter Wemm 		      (const void *) wcval,
11239f2269fSPeter Wemm 		      (void *) wch,
11339f2269fSPeter Wemm 		      (void *) attrs,
11439f2269fSPeter Wemm 		      (void *) pair_arg,
11539f2269fSPeter Wemm 		      opts));
1164a1a9510SRong-En Fan 
1174a1a9510SRong-En Fan #if !NCURSES_EXT_COLORS
11839f2269fSPeter Wemm     if (opts != NULL) {
11939f2269fSPeter Wemm 	;			/* empty */
1204a1a9510SRong-En Fan     } else
12139f2269fSPeter Wemm #endif
12239f2269fSPeter Wemm     if (wcval != NULL) {
12339f2269fSPeter Wemm 	wchar_t *wp;
12439f2269fSPeter Wemm 	int len;
12539f2269fSPeter Wemm 
12639f2269fSPeter Wemm 	len = ((wp = wmemchr(wcval->chars, L'\0', (size_t) CCHARW_MAX))
12739f2269fSPeter Wemm 	       ? (int) (wp - wcval->chars)
12839f2269fSPeter Wemm 	       : CCHARW_MAX);
12939f2269fSPeter Wemm 
130 	if (wch == NULL) {
131 	    /*
132 	     * If the value is a null, set the length to 1.
133 	     * If the value is not a null, return the length plus 1 for null.
134 	     */
135 	    code = (len < CCHARW_MAX) ? (len + 1) : CCHARW_MAX;
136 	} else if (attrs == 0 || pair_arg == 0) {
137 	    code = ERR;
138 	} else if (len >= 0) {
139 	    TR(TRACE_CCALLS, ("copy %d wchars, first is %s", len,
140 			      _tracecchar_t(wcval)));
141 	    *attrs = AttrOf(*wcval) & A_ATTRIBUTES;
142 	    color_pair = GetPair(*wcval);
143 	    get_extended_pair(opts, color_pair);
144 	    *pair_arg = limit_PAIRS(color_pair);
145 	    wmemcpy(wch, wcval->chars, (size_t) len);
146 	    wch[len] = L'\0';
147 	    if (*pair_arg >= 0)
148 		code = OK;
149 	}
150     }
151 
152     TR(TRACE_CCALLS, (T_RETURN("%d"), code));
153     return (code);
154 }
155