text: /*
   * fields.h
   *
   * Copyright (c) Chris Putnam 2003-2020
   *
   * Source code released under the GPL version 2
   *
   */
  #ifndef FIELDS_H
  #define FIELDS_H
  
  #define FIELDS_OK         (1)
  #define FIELDS_ERR_MEMERR (0)
  
  #define FIELDS_NOTFOUND (-1)
  
  #define LEVEL_ORIG   (-2)
  #define LEVEL_ANY    (-1)
  #define LEVEL_MAIN    (0)
  #define LEVEL_HOST    (1)
  #define LEVEL_SERIES  (2)
  
  #include <stdarg.h>
  #include "str.h"
  #include "vplist.h"
  
  typedef struct fields {
  	str       *tag;
  	str       *value;
  	int       *used;
  	int       *level;
  	int       n;
  	int       max;
  } fields;
  
  void    fields_init( fields *f );
  fields *fields_new( void );
  fields *fields_dupl( fields *f );
  void    fields_delete( fields *f );
  void    fields_free( fields *f );
  
  int     fields_remove( fields *f, int n );
  
  #define FIELDS_CAN_DUP (0)
  #define FIELDS_NO_DUPS (1)
  
  #define fields_add( a, b, c, d )                   _fields_add( a, b, c, d, FIELDS_NO_DUPS )
  #define fields_add_can_dup( a, b, c, d )           _fields_add( a, b, c, d, FIELDS_CAN_DUP )
  #define fields_add_suffix( a, b, c, d, e )         _fields_add_suffix( a, b, c, d, e, FIELDS_NO_DUPS )
  #define fields_add_suffix_can_dup( a, b, c, d, e ) _fields_add_suffix( a, b, c, d, e, FIELDS_CAN_DUP )
  
  int  _fields_add       ( fields *f, const char *tag,                     const char *value, int level, int mode );
  int  _fields_add_suffix( fields *f, const char *tag, const char *suffix, const char *value, int level, int mode );
  
  int  fields_maxlevel( fields *f );
  void fields_clear_used( fields *f );
  void fields_set_used( fields *f, int n );
  int  fields_replace_or_add( fields *f, const char *tag, const char *value, int level );
  
  int fields_num( fields *f );
  int fields_used( fields *f, int n );
  int fields_no_tag( fields *f, int n );
  int fields_no_value( fields *f, int n );
  int fields_has_value( fields *f, int n );
  
  int fields_match_level( fields *f, int n, int level );
  int fields_match_tag( fields *f, int n, const char *tag );
  int fields_match_casetag( fields *f, int n, const char *tag );
  int fields_match_tag_level( fields *f, int n, const char *tag, int level );
  int fields_match_casetag_level( fields *f, int n, const char *tag, int level );
  
  void fields_report( fields *f, FILE *fp );
  
  #define FIELDS_STRP_FLAG     (2)
  #define FIELDS_POSP_FLAG     (4)
  #define FIELDS_NOLENOK_FLAG  (8)
  #define FIELDS_SETUSE_FLAG  (16)
  
  #define FIELDS_CHRP        (FIELDS_SETUSE_FLAG                                         )
  #define FIELDS_STRP        (FIELDS_SETUSE_FLAG | FIELDS_STRP_FLAG                      )
  #define FIELDS_POSP        (FIELDS_SETUSE_FLAG | FIELDS_POSP_FLAG                      )
  #define FIELDS_CHRP_NOLEN  (FIELDS_SETUSE_FLAG |                    FIELDS_NOLENOK_FLAG)
  #define FIELDS_STRP_NOLEN  (FIELDS_SETUSE_FLAG | FIELDS_STRP_FLAG | FIELDS_NOLENOK_FLAG)
  #define FIELDS_POSP_NOLEN  (FIELDS_SETUSE_FLAG | FIELDS_POSP_FLAG | FIELDS_NOLENOK_FLAG)
  #define FIELDS_CHRP_NOUSE  (                            0                              )
  #define FIELDS_STRP_NOUSE  (                     FIELDS_STRP_FLAG                      )
  
  void *fields_tag( fields *f, int n, int mode );
  void *fields_value( fields *f, int n, int mode );
  int   fields_level( fields *f, int n );
   
  int   fields_find( fields *f, const char *searchtag, int level );
  
  void *fields_findv( fields *f, int level, int mode, const char *tag );
  void *fields_findv_firstof( fields *f, int level, int mode, ... );
  
  int   fields_findv_each( fields *f, int level, int mode, vplist *a, const char *tag );
  int   fields_findv_eachof( fields *f, int level, int mode, vplist *a, ... );
  
  #endif
  