JVal.h

Go to the documentation of this file.

/*
 *     ____             _________                __                _     
 *    / __ \___  ____ _/ /_  __(_)___ ___  ___  / /   ____  ____ _(_)____
 *   / /_/ / _ \/ __ `/ / / / / / __ `__ \/ _ \/ /   / __ \/ __ `/ / ___/
 *  / _, _/  __/ /_/ / / / / / / / / / / /  __/ /___/ /_/ / /_/ / / /__  
 * /_/ |_|\___/\__,_/_/ /_/ /_/_/ /_/ /_/\___/_____/\____/\__, /_/\___/  
 *                                                       /____/          
 *
 *                  Barracuda Application Server
 *
 ****************************************************************************
 *                            HEADER
 *
 *   $Id: JVal.h 5978 2026-09-11 16:13:48Z wini $
 *
 *   COPYRIGHT:  Real Time Logic LLC, 2006-2026
 *
 *   This software is copyrighted by and is the sole property of Real
 *   Time Logic LLC.  All rights, title, ownership, or other interests in
 *   the software remain the property of Real Time Logic LLC.  This
 *   software may only be used in accordance with the terms and
 *   conditions stipulated in the corresponding license agreement under
 *   which the software has been supplied.  Any unauthorized use,
 *   duplication, transmission, distribution, or disclosure of this
 *   software is expressly forbidden.
 *                                                                        
 *   This Copyright notice may not be removed or modified without prior
 *   written consent of Real Time Logic LLC.
 *                                                                         
 *   Real Time Logic LLC. reserves the right to modify this software
 *   without notice.
 *
 *               http://www.realtimelogic.com
 ****************************************************************************
 *
 */
 
#ifndef __JVal_h
#define __JVal_h
 
#include <JParser.h>
#include <stdarg.h>
 
struct JVal
{
#ifdef __cplusplus
      JVType getType();
 
      JVal* vget(JErr* err,const char** fmt, va_list* argList);
 
      JVal* get(JErr* err, const char* fmt, ...);
 
      S32 getInt(JErr* e);
 
      void setInt(JErr* e,S32 v);
 
      S64 getLong(JErr* e);
 
      void setLong(JErr* e,S64 v);
 
      double getDouble(JErr* e);
 
      void setDouble(JErr* e,double v);
 
      BaBool getBoolean(JErr* e);
 
      void setBoolean(JErr* e,BaBool v);
 
      void setNull(JErr* e);
 
      const char* getString(JErr* e);
 
      size_t getStringLen();
 
      void setString(JErr* e, char* v);
 
      char* manageString(JErr* e);
 
      const char* getName();
 
      size_t getNameLen();
 
      char* manageName();
 
      JVal* getNextElem();
 
      JVal* getObject(JErr* e);
 
      JVal* getArray(JErr* e);
 
      JVal* getJ(JErr* e);
 
      JVal* manageJ(JErr* e);
 
      S32 getLength(JErr* e);
 
      bool isObjectMember();
 
      int unlink(JVal* child);
 
      int addMember(JErr* e, const char* memberName,
                    JVal* child, AllocatorIntf* dAlloc);
 
      int add(JErr* e, JVal* child);
 
      void terminate(AllocatorIntf* vAlloc, AllocatorIntf* dAlloc);
#endif
      union
      {
            struct JVal* firstChild; /* If object or array */
            U8* s; /* If string */
#ifndef NO_DOUBLE
            double f; /* If floating point */
#endif
            S32 d; /* If integer */
            S64 l; /* If long integer */
            BaBool b; /* If true or false */
      } v;
 
      char* memberName;
      struct JVal* next;
      size_t stringLen;
      size_t memberNameLen;
      JVType type;
};
 
typedef struct JVal JVal;
 
#ifdef __cplusplus
extern "C" {
#endif
#define JVal_getType(o) (o)->type
BA_API JVal* JVal_vget(JVal* o,JErr* err,const char** fmt, va_list* argList);
BA_API JVal* JVal_get(JVal* o, JErr* err, const char* fmt, ...);
BA_API S32 JVal_getInt(JVal* o, JErr* e);
BA_API S64 JVal_getLong(JVal* o, JErr* e);
BA_API double JVal_getDouble(JVal* o, JErr* e);
BA_API BaBool JVal_getBoolean(JVal* o, JErr* e);
BA_API const char* JVal_getString(JVal* o, JErr* e);
#define JVal_getStringLen(o) (o)->stringLen
BA_API char* JVal_manageString(JVal* o, JErr* e);
BA_API const char* JVal_getName(JVal* o);
#define JVal_getNameLen(o) (o)->memberNameLen
BA_API char* JVal_manageName(JVal* o);
#define JVal_getNextElem(o) (o)->next
BA_API JVal* JVal_getObject(JVal* o, JErr* e);
BA_API JVal* JVal_getArray(JVal* o, JErr* e);
BA_API JVal* JVal_getJ(JVal* o, JErr* e);
BA_API JVal* JVal_manageJ(JVal* o, JErr* e);
BA_API S32 JVal_getLength(struct JVal* o, JErr* e);
#define JVal_isObjectMember(o) ((o)->memberName != 0) 
BA_API int JVal_unlink(JVal* o, JVal* child);
BA_API int JVal_addMember(JVal* o, JErr* e, const char* memberName,
                          JVal* child, AllocatorIntf* dAlloc);
BA_API int JVal_add(JVal* o, JErr* e, JVal* child);
BA_API void JVal_terminate(JVal* o, AllocatorIntf* vAlloc,
                           AllocatorIntf* dAlloc);
#define JVal_setInt(o, e, v) JVal_setX(o, e, JVType_Int, &v)
#define JVal_setLong(o, e, v) JVal_setX(o, e, JVType_Long, &v)
#define JVal_setDouble(o, e, v) JVal_setX(o, e, JVType_Double, &v)
#define JVal_setBoolean(o, e, v) JVal_setX(o, e, JVType_Boolean, &v)
#define JVal_setNull(o, e) JVal_setX(o, e, JVType_Null, 0)
#define JVal_setString(o, e, v) JVal_setX(o, e, JVType_String, v)
BA_API void JVal_setX(JVal* o, JErr* e, JVType t, void* v);
#ifdef __cplusplus
}
inline JVType JVal::getType(){
   return JVal_getType(this); }
inline JVal* JVal::vget(JErr* err,const char** fmt, va_list* argList){
   return JVal_vget(this,err,fmt, argList); }
inline JVal* JVal::get( JErr* err, const char* fmt, ...){
   JVal* retv; va_list argList;
   va_start(argList, fmt); 
   retv = JVal_vget(this,err,&fmt,&argList);
   va_end(argList);
   return retv; 
}
inline S32 JVal::getInt(JErr* e){
   return JVal_getInt(this, e); }
inline S64 JVal::getLong(JErr* e){
   return JVal_getLong(this, e); }
inline double JVal::getDouble(JErr* e){
   return JVal_getDouble(this, e); }
inline BaBool JVal::getBoolean(JErr* e){
   return JVal_getBoolean(this, e); }
inline const char* JVal::getString(JErr* e){
   return JVal_getString(this, e); }
inline size_t JVal::getStringLen(){
   return JVal_getStringLen(this); }
inline char* JVal::manageString(JErr* e){
   return JVal_manageString(this, e); }
inline const char* JVal::getName(){
   return JVal_getName(this); }
inline size_t JVal::getNameLen(){
   return JVal_getNameLen(this); }
inline char* JVal::manageName(){
   return JVal_manageName(this); }
inline JVal* JVal::getNextElem(){
   return JVal_getNextElem(this); }
inline JVal* JVal::getObject(JErr* e){
   return JVal_getObject(this, e); }
inline JVal* JVal::getArray(JErr* e){
   return JVal_getArray(this, e); }
inline JVal* JVal::getJ(JErr* e){
   return JVal_getJ(this, e); }
inline JVal* JVal::manageJ(JErr* e){
   return JVal_manageJ(this, e); }
inline S32 JVal::getLength(JErr* e){
   return JVal_getLength(this, e); }
 
inline void JVal::setInt(JErr* e,S32 val) {
  JVal_setInt(this, e, val); }
inline void JVal::setLong(JErr* e,S64 val) {
  JVal_setLong(this, e, val); }
inline void JVal::setDouble(JErr* e,double val) {
  JVal_setDouble(this, e, val); }
inline void JVal::setBoolean(JErr* e,BaBool val) {
  JVal_setBoolean(this, e, val); }
inline void JVal::setNull(JErr* e) {
  JVal_setNull(this, e); }
inline void JVal::setString(JErr* e, char* val) {
  JVal_setString(this, e, val); }
inline bool JVal::isObjectMember(){
   return JVal_isObjectMember(this) ? true : false; }
inline int JVal::unlink(JVal* child){
   return JVal_unlink(this, child); }
inline int JVal::addMember(JErr* e, const char* name,
                           JVal* child, AllocatorIntf* dAlloc) {
   return JVal_addMember(this, e, name, child, dAlloc); }
inline int JVal::add(JErr* e, JVal* child) {
   return JVal_add(this, e, child); }
inline void JVal::terminate(AllocatorIntf* vAlloc, AllocatorIntf* dAlloc){
   JVal_terminate(this, vAlloc, dAlloc); }
#endif
 /* end of JSONRef */
 
typedef enum
{
   JParserValFactStat_OK=0,
   JParserValFactStat_DMemErr,
   JParserValFactStat_VMemErr,
   JParserValFactStat_MaxNodes
} JParserValFactStat;
 
#ifdef __cplusplus
typedef struct JParserValFact : public JParserIntf
{
      JParserValFact(AllocatorIntf* vAlloc, AllocatorIntf* dAlloc);
 
      ~JParserValFact();
 
      JVal* getFirstVal();
 
      JVal* manageFirstVal();
 
      void termFirstVal();
#else
typedef struct JParserValFact
{
      JParserIntf super; /*Inherits from JParserIntf*/
#endif
      AllocatorIntf* dAlloc;
      AllocatorIntf* vAlloc;
      JVal** vStack;
      int vStackSize;
      U32 nodeCounter;
      U32 maxNodes;
      JParserValFactStat status;
} JParserValFact;
#ifdef __cplusplus
extern "C" {
#endif
BA_API void JParserValFact_constructor(
   JParserValFact* o, AllocatorIntf* vAlloc, AllocatorIntf* dAlloc);
#define JParserValFact_getFirstVal(o) \
   ((o)->vStack && *(o)->vStack ? *(o)->vStack : 0)
BA_API JVal* JParserValFact_manageFirstVal(JParserValFact* o);
BA_API void JParserValFact_termFirstVal(JParserValFact* o);
BA_API void JParserValFact_destructor(JParserValFact* o);
#ifdef __cplusplus
}
inline JParserValFact::JParserValFact(
   AllocatorIntf* vAlloc, AllocatorIntf* dAlloc){
   JParserValFact_constructor(this, vAlloc, dAlloc);}
inline JVal* JParserValFact::getFirstVal() {
   return JParserValFact_getFirstVal(this); }
inline JVal* JParserValFact::manageFirstVal() {
   return JParserValFact_manageFirstVal(this); }
inline void JParserValFact::termFirstVal() {
    JParserValFact_termFirstVal(this); }
inline JParserValFact::~JParserValFact() {
    JParserValFact_destructor(this); }
#endif
 /* end of JSONCB */
 
typedef struct JValFact
{
#ifdef __cplusplus
      JValFact(AllocatorIntf* vAlloc, AllocatorIntf* dAlloc);
      
      JVal* mkString(const char* v);
 
      JVal* mkDouble(double v);
 
      JVal* mkInt(S32 v);
 
      JVal* mkLong(S64 v);
 
      JVal* mkBoolean(bool v);
 
      JVal* mkNull();
 
      JVal* mkObject();
 
      JVal* mkArray();
#endif
      AllocatorIntf* dAlloc;
      AllocatorIntf* vAlloc;
} JValFact;
#ifdef __cplusplus
extern "C" {
#endif
#define JValFact_mkString(o, v) JValFact_mkVal(o, JVType_String, v)
#define JValFact_mkDouble(o, v) JValFact_mkVal(o, JVType_Double, &v)
#define JValFact_mkInt(o, v) JValFact_mkVal(o, JVType_Int, &v)
#define JValFact_mkLong(o, v) JValFact_mkVal(o, JVType_Long, &v)
#define JValFact_mkBoolean(o, v) JValFact_mkVal(o, JVType_Boolean, &v)
#define JValFact_mkNull(o) JValFact_mkVal(o, JVType_Null, 0)
#define JValFact_mkObject(o) JValFact_mkVal(o, JVType_Object, 0)
#define JValFact_mkArray(o) JValFact_mkVal(o, JVType_Array, 0)
BA_API void JValFact_constructor(
   JValFact* o, AllocatorIntf* vAlloc, AllocatorIntf* dAlloc);
BA_API JVal* JValFact_mkVal(JValFact* o, JVType t, const void* uv);
#ifdef __cplusplus
}
inline JValFact::JValFact(AllocatorIntf* vAlloc, AllocatorIntf* dAlloc) {
   JValFact_constructor(this,vAlloc, dAlloc); }
inline JVal* JValFact::mkString(const char* v) {
   return JValFact_mkString(this, v); }
inline JVal* JValFact::mkDouble(double v) {
   return JValFact_mkDouble(this, v); }
inline JVal* JValFact::mkInt(S32 v) {
   return JValFact_mkInt(this, v); }
inline JVal* JValFact::mkLong(S64 v) {
   return JValFact_mkLong(this, v); }
inline JVal* JValFact::mkBoolean(bool v) {
   BaBool b = v ? TRUE : FALSE;
   return JValFact_mkBoolean(this, b); }
inline JVal* JValFact::mkNull() {
   return JValFact_mkNull(this); }
inline JVal* JValFact::mkObject() {
   return JValFact_mkObject(this); }
inline JVal* JValFact::mkArray() {
   return JValFact_mkArray(this); }
#endif
 /* end of JSONRef */
 
#endif