sexp.h

Go to the documentation of this file.

 
#ifndef __SEXP_H__
#define __SEXP_H__
 
#include <stddef.h>
#include <stdio.h> /* for BUFSIZ only */
#include "faststack.h"
#include "cstring.h"
#include "sexp_memory.h"
#include "sexp_errors.h"
 
/* doxygen documentation groups defined here */
 
/*==============*/
/* ENUMERATIONS */
/*==============*/
 
typedef enum { 
  SEXP_VALUE,
 
  SEXP_LIST
} elt_t; 
 
typedef enum { 
  SEXP_BASIC, 
 
  SEXP_SQUOTE, 
 
  SEXP_DQUOTE,
 
  SEXP_BINARY
} atom_t;
 
/*============*/
/* STRUCTURES */
/*============*/
 
typedef struct elt {
  elt_t ty;
 
  char  *val;
 
  size_t   val_allocated;
  
  size_t   val_used;
  
  struct elt *list;
 
  struct elt *next;
 
  atom_t aty;
 
  char *bindata;
 
  size_t binlength;
} sexp_t;
 
typedef enum {
  PARSER_NORMAL,
 
  PARSER_INLINE_BINARY,
 
  PARSER_EVENTS_ONLY
} parsermode_t;
 
typedef struct parser_event_handlers {
  void (* start_sexpr)();
 
  void (* end_sexpr)();
 
  void (* characters)(const char *data, size_t len, atom_t aty);
 
  void (* binary)(const char *data, size_t len);
} parser_event_handlers_t;
 
typedef struct pcont {
  faststack_t *stack;
 
  sexp_t     *last_sexp;
 
  char        *val;
 
  size_t          val_allocated;
 
  size_t          val_used;
 
  char        *vcur;
 
  char        *lastPos;
 
  char        *sbuffer;
 
  unsigned int depth;
 
  unsigned int qdepth;
 
  unsigned int state;
 
  unsigned int esc;
 
  unsigned int squoted;
 
  sexp_errcode_t error;
 
  parsermode_t mode;
 
  /* -----------------------------------------------------------------
   * These fields below are related to dealing with INLINE_BINARY mode
   * ----------------------------------------------------------------- */
 
  size_t binexpected;
 
  size_t binread;
  
  char *bindata;
 
  parser_event_handlers_t *event_handlers;
} pcont_t;
 
typedef struct sexp_iowrap {
  pcont_t *cc;
 
  int fd;
 
  char buf[BUFSIZ];
  
  size_t cnt;
} sexp_iowrap_t;
 
/*========*/
/* GLOBAL */
/*========*/
 
extern sexp_errcode_t sexp_errno;
 
/*===========*/
/* FUNCTIONS */
/*===========*/
 
/* this is for C++ users */
#ifdef __cplusplus
extern "C" {
#endif
  sexp_errcode_t set_parser_buffer_params(size_t ss, size_t gs);
 
  sexp_t *sexp_t_allocate(void);
 
  void sexp_t_deallocate(sexp_t *s);
  
  void sexp_cleanup(void);
 
  int print_sexp(char *loc, size_t size, const sexp_t *e);
 
  int print_sexp_cstr(CSTRING **s, const sexp_t *e, size_t ss);
 
  sexp_t *new_sexp_list(sexp_t *l);
 
  sexp_t *new_sexp_binary_atom(char *data, size_t binlength);
  
  sexp_t *new_sexp_atom(const char *buf, size_t bs, atom_t aty);
    
  pcont_t *init_continuation(char *str);
 
  void destroy_continuation (pcont_t * pc);
 
  sexp_iowrap_t *init_iowrap(int fd);
 
  void destroy_iowrap(sexp_iowrap_t *iow);
 
  sexp_t *read_one_sexp(sexp_iowrap_t *iow);
  
  sexp_t *parse_sexp(char *s, size_t len);
 
  sexp_t *iparse_sexp(char *s, size_t len, pcont_t *cc);
  
  pcont_t *cparse_sexp(char *s, size_t len, pcont_t *pc);
  
  void destroy_sexp(sexp_t *s);
 
  void reset_sexp_errno();
 
  void print_pcont(pcont_t * pc, char * buf, size_t buflen);
 
/* this is for C++ users */
#ifdef __cplusplus
}
#endif
 
#include "sexp_ops.h"
 
#endif /* __SEXP_H__ */