source: keybinding.c @ 901cee9

release-1.10release-1.8release-1.9
Last change on this file since 901cee9 was 6829afc, checked in by David Benjamin <davidben@mit.edu>, 13 years ago
Define CALLER_OWN macro Replace our exising uses of G_GNUC_WARN_UNUSED_RESULT with it. The old macro is just way too long. This also more clearly specifies the intent.
  • Property mode set to 100644
File size: 3.6 KB
Line 
1#include <ctype.h>
2#include <string.h>
3#include "owl.h"
4
5/*
6 * TODO: Idea for allowing functions to be user-specified ---
7 *      Have function have a context bitmask that says where it
8 *      can be used, and have keymaps also have one, and compare
9 *      the two when setting.
10 *     
11 */
12
13static int owl_keybinding_make_keys(owl_keybinding *kb, const char *keyseq);
14
15/* sets up a new keybinding for a command */
16CALLER_OWN owl_keybinding *owl_keybinding_new(const char *keyseq, const char *command, void (*function_fn)(void), const char *desc)
17{
18  owl_keybinding *kb = g_new(owl_keybinding, 1);
19
20  owl_function_debugmsg("owl_keybinding_init: creating binding for <%s> with desc: <%s>", keyseq, desc);
21  if (command && function_fn) {
22    g_free(kb);
23    return NULL;
24  } else if (command && !function_fn) {
25    kb->type = OWL_KEYBINDING_COMMAND;
26  } else if (!command && function_fn) {
27    kb->type = OWL_KEYBINDING_FUNCTION;
28  } else {
29    kb->type = OWL_KEYBINDING_NOOP;
30  }
31
32  if (owl_keybinding_make_keys(kb, keyseq) != 0) {
33    g_free(kb);
34    return NULL;
35  }
36
37  kb->command = g_strdup(command);
38  kb->function_fn = function_fn;
39  kb->desc = g_strdup(desc);
40  return kb;
41}
42
43static int owl_keybinding_make_keys(owl_keybinding *kb, const char *keyseq)
44{
45  char **ktokens;
46  int    nktokens, i;
47
48  ktokens = g_strsplit_set(keyseq, " ", 0);
49  nktokens = g_strv_length(ktokens);
50  if (nktokens < 1 || nktokens > OWL_KEYMAP_MAXSTACK) {
51    g_strfreev(ktokens);
52    return(-1);
53  }
54  kb->keys = g_new(int, nktokens);
55  for (i=0; i<nktokens; i++) {
56    kb->keys[i] = owl_keypress_fromstring(ktokens[i]);
57    if (kb->keys[i] == ERR) {
58      g_strfreev(ktokens);
59      g_free(kb->keys);
60      return(-1);
61    }
62  }
63  kb->len = nktokens;
64  g_strfreev(ktokens);
65  return(0);
66}
67
68/* Releases data associated with a keybinding, and the kb itself */
69void owl_keybinding_delete(owl_keybinding *kb)
70{
71  g_free(kb->keys);
72  g_free(kb->desc);
73  g_free(kb->command);
74  g_free(kb);
75}
76
77/* executes a keybinding */
78void owl_keybinding_execute(const owl_keybinding *kb, int j)
79{
80  if (kb->type == OWL_KEYBINDING_COMMAND && kb->command) {
81    owl_function_command_norv(kb->command);
82  } else if (kb->type == OWL_KEYBINDING_FUNCTION && kb->function_fn) {
83    kb->function_fn();
84  }
85}
86
87CALLER_OWN char *owl_keybinding_stack_tostring(int *j, int len)
88{
89  GString *string;
90  int  i;
91
92  string = g_string_new("");
93  for (i = 0; i < len; i++) {
94    char *keypress = owl_keypress_tostring(j[i], 0);
95    g_string_append(string, keypress ? keypress : "INVALID");
96    g_free(keypress);
97    if (i < len - 1) g_string_append_c(string, ' ');
98  }
99  return g_string_free(string, false);
100}
101
102CALLER_OWN char *owl_keybinding_tostring(const owl_keybinding *kb)
103{
104  return owl_keybinding_stack_tostring(kb->keys, kb->len);
105}
106
107const char *owl_keybinding_get_desc(const owl_keybinding *kb)
108{
109  return kb->desc;
110}
111
112/* returns 0 on no match, 1 on subset match, and 2 on complete match */
113int owl_keybinding_match(const owl_keybinding *kb, const owl_keyhandler *kh)
114{
115  int i;
116  for(i = 0; i <= kh->kpstackpos && i < kb->len; i++) {
117    if(kb->keys[i] != kh->kpstack[i])
118      return 0;
119  }
120
121  /* If we've made it to this point, then they match as far as they are. */
122  if(kb->len == kh->kpstackpos + 1) {
123    /* Equal length */
124    return 2;
125  } else if(kb->len > kh->kpstackpos + 1) {
126    return 1;
127  }
128
129  return 0;
130}
131
132/* returns 1 if keypress sequence is the same */
133int owl_keybinding_equal(const owl_keybinding *kb1, const owl_keybinding *kb2)
134{
135  int i;
136
137  if(kb1->len != kb2->len) return 0;
138
139  for(i = 0; i < kb1->len; i++) {
140    if(kb1->keys[i] != kb2->keys[i])
141      return 0;
142  }
143
144  return 1;
145}
Note: See TracBrowser for help on using the repository browser.