Ignore:
Timestamp:
06/02/06 09:03:14 (7 years ago)
Author:
xi
Message:

Add token constructors and destructors.

Add YAML_DECLARE to the API declarations (Thanks to Peter Murphy for suggestion).

File:
1 edited

Legend:

Unmodified
Added
Removed

  • libyaml/trunk/include/yaml/yaml.h

    r182 r183  
    2121 
    2222/** 
     23 * @defgroup Export Definitions 
     24 * @{ 
     25 */ 
     26 
     27/** The public API declaration. */ 
     28 
     29#ifdef WIN32 
     30#   if defined(YAML_DECLARE_STATIC) 
     31#       define  YAML_DECLARE(type)  type 
     32#   elif defined(YAML_DECLARE_EXPORT) 
     33#       define  YAML_DECLARE(type)  __declspec(dllexport) type 
     34#   else 
     35#       define  YAML_DECLARE(type)  __declspec(dllimport) type 
     36#   endif 
     37#else 
     38#   define  YAML_DECLARE(type)  type 
     39#endif 
     40 
     41/** @} */ 
     42 
     43/** 
    2344 * @defgroup version Version Information 
    2445 * @{ 
    … …  
    3354 */ 
    3455 
    35 const char * 
     56YAML_DECLARE(const char *) 
    3657yaml_get_version_string(void); 
    3758 
    … …  
    4465 */ 
    4566 
    46 void 
     67YAML_DECLARE(void) 
    4768yaml_get_version(int *major, int *minor, int *patch); 
    4869 
    … …  
    5475 */ 
    5576 
    56 /** The character type. */ 
     77/** The character type (UTF-8 octet). */ 
    5778typedef unsigned char yaml_char_t; 
    5879 
    … …  
    79100} yaml_error_type_t; 
    80101 
     102/** The pointer position. */ 
     103typedef struct { 
     104    /** The position index. */ 
     105    size_t index; 
     106 
     107    /** The position line. */ 
     108    size_t line; 
     109 
     110    /** The position column. */ 
     111    size_t column; 
     112} yaml_mark_t; 
     113 
    81114/** @} */ 
    82115 
    83 /* 
    84  
     116/** 
     117 * @defgroup Node Styles 
     118 * @{ 
     119 */ 
     120 
     121/** Scalar styles. */ 
    85122typedef enum { 
    86123    YAML_ANY_SCALAR_STYLE, 
     124 
    87125    YAML_PLAIN_SCALAR_STYLE, 
     126 
    88127    YAML_SINGLE_QUOTED_SCALAR_STYLE, 
    89128    YAML_DOUBLE_QUOTED_SCALAR_STYLE, 
     129 
    90130    YAML_LITERAL_SCALAR_STYLE, 
    91131    YAML_FOLDED_SCALAR_STYLE 
    92132} yaml_scalar_style_t; 
    93133 
     134 
     135/** Sequence styles. */ 
    94136typedef enum { 
    95137    YAML_ANY_SEQUENCE_STYLE, 
     138 
    96139    YAML_BLOCK_SEQUENCE_STYLE, 
    97140    YAML_FLOW_SEQUENCE_STYLE 
    98141} yaml_sequence_style_t; 
    99142 
     143/** Mapping styles. */ 
    100144typedef enum { 
    101145    YAML_ANY_MAPPING_STYLE, 
     146 
    102147    YAML_BLOCK_MAPPING_STYLE, 
    103148    YAML_FLOW_MAPPING_STYLE 
    104149} yaml_mapping_style_t; 
    105150 
     151/** @} */ 
     152 
     153/** 
     154 * @defgroup Tokens 
     155 * @{ 
     156 */ 
     157 
     158/** Token types. */ 
    106159typedef enum { 
    107160    YAML_STREAM_START_TOKEN, 
    … …  
    133186} yaml_token_type_t; 
    134187 
     188/** The token structure. */ 
     189typedef struct { 
     190 
     191    /** The token type. */ 
     192    yaml_token_type_t type; 
     193 
     194    /** The token data. */ 
     195    union { 
     196 
     197        /** The stream encoding (for @c YAML_STREAM_START_TOKEN). */ 
     198        yaml_encoding_t encoding; 
     199 
     200        /** The anchor (for @c YAML_ALIAS_TOKEN and @c YAML_ANCHOR_TOKEN). */ 
     201        yaml_char_t *anchor; 
     202 
     203        /** The tag (for @c YAML_TAG_TOKEN). */ 
     204        struct { 
     205            /** The tag handle. */ 
     206            yaml_char_t *handle; 
     207 
     208            /** The tag suffix. */ 
     209            yaml_char_t *suffix; 
     210        } tag; 
     211 
     212        /** The scalar value (for @c YAML_SCALAR_TOKEN). */ 
     213        struct { 
     214 
     215            /** The scalar value. */ 
     216            yaml_char_t *value; 
     217 
     218            /** The length of the scalar value. */ 
     219            size_t length; 
     220 
     221            /** The scalar style. */ 
     222            yaml_scalar_style_t style; 
     223        } scalar; 
     224 
     225        /** The version directive (for @c YAML_VERSION_DIRECTIVE_TOKEN). */ 
     226        struct { 
     227            /** The major version number. */ 
     228            int major; 
     229 
     230            /** The minor version number. */ 
     231            int minor; 
     232        } version_directive; 
     233 
     234        /** The tag directive (for @c YAML_TAG_DIRECTIVE_TOKEN). */ 
     235        struct { 
     236            /** The tag handle. */ 
     237            yaml_char_t *handle; 
     238 
     239            /** The tag prefix. */ 
     240            yaml_char_t *prefix; 
     241        } tag_directive; 
     242    } data; 
     243 
     244    /** The beginning of the token. */ 
     245    yaml_mark_t start_mark; 
     246 
     247    /** The end of the token. */ 
     248    yaml_mark_t end_mark; 
     249 
     250} yaml_token_t; 
     251 
     252/** 
     253 * Create a new token without assigning any data. 
     254 * 
     255 * This function can be used for constructing indicator tokens: 
     256 * @c YAML_DOCUMENT_START, @c YAML_DOCUMENT_END, 
     257 * @c YAML_BLOCK_SEQUENCE_START_TOKEN, @c YAML_BLOCK_MAPPING_START_TOKEN, 
     258 * @c YAML_BLOCK_END_TOKEN, 
     259 * @c YAML_FLOW_SEQUENCE_START_TOKEN, @c YAML_FLOW_SEQUENCE_END_TOKEN, 
     260 * @c YAML_FLOW_MAPPING_START_TOKEN, @c YAML_FLOW_MAPPING_END_TOKEN, 
     261 * @c YAML_BLOCK_ENTRY_TOKEN, @c YAML_FLOW_ENTRY_TOKEN, 
     262 * @c YAML_KEY_TOKEN, @c YAML_VALUE_TOKEN. 
     263 * 
     264 * @param[in]   type        The token type. 
     265 * @param[in]   start_mark  The beginning of the token. 
     266 * @param[in]   end_mark    The end of the token. 
     267 * 
     268 * @returns A new token object, or @c NULL on error. 
     269 */ 
     270 
     271YAML_DECLARE(yaml_token_t *) 
     272yaml_token_new(yaml_token_type_t type, 
     273        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     274 
     275/** 
     276 * Create a new @c YAML_STREAM_START_TOKEN token with the specified encoding. 
     277 * 
     278 * @param[in]   encoding    The stream encoding. 
     279 * @param[in]   start_mark  The beginning of the token. 
     280 * @param[in]   end_mark    The end of the token. 
     281 * 
     282 * @returns A new token object, or @c NULL on error. 
     283 */ 
     284 
     285YAML_DECLARE(yaml_token_t *) 
     286yaml_stream_start_token_new(yaml_encoding_t encoding, 
     287        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     288 
     289/** 
     290 * Create a new @c YAML_STREAM_END_TOKEN token. 
     291 * 
     292 * @param[in]   start_mark  The beginning of the token. 
     293 * @param[in]   end_mark    The end of the token. 
     294 * 
     295 * @returns A new token object, or @c NULL on error. 
     296 */ 
     297 
     298YAML_DECLARE(yaml_token_t *) 
     299yaml_stream_end_token_new(yaml_mark_t start_mark, yaml_mark_t end_mark); 
     300 
     301/** 
     302 * Create a new @c YAML_VERSION_DIRECTIVE_TOKEN token with the specified 
     303 * version numbers. 
     304 * 
     305 * @param[in]   major       The major version number. 
     306 * @param[in]   minor       The minor version number. 
     307 * @param[in]   start_mark  The beginning of the token. 
     308 * @param[in]   end_mark    The end of the token. 
     309 * 
     310 * @returns A new token object, or @c NULL on error. 
     311 */ 
     312 
     313YAML_DECLARE(yaml_token_t *) 
     314yaml_version_directive_token_new(int major, int minor, 
     315        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     316 
     317/** 
     318 * Create a new @c YAML_TAG_DIRECTIVE_TOKEN token with the specified tag 
     319 * handle and prefix. 
     320 * 
     321 * Note that the @a handle and the @a prefix pointers will be freed by 
     322 * the token descructor. 
     323 * 
     324 * @param[in]   handle      The tag handle. 
     325 * @param[in]   prefix      The tag prefix. 
     326 * @param[in]   start_mark  The beginning of the token. 
     327 * @param[in]   end_mark    The end of the token. 
     328 * 
     329 * @returns A new token object, or @c NULL on error. 
     330 */ 
     331 
     332YAML_DECLARE(yaml_token_t *) 
     333yaml_tag_directive_token_new(yaml_char_t *handle, yaml_char_t *prefix, 
     334        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     335 
     336/** 
     337 * Create a new @c YAML_ALIAS_TOKEN token with the specified anchor. 
     338 * 
     339 * Note that the @a anchor pointer will be freed by the token descructor. 
     340 * 
     341 * @param[in]   anchor      The anchor. 
     342 * @param[in]   start_mark  The beginning of the token. 
     343 * @param[in]   end_mark    The end of the token. 
     344 * 
     345 * @returns A new token object, or @c NULL on error. 
     346 */ 
     347 
     348YAML_DECLARE(yaml_token_t *) 
     349yaml_alias_token_new(yaml_char_t *anchor, 
     350        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     351 
     352/** 
     353 * Create a new @c YAML_ANCHOR_TOKEN token with the specified anchor. 
     354 * 
     355 * Note that the @a anchor pointer will be freed by the token descructor. 
     356 * 
     357 * @param[in]   anchor      The anchor. 
     358 * @param[in]   start_mark  The beginning of the token. 
     359 * @param[in]   end_mark    The end of the token. 
     360 * 
     361 * @returns A new token object, or @c NULL on error. 
     362 */ 
     363 
     364YAML_DECLARE(yaml_token_t *) 
     365yaml_anchor_token_new(yaml_char_t *anchor, 
     366        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     367 
     368/** 
     369 * Create a new @c YAML_TAG_TOKEN token with the specified tag handle and 
     370 * suffix. 
     371 * 
     372 * Note that the @a handle and the @a suffix pointers will be freed by 
     373 * the token descructor. 
     374 * 
     375 * @param[in]   handle      The tag handle. 
     376 * @param[in]   suffix      The tag suffix. 
     377 * @param[in]   start_mark  The beginning of the token. 
     378 * @param[in]   end_mark    The end of the token. 
     379 * 
     380 * @returns A new token object, or @c NULL on error. 
     381 */ 
     382 
     383YAML_DECLARE(yaml_token_t *) 
     384yaml_tag_token_new(yaml_char_t *handle, yaml_char_t *suffix, 
     385        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     386 
     387/** 
     388 * Create a new @c YAML_SCALAR_TOKEN token with the specified scalar value, 
     389 * length, and style. 
     390 * 
     391 * Note that the scalar value may contain the @c NUL character, therefore 
     392 * the value length is also required.  The scalar value always ends with 
     393 * @c NUL. 
     394 * 
     395 * Note that the @a value pointer will be freed by the token descructor. 
     396 * 
     397 * @param[in]   value       The scalar value. 
     398 * @param[in]   length      The value length. 
     399 * @param[in]   style       The scalar style. 
     400 * @param[in]   start_mark  The beginning of the token. 
     401 * @param[in]   end_mark    The end of the token. 
     402 * 
     403 * @returns A new token object, or @c NULL on error. 
     404 */ 
     405 
     406YAML_DECLARE(yaml_token_t *) 
     407yaml_scalar_token_new(yaml_char_t *value, size_t length, 
     408        yaml_scalar_style_t style, 
     409        yaml_mark_t start_mark, yaml_mark_t end_mark); 
     410 
     411/** 
     412 * Destroy a token object. 
     413 * 
     414 * @param[in]   token   A token object. 
     415 */ 
     416 
     417YAML_DECLARE(void) 
     418yaml_token_delete(yaml_token_t *token); 
     419 
     420/** @} */ 
     421 
     422/* 
     423 
    135424typedef enum { 
    136425    YAML_STREAM_START_EVENT, 
    … …  
    149438    YAML_MAPPING_END_EVENT 
    150439} yaml_event_type_t; 
    151  
    152 typedef struct { 
    153     size_t offset; 
    154     size_t index; 
    155     size_t line; 
    156     size_t column; 
    157 } yaml_mark_t; 
    158  
    159 typedef struct { 
    160     yaml_error_type_t type; 
    161     char *context; 
    162     yaml_mark_t context_mark; 
    163     char *problem; 
    164     yaml_mark_t problem_mark; 
    165 } yaml_error_t; 
    166  
    167 typedef struct { 
    168     yaml_token_type_t type; 
    169     union { 
    170         yaml_encoding_t encoding; 
    171         char *anchor; 
    172         char *tag; 
    173         struct { 
    174             char *value; 
    175             size_t length; 
    176             yaml_scalar_style_t style; 
    177         } scalar; 
    178         struct { 
    179             int major; 
    180             int minor; 
    181         } version; 
    182         struct { 
    183           char *handle; 
    184           char *prefix; 
    185         } tag_pair; 
    186     } data; 
    187     yaml_mark_t start_mark; 
    188     yaml_mark_t end_mark; 
    189 } yaml_token_t; 
    190440 
    191441typedef struct { 
    … …  
    273523 
    274524typedef struct { 
     525    /** The string start pointer. */ 
    275526    unsigned char *start; 
     527 
     528    /** The string end pointer. */ 
    276529    unsigned char *end; 
     530 
     531    /** The string current position. */ 
    277532    unsigned char *current; 
    278533} yaml_string_input_t; 
    … …  
    376631 */ 
    377632 
    378 yaml_parser_t * 
     633YAML_DECLARE(yaml_parser_t *) 
    379634yaml_parser_new(void); 
    380635 
    … …  
    385640 */ 
    386641 
    387 void 
     642YAML_DECLARE(void) 
    388643yaml_parser_delete(yaml_parser_t *parser); 
    389644 
    … …  
    397652 * @param[in]   parser  A parser object. 
    398653 * @param[in]   input   A source data. 
    399  * @param[in]   length  The length of the source data in bytes. 
    400  */ 
    401  
    402 void 
     654 * @param[in]   size    The length of the source data in bytes. 
     655 */ 
     656 
     657YAML_DECLARE(void) 
    403658yaml_parser_set_input_string(yaml_parser_t *parser, 
    404659        unsigned char *input, size_t size); 
    … …  
    415670 */ 
    416671 
    417 void 
     672YAML_DECLARE(void) 
    418673yaml_parser_set_input_file(yaml_parser_t *parser, FILE *file); 
    419674 
    … …  
    426681 */ 
    427682 
    428 void 
     683YAML_DECLARE(void) 
    429684yaml_parser_set_input(yaml_parser_t *parser, 
    430685        yaml_read_handler_t *handler, void *data); 
    … …  
    433688 * Set the source encoding. 
    434689 * 
     690 * @param[in]   parser      A parser object. 
    435691 * @param[in]   encoding    The source encoding. 
    436692 */ 
    437693 
    438 void 
     694YAML_DECLARE(void) 
    439695yaml_parser_set_encoding(yaml_parser_t *parser, yaml_encoding_t encoding); 
    440696 
    … …  
    460716 */ 
    461717 
    462 void * 
     718YAML_DECLARE(void *) 
    463719yaml_malloc(size_t size); 
    464720 
    … …  
    474730 */ 
    475731 
    476 void * 
     732YAML_DECLARE(void *) 
    477733yaml_realloc(void *ptr, size_t size); 
    478734 
    … …  
    484740 */ 
    485741 
    486 void 
     742YAML_DECLARE(void) 
    487743yaml_free(void *ptr); 
    488744 
    … …  
    508764 */ 
    509765 
    510 int 
     766YAML_DECLARE(int) 
    511767yaml_parser_update_buffer(yaml_parser_t *parser, size_t length); 
    512768 
Note: See TracChangeset for help on using the changeset viewer.