diff options
author | Joshua Haberman <joshua@reverberate.org> | 2011-02-13 12:59:54 -0800 |
---|---|---|
committer | Joshua Haberman <joshua@reverberate.org> | 2011-02-13 12:59:54 -0800 |
commit | 6bdbb45e88e7b88b294dfb6e4cb493cbc3c8cf74 (patch) | |
tree | 0e00246fb124ebdf6a2210c816704c1d840e2138 /src/upb_glue.h | |
parent | ee84a7da167d2211066c4a663d41febdf9544438 (diff) |
Merged core/ and stream/ -> src/. The split wasn't worth it.
Diffstat (limited to 'src/upb_glue.h')
-rw-r--r-- | src/upb_glue.h | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/src/upb_glue.h b/src/upb_glue.h new file mode 100644 index 0000000..ca32436 --- /dev/null +++ b/src/upb_glue.h @@ -0,0 +1,46 @@ +/* + * upb - a minimalist implementation of protocol buffers. + * + * upb's core components like upb_decoder and upb_msg are carefully designed to + * avoid depending on each other for maximum orthogonality. In other words, + * you can use a upb_decoder to decode into *any* kind of structure; upb_msg is + * just one such structure. You can use upb_decoder without having to link in + * upb_msg. + * + * However, for convenience we provide functions here for doing common + * operations like deserializing protobuf binary format into a upb_msg. The + * compromise is that this file drags in almost all of upb as a dependency, + * which could be undesirable if you're trying to use a trimmed-down build of + * upb. + * + * Copyright (c) 2011 Joshua Haberman. See LICENSE for details. + */ + +#ifndef UPB_GLUE_H +#define UPB_GLUE_H + +#ifdef __cplusplus +extern "C" { +#endif + +// Forward-declares so we don't have to include everything in this .h file. +// Clients should use the regular, typedef'd names (eg. upb_string). +struct _upb_msg; +struct _upb_msgdef; +struct _upb_status; +struct _upb_string; +struct _upb_symtab; + +// Decodes the given string, which must be in protobuf binary format, to the +// given upb_msg with msgdef "md", storing the status of the operation in "s". +void upb_strtomsg(struct _upb_string *str, struct _upb_msg *msg, + struct _upb_msgdef *md, struct _upb_status *s); + +void upb_parsedesc(struct _upb_symtab *symtab, struct _upb_string *str, + struct _upb_status *status); + +#ifdef __cplusplus +} /* extern "C" */ +#endif + +#endif |