/*
 * 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