From a75a305c77acd6800b81204f387f7a437a62fe6b Mon Sep 17 00:00:00 2001 From: Joshua Haberman Date: Fri, 25 Feb 2011 18:31:22 -0800 Subject: Implemented upb_stringsink, upb_msgtotext, and exposed the latter to Lua. --- src/upb_glue.h | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) (limited to 'src/upb_glue.h') diff --git a/src/upb_glue.h b/src/upb_glue.h index ca32436..afb7b59 100644 --- a/src/upb_glue.h +++ b/src/upb_glue.h @@ -4,8 +4,8 @@ * 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. + * just one such structure. A upb_msg can be serialized/deserialized into any + * format, protobuf binary format is just one such format. * * However, for convenience we provide functions here for doing common * operations like deserializing protobuf binary format into a upb_msg. The @@ -13,12 +13,20 @@ * which could be undesirable if you're trying to use a trimmed-down build of * upb. * + * While these routines are convenient, they do not reuse any encoding/decoding + * state. For example, if a decoder is JIT-based, it will be re-JITted every + * time these functions are called. For this reason, if you are parsing lots + * of data and efficiency is an issue, these may not be the best functions to + * use (though they are useful for prototyping, before optimizing). + * * Copyright (c) 2011 Joshua Haberman. See LICENSE for details. */ #ifndef UPB_GLUE_H #define UPB_GLUE_H +#include + #ifdef __cplusplus extern "C" { #endif @@ -36,6 +44,9 @@ struct _upb_symtab; void upb_strtomsg(struct _upb_string *str, struct _upb_msg *msg, struct _upb_msgdef *md, struct _upb_status *s); +void upb_msgtotext(struct _upb_string *str, struct _upb_msg *msg, + struct _upb_msgdef *md, bool single_line); + void upb_parsedesc(struct _upb_symtab *symtab, struct _upb_string *str, struct _upb_status *status); -- cgit v1.2.3