key-string.c - tmux - Rivoreo Source Code Repositories

 /* $OpenBSD$ */

 /*
  * Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
  * copyright notice and this permission notice appear in all copies.
  *
  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
  * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */

 #include <sys/types.h>

 #include <stdlib.h>
 #include <string.h>
 #include <wchar.h>

 #include "tmux.h"

 static key_code	key_string_search_table(const char *);
 static key_code	key_string_get_modifiers(const char **);

 static const struct {
 	const char     *string;
 	key_code	key;
 } key_string_table[] = {
 	/* Function keys. */
 	{ "F1",		KEYC_F1 },
 	{ "F2",		KEYC_F2 },
 	{ "F3",		KEYC_F3 },
 	{ "F4",		KEYC_F4 },
 	{ "F5",		KEYC_F5 },
 	{ "F6",		KEYC_F6 },
 	{ "F7",		KEYC_F7 },
 	{ "F8",		KEYC_F8 },
 	{ "F9",		KEYC_F9 },
 	{ "F10",	KEYC_F10 },
 	{ "F11",	KEYC_F11 },
 	{ "F12",	KEYC_F12 },
 	{ "IC",		KEYC_IC },
 	{ "Insert",     KEYC_IC },
 	{ "DC",		KEYC_DC },
 	{ "Delete",     KEYC_DC },
 	{ "Home",	KEYC_HOME },
 	{ "End",	KEYC_END },
 	{ "NPage",	KEYC_NPAGE },
 	{ "PageDown",	KEYC_NPAGE },
 	{ "PgDn",	KEYC_NPAGE },
 	{ "PPage",	KEYC_PPAGE },
 	{ "PageUp",	KEYC_PPAGE },
 	{ "PgUp",	KEYC_PPAGE },
 	{ "Tab",	'\011' },
 	{ "BTab",	KEYC_BTAB },
 	{ "Space",	' ' },
 	{ "BSpace",	KEYC_BSPACE },
 	{ "Enter",	'\r' },
 	{ "Escape",	'\033' },

 	/* Arrow keys. */
 	{ "Up",		KEYC_UP|KEYC_CURSOR },
 	{ "Down",	KEYC_DOWN|KEYC_CURSOR },
 	{ "Left",	KEYC_LEFT|KEYC_CURSOR },
 	{ "Right",	KEYC_RIGHT|KEYC_CURSOR },

 	/* Numeric keypad. */
 	{ "KP/", 	KEYC_KP_SLASH|KEYC_KEYPAD },
 	{ "KP*",	KEYC_KP_STAR|KEYC_KEYPAD },
 	{ "KP-",	KEYC_KP_MINUS|KEYC_KEYPAD },
 	{ "KP7",	KEYC_KP_SEVEN|KEYC_KEYPAD },
 	{ "KP8",	KEYC_KP_EIGHT|KEYC_KEYPAD },
 	{ "KP9",	KEYC_KP_NINE|KEYC_KEYPAD },
 	{ "KP+",	KEYC_KP_PLUS|KEYC_KEYPAD },
 	{ "KP4",	KEYC_KP_FOUR|KEYC_KEYPAD },
 	{ "KP5",	KEYC_KP_FIVE|KEYC_KEYPAD },
 	{ "KP6",	KEYC_KP_SIX|KEYC_KEYPAD },
 	{ "KP1",	KEYC_KP_ONE|KEYC_KEYPAD },
 	{ "KP2",	KEYC_KP_TWO|KEYC_KEYPAD },
 	{ "KP3",	KEYC_KP_THREE|KEYC_KEYPAD },
 	{ "KPEnter",	KEYC_KP_ENTER|KEYC_KEYPAD },
 	{ "KP0",	KEYC_KP_ZERO|KEYC_KEYPAD },
 	{ "KP.",	KEYC_KP_PERIOD|KEYC_KEYPAD },

 	/* Mouse keys. */
 	KEYC_MOUSE_STRING(MOUSEDOWN1, MouseDown1),
 	KEYC_MOUSE_STRING(MOUSEDOWN2, MouseDown2),
 	KEYC_MOUSE_STRING(MOUSEDOWN3, MouseDown3),
 	KEYC_MOUSE_STRING(MOUSEUP1, MouseUp1),
 	KEYC_MOUSE_STRING(MOUSEUP2, MouseUp2),
 	KEYC_MOUSE_STRING(MOUSEUP3, MouseUp3),
 	KEYC_MOUSE_STRING(MOUSEDRAG1, MouseDrag1),
 	KEYC_MOUSE_STRING(MOUSEDRAG2, MouseDrag2),
 	KEYC_MOUSE_STRING(MOUSEDRAG3, MouseDrag3),
 	KEYC_MOUSE_STRING(MOUSEDRAGEND1, MouseDragEnd1),
 	KEYC_MOUSE_STRING(MOUSEDRAGEND2, MouseDragEnd2),
 	KEYC_MOUSE_STRING(MOUSEDRAGEND3, MouseDragEnd3),
 	KEYC_MOUSE_STRING(WHEELUP, WheelUp),
 	KEYC_MOUSE_STRING(WHEELDOWN, WheelDown),
 	KEYC_MOUSE_STRING(SECONDCLICK1, SecondClick1),
 	KEYC_MOUSE_STRING(SECONDCLICK2, SecondClick2),
 	KEYC_MOUSE_STRING(SECONDCLICK3, SecondClick3),
 	KEYC_MOUSE_STRING(DOUBLECLICK1, DoubleClick1),
 	KEYC_MOUSE_STRING(DOUBLECLICK2, DoubleClick2),
 	KEYC_MOUSE_STRING(DOUBLECLICK3, DoubleClick3),
 	KEYC_MOUSE_STRING(TRIPLECLICK1, TripleClick1),
 	KEYC_MOUSE_STRING(TRIPLECLICK2, TripleClick2),
 	KEYC_MOUSE_STRING(TRIPLECLICK3, TripleClick3),
 };

 /* Find key string in table. */
 static key_code
 key_string_search_table(const char *string)
 {
 	u_int	i, user;

 	for (i = 0; i < nitems(key_string_table); i++) {
 		if (strcasecmp(string, key_string_table[i].string) == 0)
 			return (key_string_table[i].key);
 	}

 	if (sscanf(string, "User%u", &user) == 1 && user < KEYC_NUSER)
 		return (KEYC_USER + user);

 	return (KEYC_UNKNOWN);
 }

 /* Find modifiers. */
 static key_code
 key_string_get_modifiers(const char **string)
 {
 	key_code	modifiers;

 	modifiers = 0;
 	while (((*string)[0] != '\0') && (*string)[1] == '-') {
 		switch ((*string)[0]) {
 		case 'C':
 		case 'c':
 			modifiers |= KEYC_CTRL;
 			break;
 		case 'M':
 		case 'm':
 			modifiers |= KEYC_META;
 			break;
 		case 'S':
 		case 's':
 			modifiers |= KEYC_SHIFT;
 			break;
 		default:
 			*string = NULL;
 			return (0);
 		}
 		*string += 2;
 	}
 	return (modifiers);
 }

 /* Lookup a string and convert to a key value. */
 key_code
 key_string_lookup_string(const char *string)
 {
 	static const char	*other = "!#()+,-.0123456789:;<=>'\r\t";
 	key_code		 key, modifiers;
 	u_int			 u, i;
 	struct utf8_data	 ud, *udp;
 	enum utf8_state		 more;
 	utf8_char		 uc;
 	char			 m[MB_LEN_MAX + 1];
 	int			 mlen;

 	/* Is this no key or any key? */
 	if (strcasecmp(string, "None") == 0)
 		return (KEYC_NONE);
 	if (strcasecmp(string, "Any") == 0)
 		return (KEYC_ANY);

 	/* Is this a hexadecimal value? */
 	if (string[0] == '0' && string[1] == 'x') {
 	        if (sscanf(string + 2, "%x", &u) != 1)
 	                return (KEYC_UNKNOWN);
 		mlen = wctomb(m, u);
 		if (mlen <= 0 || mlen > MB_LEN_MAX)
 			return (KEYC_UNKNOWN);
 		m[mlen] = '\0';

 		udp = utf8_fromcstr(m);
 		if (udp == NULL ||
 		    udp[0].size == 0 ||
 		    udp[1].size != 0 ||
 		    utf8_from_data(&udp[0], &uc) != UTF8_DONE) {
 			free(udp);
 			return (KEYC_UNKNOWN);
 		}
 		free(udp);
 		return (uc);
 	}

 	/* Check for modifiers. */
 	modifiers = 0;
 	if (string[0] == '^' && string[1] != '\0') {
 		modifiers |= KEYC_CTRL;
 		string++;
 	}
 	modifiers |= key_string_get_modifiers(&string);
 	if (string == NULL || string[0] == '\0')
 		return (KEYC_UNKNOWN);

 	/* Is this a standard ASCII key? */
 	if (string[1] == '\0' && (u_char)string[0] <= 127) {
 		key = (u_char)string[0];
 		if (key < 32)
 			return (KEYC_UNKNOWN);
 	} else {
 		/* Try as a UTF-8 key. */
 		if ((more = utf8_open(&ud, (u_char)*string)) == UTF8_MORE) {
 			if (strlen(string) != ud.size)
 				return (KEYC_UNKNOWN);
 			for (i = 1; i < ud.size; i++)
 				more = utf8_append(&ud, (u_char)string[i]);
 			if (more != UTF8_DONE)
 				return (KEYC_UNKNOWN);
 			if (utf8_from_data(&ud, &uc) != UTF8_DONE)
 				return (KEYC_UNKNOWN);
 			return (uc|modifiers);
 		}

 		/* Otherwise look the key up in the table. */
 		key = key_string_search_table(string);
 		if (key == KEYC_UNKNOWN)
 			return (KEYC_UNKNOWN);
 	}

 	/* Convert the standard control keys. */
 	if (key < KEYC_BASE && (modifiers & KEYC_CTRL) && !strchr(other, key)) {
 		if (key >= 97 && key <= 122)
 			key -= 96;
 		else if (key >= 64 && key <= 95)
 			key -= 64;
 		else if (key == 32)
 			key = 0;
 		else if (key == 63)
 			key = 127;
 		else
 			return (KEYC_UNKNOWN);
 		modifiers &= ~KEYC_CTRL;
 	}

 	return (key|modifiers);
 }

 /* Convert a key code into string format, with prefix if necessary. */
 const char *
 key_string_lookup_key(key_code key, int with_flags)
 {
 	key_code		 saved = key;
 	static char		 out[64];
 	char			 tmp[8];
 	const char		*s;
 	u_int			 i;
 	struct utf8_data	 ud;
 	size_t			 off;

 	*out = '\0';

 	/* Literal keys are themselves. */
 	if (key & KEYC_LITERAL) {
 		snprintf(out, sizeof out, "%c", (int)(key & 0xff));
 		goto out;
 	}

 	/* Display C-@ as C-Space. */
 	if ((key & (KEYC_MASK_KEY|KEYC_MASK_MODIFIERS)) == 0)
 		key = ' '|KEYC_CTRL;

 	/* Fill in the modifiers. */
 	if (key & KEYC_CTRL)
 		strlcat(out, "C-", sizeof out);
 	if (key & KEYC_META)
 		strlcat(out, "M-", sizeof out);
 	if (key & KEYC_SHIFT)
 		strlcat(out, "S-", sizeof out);
 	key &= KEYC_MASK_KEY;

 	/* Handle no key. */
 	if (key == KEYC_NONE) {
 		s = "None";
 		goto append;
 	}

 	/* Handle special keys. */
 	if (key == KEYC_UNKNOWN) {
 		s = "Unknown";
 		goto append;
 	}
 	if (key == KEYC_ANY) {
 		s = "Any";
 		goto append;
 	}
 	if (key == KEYC_FOCUS_IN) {
 		s = "FocusIn";
 		goto append;
 	}
 	if (key == KEYC_FOCUS_OUT) {
 		s = "FocusOut";
 		goto append;
 	}
 	if (key == KEYC_PASTE_START) {
 		s = "PasteStart";
 		goto append;
 	}
 	if (key == KEYC_PASTE_END) {
 		s = "PasteEnd";
 		goto append;
 	}
 	if (key == KEYC_MOUSE) {
 		s = "Mouse";
 		goto append;
 	}
 	if (key == KEYC_DRAGGING) {
 		s = "Dragging";
 		goto append;
 	}
 	if (key == KEYC_MOUSEMOVE_PANE) {
 		s = "MouseMovePane";
 		goto append;
 	}
 	if (key == KEYC_MOUSEMOVE_STATUS) {
 		s = "MouseMoveStatus";
 		goto append;
 	}
 	if (key == KEYC_MOUSEMOVE_STATUS_LEFT) {
 		s = "MouseMoveStatusLeft";
 		goto append;
 	}
 	if (key == KEYC_MOUSEMOVE_STATUS_RIGHT) {
 		s = "MouseMoveStatusRight";
 		goto append;
 	}
 	if (key == KEYC_MOUSEMOVE_BORDER) {
 		s = "MouseMoveBorder";
 		goto append;
 	}
 	if (key >= KEYC_USER && key < KEYC_USER + KEYC_NUSER) {
 		snprintf(tmp, sizeof tmp, "User%u", (u_int)(key - KEYC_USER));
 		strlcat(out, tmp, sizeof out);
 		goto out;
 	}

 	/* Try the key against the string table. */
 	for (i = 0; i < nitems(key_string_table); i++) {
 		if (key == (key_string_table[i].key & KEYC_MASK_KEY))
 			break;
 	}
 	if (i != nitems(key_string_table)) {
 		strlcat(out, key_string_table[i].string, sizeof out);
 		goto out;
 	}

 	/* Is this a UTF-8 key? */
 	if (key > 127 && key < KEYC_BASE) {
 		utf8_to_data(key, &ud);
 		off = strlen(out);
 		memcpy(out + off, ud.data, ud.size);
 		out[off + ud.size] = '\0';
 		goto out;
 	}

 	/* Invalid keys are errors. */
 	if (key > 255) {
 		snprintf(out, sizeof out, "Invalid#%llx", saved);
 		goto out;
 	}

 	/* Check for standard or control key. */
 	if (key <= 32) {
 		if (key == 0 || key > 26)
 			xsnprintf(tmp, sizeof tmp, "C-%c", (int)(64 + key));
 		else
 			xsnprintf(tmp, sizeof tmp, "C-%c", (int)(96 + key));
 	} else if (key >= 32 && key <= 126) {
 		tmp[0] = key;
 		tmp[1] = '\0';
 	} else if (key == 127)
 		xsnprintf(tmp, sizeof tmp, "C-?");
 	else if (key >= 128)
 		xsnprintf(tmp, sizeof tmp, "\\%llo", key);

 	strlcat(out, tmp, sizeof out);
 	goto out;

 append:
 	strlcat(out, s, sizeof out);

 out:
 	if (with_flags && (saved & KEYC_MASK_FLAGS) != 0) {
 		strlcat(out, "[", sizeof out);
 		if (saved & KEYC_LITERAL)
 			strlcat(out, "L", sizeof out);
 		if (saved & KEYC_KEYPAD)
 			strlcat(out, "K", sizeof out);
 		if (saved & KEYC_CURSOR)
 			strlcat(out, "C", sizeof out);
 		if (saved & KEYC_IMPLIED_META)
 			strlcat(out, "I", sizeof out);
 		if (saved & KEYC_BUILD_MODIFIERS)
 			strlcat(out, "B", sizeof out);
 		strlcat(out, "]", sizeof out);
 	}
 	return (out);
 }
	/* $OpenBSD$ */

	/*
	* Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
	*
	* Permission to use, copy, modify, and distribute this software for any
	* purpose with or without fee is hereby granted, provided that the above
	* copyright notice and this permission notice appear in all copies.
	*
	* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
	* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
	* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
	* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
	* WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
	* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
	* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
	*/

	#include <sys/types.h>

	#include <stdlib.h>
	#include <string.h>
	#include <wchar.h>

	#include "tmux.h"

	static key_code key_string_search_table(const char *);
	static key_code key_string_get_modifiers(const char **);

	static const struct {
	const char *string;
	key_code key;
	} key_string_table[] = {
	/* Function keys. */
	{ "F1", KEYC_F1 },
	{ "F2", KEYC_F2 },
	{ "F3", KEYC_F3 },
	{ "F4", KEYC_F4 },
	{ "F5", KEYC_F5 },
	{ "F6", KEYC_F6 },
	{ "F7", KEYC_F7 },
	{ "F8", KEYC_F8 },
	{ "F9", KEYC_F9 },
	{ "F10", KEYC_F10 },
	{ "F11", KEYC_F11 },
	{ "F12", KEYC_F12 },
	{ "IC", KEYC_IC },
	{ "Insert", KEYC_IC },
	{ "DC", KEYC_DC },
	{ "Delete", KEYC_DC },
	{ "Home", KEYC_HOME },
	{ "End", KEYC_END },
	{ "NPage", KEYC_NPAGE },
	{ "PageDown", KEYC_NPAGE },
	{ "PgDn", KEYC_NPAGE },
	{ "PPage", KEYC_PPAGE },
	{ "PageUp", KEYC_PPAGE },
	{ "PgUp", KEYC_PPAGE },
	{ "Tab", '\011' },
	{ "BTab", KEYC_BTAB },
	{ "Space", ' ' },
	{ "BSpace", KEYC_BSPACE },
	{ "Enter", '\r' },
	{ "Escape", '\033' },

	/* Arrow keys. */
	{ "Up", KEYC_UP\|KEYC_CURSOR },
	{ "Down", KEYC_DOWN\|KEYC_CURSOR },
	{ "Left", KEYC_LEFT\|KEYC_CURSOR },
	{ "Right", KEYC_RIGHT\|KEYC_CURSOR },

	/* Numeric keypad. */
	{ "KP/", KEYC_KP_SLASH\|KEYC_KEYPAD },
	{ "KP*", KEYC_KP_STAR\|KEYC_KEYPAD },
	{ "KP-", KEYC_KP_MINUS\|KEYC_KEYPAD },
	{ "KP7", KEYC_KP_SEVEN\|KEYC_KEYPAD },
	{ "KP8", KEYC_KP_EIGHT\|KEYC_KEYPAD },
	{ "KP9", KEYC_KP_NINE\|KEYC_KEYPAD },
	{ "KP+", KEYC_KP_PLUS\|KEYC_KEYPAD },
	{ "KP4", KEYC_KP_FOUR\|KEYC_KEYPAD },
	{ "KP5", KEYC_KP_FIVE\|KEYC_KEYPAD },
	{ "KP6", KEYC_KP_SIX\|KEYC_KEYPAD },
	{ "KP1", KEYC_KP_ONE\|KEYC_KEYPAD },
	{ "KP2", KEYC_KP_TWO\|KEYC_KEYPAD },
	{ "KP3", KEYC_KP_THREE\|KEYC_KEYPAD },
	{ "KPEnter", KEYC_KP_ENTER\|KEYC_KEYPAD },
	{ "KP0", KEYC_KP_ZERO\|KEYC_KEYPAD },
	{ "KP.", KEYC_KP_PERIOD\|KEYC_KEYPAD },

	/* Mouse keys. */
	KEYC_MOUSE_STRING(MOUSEDOWN1, MouseDown1),
	KEYC_MOUSE_STRING(MOUSEDOWN2, MouseDown2),
	KEYC_MOUSE_STRING(MOUSEDOWN3, MouseDown3),
	KEYC_MOUSE_STRING(MOUSEUP1, MouseUp1),
	KEYC_MOUSE_STRING(MOUSEUP2, MouseUp2),
	KEYC_MOUSE_STRING(MOUSEUP3, MouseUp3),
	KEYC_MOUSE_STRING(MOUSEDRAG1, MouseDrag1),
	KEYC_MOUSE_STRING(MOUSEDRAG2, MouseDrag2),
	KEYC_MOUSE_STRING(MOUSEDRAG3, MouseDrag3),
	KEYC_MOUSE_STRING(MOUSEDRAGEND1, MouseDragEnd1),
	KEYC_MOUSE_STRING(MOUSEDRAGEND2, MouseDragEnd2),
	KEYC_MOUSE_STRING(MOUSEDRAGEND3, MouseDragEnd3),
	KEYC_MOUSE_STRING(WHEELUP, WheelUp),
	KEYC_MOUSE_STRING(WHEELDOWN, WheelDown),
	KEYC_MOUSE_STRING(SECONDCLICK1, SecondClick1),
	KEYC_MOUSE_STRING(SECONDCLICK2, SecondClick2),
	KEYC_MOUSE_STRING(SECONDCLICK3, SecondClick3),
	KEYC_MOUSE_STRING(DOUBLECLICK1, DoubleClick1),
	KEYC_MOUSE_STRING(DOUBLECLICK2, DoubleClick2),
	KEYC_MOUSE_STRING(DOUBLECLICK3, DoubleClick3),
	KEYC_MOUSE_STRING(TRIPLECLICK1, TripleClick1),
	KEYC_MOUSE_STRING(TRIPLECLICK2, TripleClick2),
	KEYC_MOUSE_STRING(TRIPLECLICK3, TripleClick3),
	};

	/* Find key string in table. */
	static key_code
	key_string_search_table(const char *string)
	{
	u_int i, user;

	for (i = 0; i < nitems(key_string_table); i++) {
	if (strcasecmp(string, key_string_table[i].string) == 0)
	return (key_string_table[i].key);
	}

	if (sscanf(string, "User%u", &user) == 1 && user < KEYC_NUSER)
	return (KEYC_USER + user);

	return (KEYC_UNKNOWN);
	}

	/* Find modifiers. */
	static key_code
	key_string_get_modifiers(const char **string)
	{
	key_code modifiers;

	modifiers = 0;
	while (((string)[0] != '\0') && (string)[1] == '-') {
	switch ((*string)[0]) {
	case 'C':
	case 'c':
	modifiers \|= KEYC_CTRL;
	break;
	case 'M':
	case 'm':
	modifiers \|= KEYC_META;
	break;
	case 'S':
	case 's':
	modifiers \|= KEYC_SHIFT;
	break;
	default:
	*string = NULL;
	return (0);
	}
	*string += 2;
	}
	return (modifiers);
	}

	/* Lookup a string and convert to a key value. */
	key_code
	key_string_lookup_string(const char *string)
	{
	static const char *other = "!#()+,-.0123456789:;<=>'\r\t";
	key_code key, modifiers;
	u_int u, i;
	struct utf8_data ud, *udp;
	enum utf8_state more;
	utf8_char uc;
	char m[MB_LEN_MAX + 1];
	int mlen;

	/* Is this no key or any key? */
	if (strcasecmp(string, "None") == 0)
	return (KEYC_NONE);
	if (strcasecmp(string, "Any") == 0)
	return (KEYC_ANY);

	/* Is this a hexadecimal value? */
	if (string[0] == '0' && string[1] == 'x') {
	if (sscanf(string + 2, "%x", &u) != 1)
	return (KEYC_UNKNOWN);
	mlen = wctomb(m, u);
	if (mlen <= 0 \|\| mlen > MB_LEN_MAX)
	return (KEYC_UNKNOWN);
	m[mlen] = '\0';

	udp = utf8_fromcstr(m);
	if (udp == NULL \|\|
	udp[0].size == 0 \|\|
	udp[1].size != 0 \|\|
	utf8_from_data(&udp[0], &uc) != UTF8_DONE) {
	free(udp);
	return (KEYC_UNKNOWN);
	}
	free(udp);
	return (uc);
	}

	/* Check for modifiers. */
	modifiers = 0;
	if (string[0] == '^' && string[1] != '\0') {
	modifiers \|= KEYC_CTRL;
	string++;
	}
	modifiers \|= key_string_get_modifiers(&string);
	if (string == NULL \|\| string[0] == '\0')
	return (KEYC_UNKNOWN);

	/* Is this a standard ASCII key? */
	if (string[1] == '\0' && (u_char)string[0] <= 127) {
	key = (u_char)string[0];
	if (key < 32)
	return (KEYC_UNKNOWN);
	} else {
	/* Try as a UTF-8 key. */
	if ((more = utf8_open(&ud, (u_char)*string)) == UTF8_MORE) {
	if (strlen(string) != ud.size)
	return (KEYC_UNKNOWN);
	for (i = 1; i < ud.size; i++)
	more = utf8_append(&ud, (u_char)string[i]);
	if (more != UTF8_DONE)
	return (KEYC_UNKNOWN);
	if (utf8_from_data(&ud, &uc) != UTF8_DONE)
	return (KEYC_UNKNOWN);
	return (uc\|modifiers);
	}

	/* Otherwise look the key up in the table. */
	key = key_string_search_table(string);
	if (key == KEYC_UNKNOWN)
	return (KEYC_UNKNOWN);
	}

	/* Convert the standard control keys. */
	if (key < KEYC_BASE && (modifiers & KEYC_CTRL) && !strchr(other, key)) {
	if (key >= 97 && key <= 122)
	key -= 96;
	else if (key >= 64 && key <= 95)
	key -= 64;
	else if (key == 32)
	key = 0;
	else if (key == 63)
	key = 127;
	else
	return (KEYC_UNKNOWN);
	modifiers &= ~KEYC_CTRL;
	}

	return (key\|modifiers);
	}

	/* Convert a key code into string format, with prefix if necessary. */
	const char *
	key_string_lookup_key(key_code key, int with_flags)
	{
	key_code saved = key;
	static char out[64];
	char tmp[8];
	const char *s;
	u_int i;
	struct utf8_data ud;
	size_t off;

	*out = '\0';

	/* Literal keys are themselves. */
	if (key & KEYC_LITERAL) {
	snprintf(out, sizeof out, "%c", (int)(key & 0xff));
	goto out;
	}

	/* Display C-@ as C-Space. */
	if ((key & (KEYC_MASK_KEY\|KEYC_MASK_MODIFIERS)) == 0)
	key = ' '\|KEYC_CTRL;

	/* Fill in the modifiers. */
	if (key & KEYC_CTRL)
	strlcat(out, "C-", sizeof out);
	if (key & KEYC_META)
	strlcat(out, "M-", sizeof out);
	if (key & KEYC_SHIFT)
	strlcat(out, "S-", sizeof out);
	key &= KEYC_MASK_KEY;

	/* Handle no key. */
	if (key == KEYC_NONE) {
	s = "None";
	goto append;
	}

	/* Handle special keys. */
	if (key == KEYC_UNKNOWN) {
	s = "Unknown";
	goto append;
	}
	if (key == KEYC_ANY) {
	s = "Any";
	goto append;
	}
	if (key == KEYC_FOCUS_IN) {
	s = "FocusIn";
	goto append;
	}
	if (key == KEYC_FOCUS_OUT) {
	s = "FocusOut";
	goto append;
	}
	if (key == KEYC_PASTE_START) {
	s = "PasteStart";
	goto append;
	}
	if (key == KEYC_PASTE_END) {
	s = "PasteEnd";
	goto append;
	}
	if (key == KEYC_MOUSE) {
	s = "Mouse";
	goto append;
	}
	if (key == KEYC_DRAGGING) {
	s = "Dragging";
	goto append;
	}
	if (key == KEYC_MOUSEMOVE_PANE) {
	s = "MouseMovePane";
	goto append;
	}
	if (key == KEYC_MOUSEMOVE_STATUS) {
	s = "MouseMoveStatus";
	goto append;
	}
	if (key == KEYC_MOUSEMOVE_STATUS_LEFT) {
	s = "MouseMoveStatusLeft";
	goto append;
	}
	if (key == KEYC_MOUSEMOVE_STATUS_RIGHT) {
	s = "MouseMoveStatusRight";
	goto append;
	}
	if (key == KEYC_MOUSEMOVE_BORDER) {
	s = "MouseMoveBorder";
	goto append;
	}
	if (key >= KEYC_USER && key < KEYC_USER + KEYC_NUSER) {
	snprintf(tmp, sizeof tmp, "User%u", (u_int)(key - KEYC_USER));
	strlcat(out, tmp, sizeof out);
	goto out;
	}

	/* Try the key against the string table. */
	for (i = 0; i < nitems(key_string_table); i++) {
	if (key == (key_string_table[i].key & KEYC_MASK_KEY))
	break;
	}
	if (i != nitems(key_string_table)) {
	strlcat(out, key_string_table[i].string, sizeof out);
	goto out;
	}

	/* Is this a UTF-8 key? */
	if (key > 127 && key < KEYC_BASE) {
	utf8_to_data(key, &ud);
	off = strlen(out);
	memcpy(out + off, ud.data, ud.size);
	out[off + ud.size] = '\0';
	goto out;
	}

	/* Invalid keys are errors. */
	if (key > 255) {
	snprintf(out, sizeof out, "Invalid#%llx", saved);
	goto out;
	}

	/* Check for standard or control key. */
	if (key <= 32) {
	if (key == 0 \|\| key > 26)
	xsnprintf(tmp, sizeof tmp, "C-%c", (int)(64 + key));
	else
	xsnprintf(tmp, sizeof tmp, "C-%c", (int)(96 + key));
	} else if (key >= 32 && key <= 126) {
	tmp[0] = key;
	tmp[1] = '\0';
	} else if (key == 127)
	xsnprintf(tmp, sizeof tmp, "C-?");
	else if (key >= 128)
	xsnprintf(tmp, sizeof tmp, "\\%llo", key);

	strlcat(out, tmp, sizeof out);
	goto out;

	append:
	strlcat(out, s, sizeof out);

	out:
	if (with_flags && (saved & KEYC_MASK_FLAGS) != 0) {
	strlcat(out, "[", sizeof out);
	if (saved & KEYC_LITERAL)
	strlcat(out, "L", sizeof out);
	if (saved & KEYC_KEYPAD)
	strlcat(out, "K", sizeof out);
	if (saved & KEYC_CURSOR)
	strlcat(out, "C", sizeof out);
	if (saved & KEYC_IMPLIED_META)
	strlcat(out, "I", sizeof out);
	if (saved & KEYC_BUILD_MODIFIERS)
	strlcat(out, "B", sizeof out);
	strlcat(out, "]", sizeof out);
	}
	return (out);
	}