xref: /dragonfly/contrib/dialog/inputstr.c (revision e8c03636)
1 /*
2  *  $Id: inputstr.c,v 1.72 2012/12/30 22:11:37 tom Exp $
3  *
4  *  inputstr.c -- functions for input/display of a string
5  *
6  *  Copyright 2000-2011,2012	Thomas E. Dickey
7  *
8  *  This program is free software; you can redistribute it and/or modify
9  *  it under the terms of the GNU Lesser General Public License, version 2.1
10  *  as published by the Free Software Foundation.
11  *
12  *  This program is distributed in the hope that it will be useful, but
13  *  WITHOUT ANY WARRANTY; without even the implied warranty of
14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  *  Lesser General Public License for more details.
16  *
17  *  You should have received a copy of the GNU Lesser General Public
18  *  License along with this program; if not, write to
19  *	Free Software Foundation, Inc.
20  *	51 Franklin St., Fifth Floor
21  *	Boston, MA 02110, USA.
22  */
23 
24 #include <dialog.h>
25 #include <dlg_keys.h>
26 
27 #include <errno.h>
28 
29 #ifdef HAVE_SETLOCALE
30 #include <locale.h>
31 #endif
32 
33 #if defined(HAVE_SEARCH_H) && defined(HAVE_TSEARCH)
34 #include <search.h>
35 #else
36 #undef HAVE_TSEARCH
37 #endif
38 
39 #ifdef NEED_WCHAR_H
40 #include <wchar.h>
41 #endif
42 
43 #if defined(USE_WIDE_CURSES)
44 #define USE_CACHING 1
45 #elif defined(HAVE_XDIALOG)
46 #define USE_CACHING 1		/* editbox really needs caching! */
47 #else
48 #define USE_CACHING 0
49 #endif
50 
51 typedef struct _cache {
52     struct _cache *next;
53 #if USE_CACHING
54     struct _cache *cache_at;	/* unique: associate caches by CACHE */
55     const char *string_at;	/* unique: associate caches by char* */
56 #endif
57     size_t s_len;		/* strlen(string) - we add 1 for EOS */
58     size_t i_len;		/* length(list) - we add 1 for EOS */
59     char *string;		/* a copy of the last-processed string */
60     int *list;			/* indices into the string */
61 } CACHE;
62 
63 #if USE_CACHING
64 #define SAME_CACHE(c,s,l) (c->string != 0 && memcmp(c->string,s,l) == 0)
65 
66 static CACHE *cache_list;
67 
68 #ifdef HAVE_TSEARCH
69 static void *sorted_cache;
70 #endif
71 
72 #ifdef USE_WIDE_CURSES
73 static int
74 have_locale(void)
75 {
76     static int result = -1;
77     if (result < 0) {
78 	char *test = setlocale(LC_ALL, 0);
79 	if (test == 0 || *test == 0) {
80 	    result = FALSE;
81 	} else if (strcmp(test, "C") && strcmp(test, "POSIX")) {
82 	    result = TRUE;
83 	} else {
84 	    result = FALSE;
85 	}
86     }
87     return result;
88 }
89 #endif
90 
91 #ifdef HAVE_TSEARCH
92 static int
93 compare_cache(const void *a, const void *b)
94 {
95     const CACHE *p = (const CACHE *) a;
96     const CACHE *q = (const CACHE *) b;
97     int result = 0;
98     result = (int) (p->cache_at - q->cache_at);
99     if (result == 0)
100 	result = (int) (p->string_at - q->string_at);
101     return result;
102 }
103 #endif
104 
105 static CACHE *
106 find_cache(CACHE * cache, const char *string)
107 {
108     CACHE *p;
109 
110 #ifdef HAVE_TSEARCH
111     void *pp;
112     CACHE find;
113 
114     memset(&find, 0, sizeof(find));
115     find.cache_at = cache;
116     find.string_at = string;
117 
118     if ((pp = tfind(&find, &sorted_cache, compare_cache)) != 0) {
119 	p = *(CACHE **) pp;
120     } else {
121 	p = 0;
122     }
123 #else
124     for (p = cache_list; p != 0; p = p->next) {
125 	if (p->cache_at == cache
126 	    && p->string_at == string) {
127 	    break;
128 	}
129     }
130 #endif
131     return p;
132 }
133 
134 static void
135 make_cache(CACHE * cache, const char *string)
136 {
137     CACHE *p;
138 
139     p = dlg_calloc(CACHE, 1);
140     assert_ptr(p, "load_cache");
141     p->next = cache_list;
142     cache_list = p;
143 
144     p->cache_at = cache;
145     p->string_at = string;
146 
147     *cache = *p;
148 #ifdef HAVE_TSEARCH
149     (void) tsearch(p, &sorted_cache, compare_cache);
150 #endif
151 }
152 
153 static void
154 load_cache(CACHE * cache, const char *string)
155 {
156     CACHE *p;
157 
158     if ((p = find_cache(cache, string)) != 0) {
159 	*cache = *p;
160     } else {
161 	make_cache(cache, string);
162     }
163 }
164 
165 static void
166 save_cache(CACHE * cache, const char *string)
167 {
168     CACHE *p;
169 
170     if ((p = find_cache(cache, string)) != 0) {
171 	CACHE *q = p->next;
172 	*p = *cache;
173 	p->next = q;
174     }
175 }
176 #else
177 #define SAME_CACHE(c,s,l) (c->string != 0)
178 #define load_cache(cache, string)	/* nothing */
179 #define save_cache(cache, string)	/* nothing */
180 #endif /* USE_WIDE_CURSES */
181 
182 /*
183  * If the given string has not changed, we do not need to update the index.
184  * If we need to update the index, allocate enough memory for it.
185  */
186 static bool
187 same_cache2(CACHE * cache, const char *string, unsigned i_len)
188 {
189     unsigned need;
190     size_t s_len = strlen(string);
191 
192     if (cache->s_len != 0
193 	&& cache->s_len >= s_len
194 	&& cache->list != 0
195 	&& SAME_CACHE(cache, string, (size_t) s_len)) {
196 	return TRUE;
197     }
198 
199     need = (i_len + 1);
200     if (cache->list == 0) {
201 	cache->list = dlg_malloc(int, need);
202     } else if (cache->i_len < i_len) {
203 	cache->list = dlg_realloc(int, need, cache->list);
204     }
205     cache->i_len = i_len;
206 
207     if (cache->s_len >= s_len && cache->string != 0) {
208 	strcpy(cache->string, string);
209     } else {
210 	if (cache->string != 0)
211 	    free(cache->string);
212 	cache->string = dlg_strclone(string);
213     }
214     cache->s_len = s_len;
215 
216     return FALSE;
217 }
218 
219 #ifdef USE_WIDE_CURSES
220 /*
221  * Like same_cache2(), but we are only concerned about caching a copy of the
222  * string and its associated length.
223  */
224 static bool
225 same_cache1(CACHE * cache, const char *string, size_t i_len)
226 {
227     size_t s_len = strlen(string);
228 
229     if (cache->s_len == s_len
230 	&& SAME_CACHE(cache, string, (size_t) s_len)) {
231 	return TRUE;
232     }
233 
234     if (cache->s_len >= s_len && cache->string != 0) {
235 	strcpy(cache->string, string);
236     } else {
237 	if (cache->string != 0)
238 	    free(cache->string);
239 	cache->string = dlg_strclone(string);
240     }
241     cache->s_len = s_len;
242     cache->i_len = i_len;
243 
244     return FALSE;
245 }
246 #endif /* USE_CACHING */
247 
248 /*
249  * Counts the number of bytes that make up complete wide-characters, up to byte
250  * 'len'.  If there is no locale set, simply return the original length.
251  */
252 #ifdef USE_WIDE_CURSES
253 static int
254 dlg_count_wcbytes(const char *string, size_t len)
255 {
256     int result;
257 
258     if (have_locale()) {
259 	static CACHE cache;
260 
261 	load_cache(&cache, string);
262 	if (!same_cache1(&cache, string, len)) {
263 	    while (len != 0) {
264 		size_t code = 0;
265 		const char *src = cache.string;
266 		mbstate_t state;
267 		char save = cache.string[len];
268 
269 		cache.string[len] = '\0';
270 		memset(&state, 0, sizeof(state));
271 		code = mbsrtowcs((wchar_t *) 0, &src, len, &state);
272 		cache.string[len] = save;
273 		if ((int) code >= 0) {
274 		    break;
275 		}
276 		--len;
277 	    }
278 	    cache.i_len = len;
279 	    save_cache(&cache, string);
280 	}
281 	result = (int) cache.i_len;
282     } else {
283 	result = (int) len;
284     }
285     return result;
286 }
287 #endif /* USE_WIDE_CURSES */
288 
289 /*
290  * Counts the number of wide-characters in the string.
291  */
292 int
293 dlg_count_wchars(const char *string)
294 {
295     int result;
296 
297 #ifdef USE_WIDE_CURSES
298     if (have_locale()) {
299 	static CACHE cache;
300 	size_t len = strlen(string);
301 
302 	load_cache(&cache, string);
303 	if (!same_cache1(&cache, string, len)) {
304 	    const char *src = cache.string;
305 	    mbstate_t state;
306 	    int part = dlg_count_wcbytes(cache.string, len);
307 	    char save = cache.string[part];
308 	    size_t code;
309 	    wchar_t *temp = dlg_calloc(wchar_t, len + 1);
310 
311 	    if (temp != 0) {
312 		cache.string[part] = '\0';
313 		memset(&state, 0, sizeof(state));
314 		code = mbsrtowcs(temp, &src, (size_t) part, &state);
315 		cache.i_len = ((int) code >= 0) ? wcslen(temp) : 0;
316 		cache.string[part] = save;
317 		free(temp);
318 		save_cache(&cache, string);
319 	    } else {
320 		cache.i_len = 0;
321 	    }
322 	}
323 	result = (int) cache.i_len;
324     } else
325 #endif /* USE_WIDE_CURSES */
326     {
327 	result = (int) strlen(string);
328     }
329     return result;
330 }
331 
332 /*
333  * Build an index of the wide-characters in the string, so we can easily tell
334  * which byte-offset begins a given wide-character.
335  */
336 const int *
337 dlg_index_wchars(const char *string)
338 {
339     static CACHE cache;
340     unsigned len = (unsigned) dlg_count_wchars(string);
341     unsigned inx;
342 
343     load_cache(&cache, string);
344     if (!same_cache2(&cache, string, len)) {
345 	const char *current = string;
346 
347 	cache.list[0] = 0;
348 	for (inx = 1; inx <= len; ++inx) {
349 #ifdef USE_WIDE_CURSES
350 	    if (have_locale()) {
351 		mbstate_t state;
352 		int width;
353 		memset(&state, 0, sizeof(state));
354 		width = (int) mbrlen(current, strlen(current), &state);
355 		if (width <= 0)
356 		    width = 1;	/* FIXME: what if we have a control-char? */
357 		current += width;
358 		cache.list[inx] = cache.list[inx - 1] + width;
359 	    } else
360 #endif /* USE_WIDE_CURSES */
361 	    {
362 		(void) current;
363 		cache.list[inx] = (int) inx;
364 	    }
365 	}
366 	save_cache(&cache, string);
367     }
368     return cache.list;
369 }
370 
371 /*
372  * Given the character-offset to find in the list, return the corresponding
373  * array index.
374  */
375 int
376 dlg_find_index(const int *list, int limit, int to_find)
377 {
378     int result;
379     for (result = 0; result <= limit; ++result) {
380 	if (to_find == list[result]
381 	    || result == limit
382 	    || ((result < limit) && (to_find < list[result + 1]))) {
383 	    break;
384 	}
385     }
386     return result;
387 }
388 
389 /*
390  * Build a list of the display-columns for the given string's characters.
391  */
392 const int *
393 dlg_index_columns(const char *string)
394 {
395     static CACHE cache;
396     unsigned len = (unsigned) dlg_count_wchars(string);
397     unsigned inx;
398 
399     load_cache(&cache, string);
400     if (!same_cache2(&cache, string, len)) {
401 	cache.list[0] = 0;
402 #ifdef USE_WIDE_CURSES
403 	if (have_locale()) {
404 	    size_t num_bytes = strlen(string);
405 	    const int *inx_wchars = dlg_index_wchars(string);
406 	    mbstate_t state;
407 
408 	    for (inx = 0; inx < len; ++inx) {
409 		wchar_t temp[2];
410 		size_t check;
411 		int result;
412 
413 		if (string[inx_wchars[inx]] == TAB) {
414 		    result = ((cache.list[inx] | 7) + 1) - cache.list[inx];
415 		} else {
416 		    memset(&state, 0, sizeof(state));
417 		    memset(temp, 0, sizeof(temp));
418 		    check = mbrtowc(temp,
419 				    string + inx_wchars[inx],
420 				    num_bytes - (size_t) inx_wchars[inx],
421 				    &state);
422 		    if ((int) check <= 0) {
423 			result = 1;
424 		    } else {
425 			result = wcwidth(temp[0]);
426 		    }
427 		    if (result < 0) {
428 			const wchar_t *printable;
429 			cchar_t temp2, *temp2p = &temp2;
430 			setcchar(temp2p, temp, 0, 0, 0);
431 			printable = wunctrl(temp2p);
432 			result = printable ? (int) wcslen(printable) : 1;
433 		    }
434 		}
435 		cache.list[inx + 1] = result;
436 		if (inx != 0)
437 		    cache.list[inx + 1] += cache.list[inx];
438 	    }
439 	} else
440 #endif /* USE_WIDE_CURSES */
441 	{
442 	    for (inx = 0; inx < len; ++inx) {
443 		chtype ch = UCH(string[inx]);
444 
445 		if (ch == TAB)
446 		    cache.list[inx + 1] =
447 			((cache.list[inx] | 7) + 1) - cache.list[inx];
448 		else if (isprint(ch))
449 		    cache.list[inx + 1] = 1;
450 		else {
451 		    const char *printable;
452 		    printable = unctrl(ch);
453 		    cache.list[inx + 1] = (printable
454 					   ? (int) strlen(printable)
455 					   : 1);
456 		}
457 		if (inx != 0)
458 		    cache.list[inx + 1] += cache.list[inx];
459 	    }
460 	}
461 	save_cache(&cache, string);
462     }
463     return cache.list;
464 }
465 
466 /*
467  * Returns the number of columns used for a string.  That happens to be the
468  * end-value of the cols[] array.
469  */
470 int
471 dlg_count_columns(const char *string)
472 {
473     int result = 0;
474     int limit = dlg_count_wchars(string);
475     if (limit > 0) {
476 	const int *cols = dlg_index_columns(string);
477 	result = cols[limit];
478     } else {
479 	result = (int) strlen(string);
480     }
481     return result;
482 }
483 
484 /*
485  * Given a column limit, count the number of wide characters that can fit
486  * into that limit.  The offset is used to skip over a leading character
487  * that was already written.
488  */
489 int
490 dlg_limit_columns(const char *string, int limit, int offset)
491 {
492     const int *cols = dlg_index_columns(string);
493     int result = dlg_count_wchars(string);
494 
495     while (result > 0 && (cols[result] - cols[offset]) > limit)
496 	--result;
497     return result;
498 }
499 
500 /*
501  * Updates the string and character-offset, given various editing characters
502  * or literal characters which are inserted at the character-offset.
503  */
504 bool
505 dlg_edit_string(char *string, int *chr_offset, int key, int fkey, bool force)
506 {
507     int i;
508     int len = (int) strlen(string);
509     int limit = dlg_count_wchars(string);
510     const int *indx = dlg_index_wchars(string);
511     int offset = dlg_find_index(indx, limit, *chr_offset);
512     int max_len = dlg_max_input(MAX_LEN);
513     bool edit = TRUE;
514 
515     /* transform editing characters into equivalent function-keys */
516     if (!fkey) {
517 	fkey = TRUE;		/* assume we transform */
518 	switch (key) {
519 	case 0:
520 	    break;
521 	case ESC:
522 	case TAB:
523 	    fkey = FALSE;	/* this is used for navigation */
524 	    break;
525 	default:
526 	    fkey = FALSE;	/* ...no, we did not transform */
527 	    break;
528 	}
529     }
530 
531     if (fkey) {
532 	switch (key) {
533 	case 0:		/* special case for loop entry */
534 	    edit = force;
535 	    break;
536 	case DLGK_GRID_LEFT:
537 	    if (*chr_offset && offset > 0)
538 		*chr_offset = indx[offset - 1];
539 	    break;
540 	case DLGK_GRID_RIGHT:
541 	    if (offset < limit)
542 		*chr_offset = indx[offset + 1];
543 	    break;
544 	case DLGK_BEGIN:
545 	    if (*chr_offset)
546 		*chr_offset = 0;
547 	    break;
548 	case DLGK_FINAL:
549 	    if (offset < limit)
550 		*chr_offset = indx[limit];
551 	    break;
552 	case DLGK_DELETE_LEFT:
553 	    if (offset) {
554 		int gap = indx[offset] - indx[offset - 1];
555 		*chr_offset = indx[offset - 1];
556 		if (gap > 0) {
557 		    for (i = *chr_offset;
558 			 (string[i] = string[i + gap]) != '\0';
559 			 i++) {
560 			;
561 		    }
562 		}
563 	    }
564 	    break;
565 	case DLGK_DELETE_RIGHT:
566 	    if (limit) {
567 		if (--limit == 0) {
568 		    string[*chr_offset = 0] = '\0';
569 		} else {
570 		    int gap = ((offset <= limit)
571 			       ? (indx[offset + 1] - indx[offset])
572 			       : 0);
573 		    if (gap > 0) {
574 			for (i = indx[offset];
575 			     (string[i] = string[i + gap]) != '\0';
576 			     i++) {
577 			    ;
578 			}
579 		    } else if (offset > 0) {
580 			string[indx[offset - 1]] = '\0';
581 		    }
582 		    if (*chr_offset > indx[limit])
583 			*chr_offset = indx[limit];
584 		}
585 	    }
586 	    break;
587 	case DLGK_DELETE_ALL:
588 	    string[*chr_offset = 0] = '\0';
589 	    break;
590 	case DLGK_ENTER:
591 	    edit = 0;
592 	    break;
593 #ifdef KEY_RESIZE
594 	case KEY_RESIZE:
595 	    edit = 0;
596 	    break;
597 #endif
598 	case DLGK_GRID_UP:
599 	case DLGK_GRID_DOWN:
600 	case DLGK_FIELD_NEXT:
601 	case DLGK_FIELD_PREV:
602 	    edit = 0;
603 	    break;
604 	case ERR:
605 	    edit = 0;
606 	    break;
607 	default:
608 	    beep();
609 	    break;
610 	}
611     } else {
612 	if (key == ESC || key == ERR) {
613 	    edit = 0;
614 	} else {
615 	    if (len < max_len) {
616 		for (i = ++len; i > *chr_offset; i--)
617 		    string[i] = string[i - 1];
618 		string[*chr_offset] = (char) key;
619 		*chr_offset += 1;
620 	    } else {
621 		(void) beep();
622 	    }
623 	}
624     }
625     return edit;
626 }
627 
628 static void
629 compute_edit_offset(const char *string,
630 		    int chr_offset,
631 		    int x_last,
632 		    int *p_dpy_column,
633 		    int *p_scroll_amt)
634 {
635     const int *cols = dlg_index_columns(string);
636     const int *indx = dlg_index_wchars(string);
637     int limit = dlg_count_wchars(string);
638     int offset = dlg_find_index(indx, limit, chr_offset);
639     int offset2;
640     int dpy_column;
641     int n;
642 
643     for (n = offset2 = 0; n <= offset; ++n) {
644 	if ((cols[offset] - cols[n]) < x_last
645 	    && (offset == limit || (cols[offset + 1] - cols[n]) < x_last)) {
646 	    offset2 = n;
647 	    break;
648 	}
649     }
650 
651     dpy_column = cols[offset] - cols[offset2];
652 
653     if (p_dpy_column != 0)
654 	*p_dpy_column = dpy_column;
655     if (p_scroll_amt != 0)
656 	*p_scroll_amt = offset2;
657 }
658 
659 /*
660  * Given the character-offset in the string, returns the display-offset where
661  * we will position the cursor.
662  */
663 int
664 dlg_edit_offset(char *string, int chr_offset, int x_last)
665 {
666     int result;
667 
668     compute_edit_offset(string, chr_offset, x_last, &result, 0);
669 
670     return result;
671 }
672 
673 /*
674  * Displays the string, shifted as necessary, to fit within the box and show
675  * the current character-offset.
676  */
677 void
678 dlg_show_string(WINDOW *win,
679 		const char *string,	/* string to display (may be multibyte) */
680 		int chr_offset,	/* character (not bytes) offset */
681 		chtype attr,	/* window-attributes */
682 		int y_base,	/* beginning row on screen */
683 		int x_base,	/* beginning column on screen */
684 		int x_last,	/* number of columns on screen */
685 		bool hidden,	/* if true, do not echo */
686 		bool force)	/* if true, force repaint */
687 {
688     x_last = MIN(x_last + x_base, getmaxx(win)) - x_base;
689 
690     if (hidden && !dialog_vars.insecure) {
691 	if (force) {
692 	    (void) wmove(win, y_base, x_base);
693 	    wrefresh(win);
694 	}
695     } else {
696 	const int *cols = dlg_index_columns(string);
697 	const int *indx = dlg_index_wchars(string);
698 	int limit = dlg_count_wchars(string);
699 
700 	int i, j, k;
701 	int input_x;
702 	int scrollamt;
703 
704 	compute_edit_offset(string, chr_offset, x_last, &input_x, &scrollamt);
705 
706 	(void) wattrset(win, attr);
707 	(void) wmove(win, y_base, x_base);
708 	for (i = scrollamt, k = 0; i < limit && k < x_last; ++i) {
709 	    int check = cols[i + 1] - cols[scrollamt];
710 	    if (check <= x_last) {
711 		for (j = indx[i]; j < indx[i + 1]; ++j) {
712 		    chtype ch = UCH(string[j]);
713 		    if (hidden && dialog_vars.insecure) {
714 			waddch(win, '*');
715 		    } else if (ch == TAB) {
716 			int count = cols[i + 1] - cols[i];
717 			while (--count >= 0)
718 			    waddch(win, ' ');
719 		    } else {
720 			waddch(win, ch);
721 		    }
722 		}
723 		k = check;
724 	    } else {
725 		break;
726 	    }
727 	}
728 	while (k++ < x_last)
729 	    waddch(win, ' ');
730 	(void) wmove(win, y_base, x_base + input_x);
731 	wrefresh(win);
732     }
733 }
734 
735 #ifdef NO_LEAKS
736 void
737 _dlg_inputstr_leaks(void)
738 {
739 #if USE_CACHING
740     while (cache_list != 0) {
741 	CACHE *next = cache_list->next;
742 #ifdef HAVE_TSEARCH
743 	tdelete(cache_list, &sorted_cache, compare_cache);
744 #endif
745 	if (cache_list->string != 0)
746 	    free(cache_list->string);
747 	if (cache_list->list != 0)
748 	    free(cache_list->list);
749 	free(cache_list);
750 	cache_list = next;
751     }
752 #endif /* USE_CACHING */
753 }
754 #endif /* NO_LEAKS */
755