0f428ea334
git ls-files modules/database/src/ioc|egrep '\.[hc]p*$' | xargs sed -i \ -e 's|epicsShareFunc|DBCORE_API|g' \ -e 's|epicsShareClass|DBCORE_API|g' \ -e 's|epicsShareExtern|DBCORE_API extern|g' \ -e 's|epicsShareDef\s*||g' \ -e 's|shareLib\.h|dbCoreAPI.h|g' \ -e 's|epicsShareAPI|epicsStdCall|g' \ -e '/#define\s*epicsExportSharedSymbols/d'
146 lines
4.7 KiB
C
146 lines
4.7 KiB
C
/*************************************************************************\
|
|
* Copyright (c) 2016 UChicago Argonne LLC, as Operator of Argonne
|
|
* National Laboratory.
|
|
* SPDX-License-Identifier: EPICS
|
|
* EPICS BASE is distributed subject to a Software License Agreement found
|
|
* in file LICENSE that is included with this distribution.
|
|
\*************************************************************************/
|
|
/* dbJLink.h */
|
|
|
|
#ifndef INC_dbJLink_H
|
|
#define INC_dbJLink_H
|
|
|
|
#include <stdlib.h>
|
|
#include <dbCoreAPI.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum {
|
|
jlif_stop = 0,
|
|
jlif_continue = 1
|
|
} jlif_result;
|
|
|
|
DBCORE_API extern const char *jlif_result_name[2];
|
|
|
|
typedef enum {
|
|
jlif_key_stop = jlif_stop,
|
|
jlif_key_continue = jlif_continue,
|
|
jlif_key_child_inlink, jlif_key_child_outlink, jlif_key_child_fwdlink
|
|
} jlif_key_result;
|
|
|
|
DBCORE_API extern const char *jlif_key_result_name[5];
|
|
|
|
struct link;
|
|
struct lset;
|
|
struct jlif;
|
|
|
|
typedef struct jlink {
|
|
struct jlif *pif; /* Link methods */
|
|
struct jlink *parent; /* NULL for top-level links */
|
|
int parseDepth; /* Used by parser, unused afterwards */
|
|
unsigned debug:1; /* Set to request debug output to console */
|
|
/* Link types extend or embed this structure for private storage */
|
|
} jlink;
|
|
|
|
typedef long (*jlink_map_fn)(jlink *, void *ctx);
|
|
|
|
typedef struct jlif {
|
|
/* Optional parser methods below given as NULL are equivalent to
|
|
* providing a routine that always returns jlif_stop, meaning that
|
|
* this JSON construct is not allowed at this point in the parse.
|
|
*/
|
|
|
|
const char *name;
|
|
/* Name for the link type, used in link value */
|
|
|
|
jlink* (*alloc_jlink)(short dbfType);
|
|
/* Required, allocate new link structure */
|
|
|
|
void (*free_jlink)(jlink *);
|
|
/* Required, release all resources allocated for link */
|
|
|
|
jlif_result (*parse_null)(jlink *);
|
|
/* Optional, parser saw a null value */
|
|
|
|
jlif_result (*parse_boolean)(jlink *, int val);
|
|
/* Optional, parser saw a boolean value */
|
|
|
|
jlif_result (*parse_integer)(jlink *, long long num);
|
|
/* Optional, parser saw an integer value */
|
|
|
|
jlif_result (*parse_double)(jlink *, double num);
|
|
/* Optional, parser saw a double value */
|
|
|
|
jlif_result (*parse_string)(jlink *, const char *val, size_t len);
|
|
/* Optional, parser saw a string value */
|
|
|
|
jlif_key_result (*parse_start_map)(jlink *);
|
|
/* Optional, parser saw an open-brace '{'. Return jlif_key_child_inlink,
|
|
* jlif_key_child_outlink, or jlif_key_child_fwdlink to expect a child
|
|
* link next (extra key/value pairs may follow)
|
|
*/
|
|
|
|
jlif_result (*parse_map_key)(jlink *, const char *key, size_t len);
|
|
/* Optional, parser saw a map key */
|
|
|
|
jlif_result (*parse_end_map)(jlink *);
|
|
/* Optional, parser saw a close-brace '}' */
|
|
|
|
jlif_result (*parse_start_array)(jlink *);
|
|
/* Optional, parser saw an open-bracket */
|
|
|
|
jlif_result (*parse_end_array)(jlink *);
|
|
/* Optional, parser saw a close-bracket */
|
|
|
|
void (*end_child)(jlink *parent, jlink *child);
|
|
/* Optional, called with pointer to the new child link after
|
|
* the child link has finished parsing successfully
|
|
*/
|
|
|
|
struct lset* (*get_lset)(const jlink *);
|
|
/* Required, return lset for this link instance */
|
|
|
|
void (*report)(const jlink *, int level, int indent);
|
|
/* Optional, print status information about this link instance, then
|
|
* if (level > 0) print a link identifier (at indent+2) and call
|
|
* dbJLinkReport(child, level-1, indent+4)
|
|
* for each child.
|
|
*/
|
|
|
|
long (*map_children)(jlink *, jlink_map_fn rtn, void *ctx);
|
|
/* Optional, call dbJLinkMapChildren() on all embedded links.
|
|
* Stop immediately and return status if non-zero.
|
|
*/
|
|
|
|
void (*start_child)(jlink *parent, jlink *child);
|
|
/* Optional, called with pointer to the new child link after
|
|
* parse_start_map() returned a jlif_key_child_link value and
|
|
* the child link has been allocated (but not parsed yet)
|
|
*/
|
|
|
|
/* Link types must NOT extend this table with their own routines,
|
|
* this space is reserved for extensions to the jlink interface.
|
|
*/
|
|
} jlif;
|
|
|
|
DBCORE_API long dbJLinkParse(const char *json, size_t len, short dbfType,
|
|
jlink **ppjlink);
|
|
DBCORE_API long dbJLinkInit(struct link *plink);
|
|
|
|
DBCORE_API void dbJLinkFree(jlink *);
|
|
DBCORE_API void dbJLinkReport(jlink *, int level, int indent);
|
|
|
|
DBCORE_API long dbJLinkMapChildren(struct link *,
|
|
jlink_map_fn rtn, void *ctx);
|
|
|
|
DBCORE_API long dbjlr(const char *recname, int level);
|
|
DBCORE_API long dbJLinkMapAll(char *recname, jlink_map_fn rtn, void *ctx);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* INC_dbJLink_H */
|