1 /***************************************************************************
3 * Open \______ \ ____ ____ | | _\_ |__ _______ ___
4 * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
5 * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
6 * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
10 * Copyright (C) 2010 Robert Bieber
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
18 * KIND, either express or implied.
20 ****************************************************************************/
22 #ifndef GENERIC_PARSER_H
23 #define GENERIC_PARSER_H
32 #if defined(ROCKBOX) && !defined(__PCTOOL__)
33 /* Use this type and macro to convert a pointer from the
34 * skin buffer to a useable pointer */
35 typedef long skinoffset_t
;
36 #define SKINOFFSETTOPTR(base, offset) ((offset) < 0 ? NULL : ((void*)&base[offset]))
37 #define PTRTOSKINOFFSET(base, pointer) ((pointer) ? ((void*)pointer-(void*)base) : -1)
38 /* Use this macro when declaring a variable to self-document the code.
39 * type is the actual type being pointed to (i.e OFFSETTYPE(char*) foo )
41 * WARNING: Don't use the PTRTOSKINOFFSET() around a function call as it wont
44 #define OFFSETTYPE(type) skinoffset_t
46 #define SKINOFFSETTOPTR(base, offset) offset
47 #define PTRTOSKINOFFSET(base, pointer) pointer
48 #define OFFSETTYPE(type) type
51 /********************************************************************
52 ****** Data Structures *********************************************
53 *******************************************************************/
55 /* Possible types of element in a WPS file */
56 enum skin_element_type
70 MEMORY_LIMIT_EXCEEDED
,
85 /* Holds a tag parameter, either numeric or text */
86 struct skin_tag_parameter
91 DECIMAL
, /* stored in data.number as (whole*10)+part */
92 PERCENT
, /* stored in data.number as (whole*10)+part */
101 OFFSETTYPE(char*) text
;
102 OFFSETTYPE(struct skin_element
*) code
;
109 /* Defines an element of a SKIN file,
111 * This is allocated a lot, so it's optimized for size */
114 /* Link to the next element */
115 OFFSETTYPE(struct skin_element
*) next
;
116 /* Pointer to an array of children */
117 OFFSETTYPE(struct skin_element
**) children
;
118 /* Placeholder for element data
119 * TEXT and COMMENT uses it for the text string
120 * TAG, VIEWPORT, LINE, etc may use it for post parse extra storage
122 OFFSETTYPE(void*) data
;
124 /* The tag or conditional name */
125 const struct tag_info
*tag
;
127 /* Pointer to an array of parameters */
128 OFFSETTYPE(struct skin_tag_parameter
*) params
;
130 /* Number of elements in the children array */
131 short children_count
;
132 /* The line on which it's defined in the source file */
134 /* Defines what type of element it is */
135 enum skin_element_type type
;
136 /* Number of elements in the params array */
140 enum skin_cb_returnvalue
142 CALLBACK_ERROR
= -666,
143 FEATURE_NOT_AVAILABLE
,
145 /* > 0 reserved for future use */
147 typedef int (*skin_callback
)(struct skin_element
* element
, void* data
);
149 /***********************************************************************
150 ***** Functions *******************************************************
151 **********************************************************************/
153 /* Parses a WPS document and returns a list of skin_element
156 struct skin_element
* skin_parse(const char* document
,
157 skin_callback callback
, void* callback_data
);
159 struct skin_element
* skin_parse(const char* document
);
161 /* Memory management functions */
162 struct skin_element
* skin_alloc_element(void);
163 OFFSETTYPE(struct skin_element
*)* skin_alloc_children(int count
);
164 struct skin_tag_parameter
* skin_alloc_params(int count
);
165 char* skin_alloc_string(int length
);
167 void skin_free_tree(struct skin_element
* root
);
174 #endif /* GENERIC_PARSER_H */