comparison include/urweb/urweb.h @ 1881:a5b08bdfa450

New header file scheme to support FFI code in either of C or C++ [based on suggestion by Ron de Bruijn]
author Adam Chlipala <adam@chlipala.net>
date Fri, 11 Oct 2013 17:15:28 -0400
parents 0354df1b6849
children
comparison
equal deleted inserted replaced
1880:0354df1b6849 1881:a5b08bdfa450
1 #ifndef URWEB_H 1 #ifndef URWEB_H
2 #define URWEB_H 2 #define URWEB_H
3 3
4 #include <sys/types.h>
5
6 #include "types.h" 4 #include "types.h"
7 5 #include "urweb_cpp.h"
8 int uw_really_send(int sock, const void *buf, ssize_t len);
9 int uw_really_write(int fd, const void *buf, size_t len);
10
11 extern uw_unit uw_unit_v;
12
13 void uw_global_init(void);
14 void uw_app_init(uw_app*);
15
16 void uw_client_connect(unsigned id, int pass, int sock,
17 int (*send)(int sockfd, const void *buf, size_t len),
18 int (*close)(int fd),
19 void *logger_data, uw_logger log_error);
20 void uw_prune_clients(uw_context);
21 failure_kind uw_initialize(uw_context);
22
23 uw_context uw_init(int id, void *logger_data, uw_logger log_debug);
24 void uw_close(uw_context);
25 int uw_set_app(uw_context, uw_app*);
26 uw_app *uw_get_app(uw_context);
27 void uw_set_db(uw_context, void*);
28 void *uw_get_db(uw_context);
29 void uw_free(uw_context);
30 void uw_reset(uw_context);
31 void uw_reset_keep_request(uw_context);
32 void uw_reset_keep_error_message(uw_context);
33 char *uw_get_url_prefix(uw_context);
34
35 failure_kind uw_begin_init(uw_context);
36 void uw_set_on_success(char *);
37 void uw_set_headers(uw_context, char *(*get_header)(void *, const char *), void *get_header_data);
38 void uw_set_env(uw_context, char *(*get_env)(void *, const char *), void *get_env_data);
39 failure_kind uw_begin(uw_context, char *path);
40 failure_kind uw_begin_onError(uw_context, char *msg);
41 void uw_login(uw_context);
42 void uw_commit(uw_context);
43 int uw_rollback(uw_context, int will_retry);
44
45 __attribute__((noreturn)) void uw_error(uw_context, failure_kind, const char *fmt, ...);
46 char *uw_error_message(uw_context);
47 void uw_set_error_message(uw_context, const char *fmt, ...);
48 uw_Basis_string uw_dup_and_clear_error_message(uw_context);
49 int uw_has_error(uw_context);
50 void uw_push_cleanup(uw_context, void (*func)(void *), void *arg);
51 void uw_pop_cleanup(uw_context);
52
53 void *uw_malloc(uw_context, size_t);
54 void uw_begin_region(uw_context);
55 void uw_end_region(uw_context);
56 void uw_memstats(uw_context);
57
58 int uw_send(uw_context, int sock);
59 int uw_print(uw_context, int fd);
60 int uw_output(uw_context ctx, int (*output)(void *data, const char *buf, size_t len), void *data);
61
62 int uw_set_input(uw_context, const char *name, char *value);
63 int uw_set_file_input(uw_context, char *name, uw_Basis_file);
64
65 char *uw_get_input(uw_context, int name);
66 char *uw_get_optional_input(uw_context, int name);
67 uw_Basis_file uw_get_file_input(uw_context, int name);
68 void uw_enter_subform(uw_context, int name);
69 void uw_leave_subform(uw_context);
70 int uw_enter_subforms(uw_context, int name);
71 int uw_next_entry(uw_context);
72
73 void uw_write(uw_context, const char*);
74
75 uw_Basis_source uw_Basis_new_client_source(uw_context, uw_Basis_string);
76 uw_unit uw_Basis_set_client_source(uw_context, uw_Basis_source, uw_Basis_string);
77
78 void uw_set_script_header(uw_context, const char*);
79 char *uw_Basis_get_settings(uw_context, uw_unit);
80 char *uw_get_real_script(uw_context);
81
82 uw_Basis_string uw_Basis_maybe_onload(uw_context, uw_Basis_string);
83 uw_Basis_string uw_Basis_maybe_onunload(uw_context, uw_Basis_string);
84
85 void uw_set_needs_push(uw_context, int);
86 void uw_set_needs_sig(uw_context, int);
87
88 char *uw_Basis_htmlifyInt(uw_context, uw_Basis_int);
89 char *uw_Basis_htmlifyFloat(uw_context, uw_Basis_float);
90 char *uw_Basis_htmlifyString(uw_context, uw_Basis_string);
91 char *uw_Basis_htmlifyBool(uw_context, uw_Basis_bool);
92 char *uw_Basis_htmlifyTime(uw_context, uw_Basis_time);
93 char *uw_Basis_htmlifySpecialChar(uw_context, unsigned char);
94 char *uw_Basis_htmlifySource(uw_context, uw_Basis_source);
95
96 uw_unit uw_Basis_htmlifyInt_w(uw_context, uw_Basis_int);
97 uw_unit uw_Basis_htmlifyFloat_w(uw_context, uw_Basis_float);
98 uw_unit uw_Basis_htmlifyString_w(uw_context, uw_Basis_string);
99 uw_unit uw_Basis_htmlifyBool_w(uw_context, uw_Basis_bool);
100 uw_unit uw_Basis_htmlifyTime_w(uw_context, uw_Basis_time);
101 uw_unit uw_Basis_htmlifySpecialChar_w(uw_context, unsigned char);
102 uw_unit uw_Basis_htmlifySource_w(uw_context, uw_Basis_source);
103
104 char *uw_Basis_attrifyInt(uw_context, uw_Basis_int);
105 char *uw_Basis_attrifyFloat(uw_context, uw_Basis_float);
106 char *uw_Basis_attrifyString(uw_context, uw_Basis_string);
107 char *uw_Basis_attrifyChar(uw_context, uw_Basis_char);
108 char *uw_Basis_attrifyTime(uw_context, uw_Basis_time);
109 char *uw_Basis_attrifyChannel(uw_context, uw_Basis_channel);
110 char *uw_Basis_attrifyClient(uw_context, uw_Basis_client);
111 char *uw_Basis_attrifyCss_class(uw_context, uw_Basis_css_class);
112
113 uw_unit uw_Basis_attrifyInt_w(uw_context, uw_Basis_int);
114 uw_unit uw_Basis_attrifyFloat_w(uw_context, uw_Basis_float);
115 uw_unit uw_Basis_attrifyString_w(uw_context, uw_Basis_string);
116 uw_unit uw_Basis_attrifyChar_w(uw_context, uw_Basis_char);
117
118 char *uw_Basis_urlifyInt(uw_context, uw_Basis_int);
119 char *uw_Basis_urlifyFloat(uw_context, uw_Basis_float);
120 char *uw_Basis_urlifyString(uw_context, uw_Basis_string);
121 char *uw_Basis_urlifyBool(uw_context, uw_Basis_bool);
122 char *uw_Basis_urlifyTime(uw_context, uw_Basis_time);
123 char *uw_Basis_urlifyChannel(uw_context, uw_Basis_channel);
124 char *uw_Basis_urlifySource(uw_context, uw_Basis_source);
125
126 uw_unit uw_Basis_urlifyInt_w(uw_context, uw_Basis_int);
127 uw_unit uw_Basis_urlifyFloat_w(uw_context, uw_Basis_float);
128 uw_unit uw_Basis_urlifyString_w(uw_context, uw_Basis_string);
129 uw_unit uw_Basis_urlifyBool_w(uw_context, uw_Basis_bool);
130 uw_unit uw_Basis_urlifyTime_w(uw_context, uw_Basis_time);
131 uw_unit uw_Basis_urlifyChannel_w(uw_context, uw_Basis_channel);
132 uw_unit uw_Basis_urlifySource_w(uw_context, uw_Basis_source);
133
134 uw_Basis_unit uw_Basis_unurlifyUnit(uw_context ctx, char **s);
135 uw_Basis_int uw_Basis_unurlifyInt(uw_context, char **);
136 uw_Basis_float uw_Basis_unurlifyFloat(uw_context, char **);
137 uw_Basis_string uw_Basis_unurlifyString(uw_context, char **);
138 uw_Basis_string uw_Basis_unurlifyString_fromClient(uw_context, char **);
139 uw_Basis_bool uw_Basis_unurlifyBool(uw_context, char **);
140 uw_Basis_time uw_Basis_unurlifyTime(uw_context, char **);
141
142 uw_Basis_int uw_Basis_strlen(uw_context, const char *);
143 uw_Basis_bool uw_Basis_strlenGe(uw_context, uw_Basis_string, uw_Basis_int);
144 uw_Basis_char uw_Basis_strsub(uw_context, const char *, uw_Basis_int);
145 uw_Basis_string uw_Basis_strsuffix(uw_context, const char *, uw_Basis_int);
146 uw_Basis_string uw_Basis_strcat(uw_context, const char *, const char *);
147 uw_Basis_string uw_Basis_mstrcat(uw_context ctx, ...);
148 uw_Basis_int *uw_Basis_strindex(uw_context, const char *, uw_Basis_char);
149 uw_Basis_int *uw_Basis_strsindex(uw_context, const char *, const char *needle);
150 uw_Basis_string uw_Basis_strchr(uw_context, const char *, uw_Basis_char);
151 uw_Basis_int uw_Basis_strcspn(uw_context, const char *, const char *);
152 uw_Basis_string uw_Basis_substring(uw_context, const char *, uw_Basis_int, uw_Basis_int);
153 uw_Basis_string uw_Basis_str1(uw_context, uw_Basis_char);
154
155 uw_Basis_string uw_strdup(uw_context, const char *);
156 uw_Basis_string uw_maybe_strdup(uw_context, const char *);
157 char *uw_memdup(uw_context, const char *, size_t);
158
159 uw_Basis_string uw_Basis_sqlifyInt(uw_context, uw_Basis_int);
160 uw_Basis_string uw_Basis_sqlifyFloat(uw_context, uw_Basis_float);
161 uw_Basis_string uw_Basis_sqlifyString(uw_context, uw_Basis_string);
162 uw_Basis_string uw_Basis_sqlifyChar(uw_context, uw_Basis_char);
163 uw_Basis_string uw_Basis_sqlifyBool(uw_context, uw_Basis_bool);
164 uw_Basis_string uw_Basis_sqlifyTime(uw_context, uw_Basis_time);
165 uw_Basis_string uw_Basis_sqlifyBlob(uw_context, uw_Basis_blob);
166 uw_Basis_string uw_Basis_sqlifyChannel(uw_context, uw_Basis_channel);
167 uw_Basis_string uw_Basis_sqlifyClient(uw_context, uw_Basis_client);
168
169 uw_Basis_string uw_Basis_sqlifyIntN(uw_context, uw_Basis_int*);
170 uw_Basis_string uw_Basis_sqlifyFloatN(uw_context, uw_Basis_float*);
171 uw_Basis_string uw_Basis_sqlifyStringN(uw_context, uw_Basis_string);
172 uw_Basis_string uw_Basis_sqlifyBoolN(uw_context, uw_Basis_bool*);
173 uw_Basis_string uw_Basis_sqlifyTimeN(uw_context, uw_Basis_time*);
174
175 char *uw_Basis_ensqlBool(uw_Basis_bool);
176 char *uw_Basis_ensqlTime(uw_context ctx, uw_Basis_time);
177
178 char *uw_Basis_jsifyString(uw_context, uw_Basis_string);
179 char *uw_Basis_jsifyChar(uw_context, uw_Basis_char);
180 char *uw_Basis_jsifyChannel(uw_context, uw_Basis_channel);
181 char *uw_Basis_jsifyTime(uw_context, uw_Basis_time);
182
183 uw_Basis_string uw_Basis_intToString(uw_context, uw_Basis_int);
184 uw_Basis_string uw_Basis_floatToString(uw_context, uw_Basis_float);
185 uw_Basis_string uw_Basis_charToString(uw_context, uw_Basis_char);
186 uw_Basis_string uw_Basis_boolToString(uw_context, uw_Basis_bool);
187 uw_Basis_string uw_Basis_timeToString(uw_context, uw_Basis_time);
188
189 uw_Basis_int *uw_Basis_stringToInt(uw_context, uw_Basis_string);
190 uw_Basis_float *uw_Basis_stringToFloat(uw_context, uw_Basis_string);
191 uw_Basis_char *uw_Basis_stringToChar(uw_context, uw_Basis_string);
192 uw_Basis_bool *uw_Basis_stringToBool(uw_context, uw_Basis_string);
193 uw_Basis_time *uw_Basis_stringToTime(uw_context, const char *);
194
195 uw_Basis_int uw_Basis_stringToInt_error(uw_context, uw_Basis_string);
196 uw_Basis_float uw_Basis_stringToFloat_error(uw_context, uw_Basis_string);
197 uw_Basis_char uw_Basis_stringToChar_error(uw_context, uw_Basis_string);
198 uw_Basis_bool uw_Basis_stringToBool_error(uw_context, uw_Basis_string);
199 uw_Basis_time uw_Basis_stringToTime_error(uw_context, const char *);
200 uw_Basis_blob uw_Basis_stringToBlob_error(uw_context, uw_Basis_string, size_t);
201 uw_Basis_channel uw_Basis_stringToChannel_error(uw_context, uw_Basis_string);
202 uw_Basis_client uw_Basis_stringToClient_error(uw_context, uw_Basis_string);
203
204 uw_Basis_time uw_Basis_unsqlTime(uw_context, uw_Basis_string);
205
206 uw_Basis_string uw_Basis_requestHeader(uw_context, uw_Basis_string);
207
208 void uw_write_header(uw_context, uw_Basis_string);
209 void uw_clear_headers(uw_context);
210
211 uw_Basis_string uw_Basis_get_cookie(uw_context, uw_Basis_string c);
212 uw_unit uw_Basis_set_cookie(uw_context, uw_Basis_string prefix, uw_Basis_string c, uw_Basis_string v, uw_Basis_time *expires, uw_Basis_bool secure);
213 uw_unit uw_Basis_clear_cookie(uw_context, uw_Basis_string prefix, uw_Basis_string c);
214
215 uw_Basis_channel uw_Basis_new_channel(uw_context, uw_unit);
216 uw_unit uw_Basis_send(uw_context, uw_Basis_channel, uw_Basis_string);
217
218 uw_Basis_client uw_Basis_self(uw_context);
219
220 uw_Basis_string uw_Basis_bless(uw_context, uw_Basis_string);
221 uw_Basis_string uw_Basis_blessMime(uw_context, uw_Basis_string);
222 uw_Basis_string uw_Basis_blessRequestHeader(uw_context, uw_Basis_string);
223 uw_Basis_string uw_Basis_blessResponseHeader(uw_context, uw_Basis_string);
224 uw_Basis_string uw_Basis_blessEnvVar(uw_context, uw_Basis_string);
225
226 uw_Basis_string uw_Basis_checkUrl(uw_context, uw_Basis_string);
227 uw_Basis_string uw_Basis_checkMime(uw_context, uw_Basis_string);
228 uw_Basis_string uw_Basis_checkRequestHeader(uw_context, uw_Basis_string);
229 uw_Basis_string uw_Basis_checkResponseHeader(uw_context, uw_Basis_string);
230 uw_Basis_string uw_Basis_checkEnvVar(uw_context, uw_Basis_string);
231
232 uw_Basis_string uw_Basis_getHeader(uw_context, uw_Basis_string name);
233 uw_unit uw_Basis_setHeader(uw_context, uw_Basis_string name, uw_Basis_string value);
234 uw_Basis_string uw_Basis_getenv(uw_context, uw_Basis_string name);
235
236 uw_Basis_string uw_unnull(uw_Basis_string);
237 uw_Basis_string uw_Basis_makeSigString(uw_context, uw_Basis_string);
238 int uw_streq(uw_Basis_string, uw_Basis_string);
239 uw_Basis_string uw_Basis_sigString(uw_context, uw_unit);
240
241 uw_Basis_string uw_Basis_fileName(uw_context, uw_Basis_file);
242 uw_Basis_string uw_Basis_fileMimeType(uw_context, uw_Basis_file);
243 uw_Basis_blob uw_Basis_fileData(uw_context, uw_Basis_file);
244 uw_Basis_int uw_Basis_blobSize(uw_context, uw_Basis_blob);
245 uw_Basis_blob uw_Basis_textBlob(uw_context, uw_Basis_string);
246
247 uw_Basis_string uw_Basis_postType(uw_context, uw_Basis_postBody);
248 uw_Basis_string uw_Basis_postData(uw_context, uw_Basis_postBody);
249 void uw_noPostBody(uw_context);
250 void uw_postBody(uw_context, uw_Basis_postBody);
251 int uw_hasPostBody(uw_context);
252 uw_Basis_postBody uw_getPostBody(uw_context);
253
254 void uw_mayReturnIndirectly(uw_context);
255 __attribute__((noreturn)) void uw_return_blob(uw_context, uw_Basis_blob, uw_Basis_string mimeType);
256 __attribute__((noreturn)) void uw_redirect(uw_context, uw_Basis_string url);
257
258 uw_Basis_time uw_Basis_now(uw_context);
259 uw_Basis_time uw_Basis_addSeconds(uw_context, uw_Basis_time, uw_Basis_int);
260 uw_Basis_int uw_Basis_diffInSeconds(uw_context, uw_Basis_time, uw_Basis_time);
261 uw_Basis_int uw_Basis_toSeconds(uw_context, uw_Basis_time);
262 uw_Basis_int uw_Basis_diffInMilliseconds(uw_context, uw_Basis_time, uw_Basis_time);
263 uw_Basis_int uw_Basis_toMilliseconds(uw_context, uw_Basis_time);
264 extern const uw_Basis_time uw_Basis_minTime;
265
266 void uw_register_transactional(uw_context, void *data, uw_callback commit, uw_callback rollback, uw_callback_with_retry free);
267
268 void uw_check_heap(uw_context, size_t extra);
269 char *uw_heap_front(uw_context);
270 void uw_set_heap_front(uw_context, char*);
271
272 uw_Basis_string uw_Basis_unAs(uw_context, uw_Basis_string);
273
274 extern char *uw_sqlfmtInt;
275 extern char *uw_sqlfmtFloat;
276 extern int uw_Estrings, uw_sql_type_annotations;
277 extern char *uw_sqlsuffixString;
278 extern char *uw_sqlsuffixChar;
279 extern char *uw_sqlsuffixBlob;
280 extern char *uw_sqlfmtUint4;
281
282 void *uw_get_global(uw_context, char *name);
283 void uw_set_global(uw_context, char *name, void *data, uw_callback free);
284
285 uw_Basis_bool uw_Basis_isalnum(uw_context, uw_Basis_char);
286 uw_Basis_bool uw_Basis_isalpha(uw_context, uw_Basis_char);
287 uw_Basis_bool uw_Basis_isblank(uw_context, uw_Basis_char);
288 uw_Basis_bool uw_Basis_iscntrl(uw_context, uw_Basis_char);
289 uw_Basis_bool uw_Basis_isdigit(uw_context, uw_Basis_char);
290 uw_Basis_bool uw_Basis_isgraph(uw_context, uw_Basis_char);
291 uw_Basis_bool uw_Basis_islower(uw_context, uw_Basis_char);
292 uw_Basis_bool uw_Basis_isprint(uw_context, uw_Basis_char);
293 uw_Basis_bool uw_Basis_ispunct(uw_context, uw_Basis_char);
294 uw_Basis_bool uw_Basis_isspace(uw_context, uw_Basis_char);
295 uw_Basis_bool uw_Basis_isupper(uw_context, uw_Basis_char);
296 uw_Basis_bool uw_Basis_isxdigit(uw_context, uw_Basis_char);
297 uw_Basis_char uw_Basis_tolower(uw_context, uw_Basis_char);
298 uw_Basis_char uw_Basis_toupper(uw_context, uw_Basis_char);
299
300 uw_Basis_int uw_Basis_ord(uw_context, uw_Basis_char);
301 uw_Basis_char uw_Basis_chr(uw_context, uw_Basis_int);
302
303 uw_Basis_string uw_Basis_currentUrl(uw_context);
304 void uw_set_currentUrl(uw_context, char *);
305
306 extern size_t uw_messages_max, uw_clients_max, uw_headers_max, uw_page_max, uw_heap_max, uw_script_max;
307 extern size_t uw_inputs_max, uw_cleanup_max, uw_subinputs_max, uw_deltas_max, uw_transactionals_max, uw_globals_max;
308
309 extern size_t uw_database_max;
310
311 extern int uw_time;
312
313 void uw_set_deadline(uw_context, int);
314 void uw_check_deadline(uw_context);
315
316 uw_Basis_unit uw_Basis_debug(uw_context, uw_Basis_string);
317 uw_Basis_int uw_Basis_naughtyDebug(uw_context, uw_Basis_string);
318
319 void uw_set_client_data(uw_context, void *);
320
321 uw_Basis_int uw_Basis_rand(uw_context);
322
323 extern int uw_time_max, uw_supports_direct_status, uw_min_heap;
324
325 failure_kind uw_runCallback(uw_context, void (*callback)(uw_context));
326
327 uw_Basis_string uw_Basis_timef(uw_context, const char *fmt, uw_Basis_time);
328 uw_Basis_time uw_Basis_stringToTimef(uw_context, const char *fmt, uw_Basis_string);
329 uw_Basis_time uw_Basis_stringToTimef_error(uw_context, const char *fmt, uw_Basis_string);
330
331 uw_Basis_string uw_Basis_crypt(uw_context, uw_Basis_string key, uw_Basis_string salt);
332
333 uw_Basis_bool uw_Basis_eq_time(uw_context, uw_Basis_time, uw_Basis_time);
334 uw_Basis_bool uw_Basis_lt_time(uw_context, uw_Basis_time, uw_Basis_time);
335 uw_Basis_bool uw_Basis_le_time(uw_context, uw_Basis_time, uw_Basis_time);
336
337 void uw_buffer_init(size_t max, uw_buffer *, size_t initial);
338 void uw_buffer_free(uw_buffer *);
339 void uw_buffer_reset(uw_buffer *);
340 int uw_buffer_check(uw_buffer *, size_t extra);
341 size_t uw_buffer_used(uw_buffer *);
342 size_t uw_buffer_avail(uw_buffer *);
343 int uw_buffer_append(uw_buffer *, const char *, size_t);
344
345 void uw_setQueryString(uw_context, uw_Basis_string);
346 uw_Basis_string uw_queryString(uw_context);
347
348 uw_Basis_time *uw_Basis_readUtc(uw_context, uw_Basis_string);
349
350 void uw_isPost(uw_context);
351 uw_Basis_bool uw_Basis_currentUrlHasPost(uw_context);
352 uw_Basis_bool uw_Basis_currentUrlHasQueryString(uw_context);
353
354 uw_Basis_string uw_Basis_fresh(uw_context);
355
356 uw_Basis_float uw_Basis_floatFromInt(uw_context, uw_Basis_int);
357 uw_Basis_int uw_Basis_ceil(uw_context, uw_Basis_float);
358 uw_Basis_int uw_Basis_trunc(uw_context, uw_Basis_float);
359 uw_Basis_int uw_Basis_round(uw_context, uw_Basis_float);
360
361 uw_Basis_string uw_Basis_atom(uw_context, uw_Basis_string);
362 uw_Basis_string uw_Basis_css_url(uw_context, uw_Basis_string);
363 uw_Basis_string uw_Basis_property(uw_context, uw_Basis_string);
364
365 void uw_begin_initializing(uw_context);
366 void uw_end_initializing(uw_context);
367
368 uw_Basis_string uw_Basis_fieldName(uw_context, uw_Basis_postField);
369 uw_Basis_string uw_Basis_fieldValue(uw_context, uw_Basis_postField);
370 uw_Basis_string uw_Basis_remainingFields(uw_context, uw_Basis_postField);
371 uw_Basis_postField *uw_Basis_firstFormField(uw_context, uw_Basis_string);
372 6
373 #endif 7 #endif