1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
|
/* See LICENSE file for copyright and license details. */
#include "libterminput.h"
#include <alloca.h>
#include <ctype.h>
#include <errno.h>
#include <limits.h>
#include <stdint.h>
#include <string.h>
#include <unistd.h>
#if defined(__GNUC__)
# define HIDDEN __attribute__((__visibility__("hidden")))
#else
# define HIDDEN
#endif
/**
* Mark that there is no input available or pending
*
* @param INPUT_OUT:union libterminput_input *input The input output
*/
#define NOTHING(INPUT_OUT)\
do {\
union libterminput_input *input__ = (INPUT_OUT);\
input__->type = LIBTERMINPUT_NONE;\
input__->keypress.key = LIBTERMINPUT_SYMBOL;\
} while (0);
/**
* Singlar read symbol
*/
struct input {
/**
* Applied modifier keys
*/
enum libterminput_mod mods;
/**
* The read symbol; NUL-byte terminated
*/
char symbol[7];
};
/**
* Encode a Unicode codepoint in UTF-8
*
* @param codepoint The codepoint to encode
* @param buffer Output buffer for the NUL-byte terminated UTF-8 encoding of `codepoint`
*/
HIDDEN void libterminput_encode_utf8__(unsigned long long int codepoint, char buffer[7]);
/**
* Validate an UTF-8 byte sequence, up to one codepoint encoding
*
* @param s The buffer to read from
* @param size The number of bytes available in `s`
* @param len_out Output parameter for the encoding length of the
* codepoint encoded at the beginning of `s`
* @return 1 if `s` begins with a valid codepoint,
* 0 if `size` is too small to determine the validity,
* -1 if the byte sequence is illegal
*/
HIDDEN int libterminput_check_utf8_char__(const char *s, size_t size, size_t *len_out);
/**
* Decode a Unicode codepoint encoded in UTF-8
*
* @param s The buffer to read from
* @param ip Pointer to the current position in `s`, will be updated
* @return The first encode codepoint, 0 if invalid (or if 0)
*/
HIDDEN unsigned long long int libterminput_utf8_decode__(const char *s, size_t *ip);
/**
* Get input, from the terminal that, that appear after
* the start marker for a bracketed paste
*
* @param fd The file descriptor to the terminal
* @param input Output parameter for input
* @param ctx State for the terminal, parts of the state may be stored in `input`
* @return 1 normally, 0 on end of input, -1 on error
*
* @throws Any reason specified for read(3)
*/
HIDDEN int libterminput_read_bracketed_paste__(int fd, union libterminput_input *input, struct libterminput_state *ctx);
/**
* Parse mouse tracking event data
*
* @param input Output parameter for the parsed event
* @param nums The numbers assoicated with the event
*/
HIDDEN void libterminput_parse_decimal_mouse_tracking__(union libterminput_input *input, unsigned long long int nums[3]);
/**
* Parse a CSI M mouse tracking event
*
* @param input Output parameter for the parsed event
* @param ctx State for the terminal, parts of the state may be stored in `input`
* @param nums Numbers insert reported for the event (between CSI and M)
* @param nnums Number of elements in `nums`
*/
HIDDEN void libterminput_parse_csi_m_mouse_tracking__(union libterminput_input *input, struct libterminput_state *ctx,
unsigned long long int *nums, size_t nnums);
/**
* Parse a CSI T mouse tracking event
*
* @param input Output parameter for the parsed event
* @param ctx State for the terminal, parts of the state may be stored in `input`
*/
HIDDEN void libterminput_parse_csi_t_mouse_tracking__(union libterminput_input *input, struct libterminput_state *ctx);
/**
* Parse a CSI t mouse tracking event
*
* @param input Output parameter for the parsed event
* @param ctx State for the terminal, parts of the state may be stored in `input`
*/
HIDDEN void libterminput_parse_csi_small_t_mouse_tracking__(union libterminput_input *input, struct libterminput_state *ctx);
/**
* Parse a complete, atomic input sequence out side of a bracketed paste
*
* @param input Output parameter for the parsed event
* @param ctx State for the terminal, parts of the state may be stored in `input`
*/
HIDDEN void libterminput_parse_sequence__(union libterminput_input *input, struct libterminput_state *ctx);
/**
* Read a singular symbol from the terminal
*
* @param fd The file descriptor to the terminal
* @param input Output parameter for input
* @param ctx State for the terminal, parts of the state may be stored in `input`
* @return 1 normally, 0 on end of input, -1 on error
*
* @throws Any reason specified for read(3)
*/
HIDDEN int libterminput_read_symbol__(int fd, struct input *input, struct libterminput_state *ctx);
/**
* Marshal the parsed input
*
* @param how Object used to store the serialization
* @param what The input to marshal
* @return 0 on success, -1 on failure
*
* This function will fail for any reason `*how->store` fails
*/
HIDDEN int libterminput_marshal_keypress__(struct libterminput_marshaller *how, const struct libterminput_keypress *what);
/**
* Marshal the parsed input
*
* @param how Object used to store the serialization
* @param what The input to marshal
* @return 0 on success, -1 on failure
*
* This function will fail for any reason `*how->store` fails
*/
HIDDEN int libterminput_marshal_text__(struct libterminput_marshaller *how, const struct libterminput_text *what);
/**
* Marshal the parsed input
*
* @param how Object used to store the serialization
* @param what The input to marshal
* @return 0 on success, -1 on failure
*
* This function will fail for any reason `*how->store` fails
*/
HIDDEN int libterminput_marshal_mouseevent__(struct libterminput_marshaller *how, const struct libterminput_mouseevent *what);
/**
* Marshal the parsed input
*
* @param how Object used to store the serialization
* @param what The input to marshal
* @return 0 on success, -1 on failure
*
* This function will fail for any reason `*how->store` fails
*/
HIDDEN int libterminput_marshal_position__(struct libterminput_marshaller *how, const struct libterminput_position *what);
/**
* Unmarshal the parsed input
*
* @param how Object used to load the serialization
* @param what Output parameter for the unmarshalled input
* @return 0 on success, -1 on failure
*
* @throws EINVAL Invalid serialisation
*
* This function will fail for any reason `*how->load` fails
*/
HIDDEN int libterminput_unmarshal_keypress__(struct libterminput_unmarshaller *how, struct libterminput_keypress *what);
/**
* Unmarshal the parsed input
*
* @param how Object used to load the serialization
* @param what Output parameter for the unmarshalled input
* @return 0 on success, -1 on failure
*
* @throws EINVAL Invalid serialisation
*
* This function will fail for any reason `*how->load` fails
*/
HIDDEN int libterminput_unmarshal_text__(struct libterminput_unmarshaller *how, struct libterminput_text *what);
/**
* Unmarshal the parsed input
*
* @param how Object used to load the serialization
* @param what Output parameter for the unmarshalled input
* @return 0 on success, -1 on failure
*
* @throws EINVAL Invalid serialisation
*
* This function will fail for any reason `*how->load` fails
*/
HIDDEN int libterminput_unmarshal_mouseevent__(struct libterminput_unmarshaller *how, struct libterminput_mouseevent *what);
/**
* Unmarshal the parsed input
*
* @param how Object used to load the serialization
* @param what Output parameter for the unmarshalled input
* @return 0 on success, -1 on failure
*
* @throws EINVAL Invalid serialisation
*
* This function will fail for any reason `*how->load` fails
*/
HIDDEN int libterminput_unmarshal_position__(struct libterminput_unmarshaller *how, struct libterminput_position *what);
#undef HIDDEN
|
