Public structures
*****************

 -- Public Type: VF_PARSER_T

     Type representing "parser" - an object used to parse VOBJECTS.

 -- Public Type: VF_OBJECT_T

     Type representing an "object" - objects are collections of properties.

 -- Public Type: VF_PROP_T

     Type representing a "property" - properties associate a name & a value.

 -- Structure: VF_ISO8601_PERIOD_T

     {

     uint32_t    years

     uint32_t    months

     uint32_t    weeks

     uint32_t    days

     uint32_t    hours

     uint32_t    minutes

     uint32_t    seconds

     }

     VF_ISO8601_PERIOD_T is used to encapsulate an ISO time 'period'.

 -- Public Type: uint8_t vf_encoding_t

     vf_encoding_t enumerates the supported encodings (formats) of a vformat object property.  Each "value" has a field of this type.

     Predefined values

     VF_ENC_UNKNOWN           ((vf_encoding_t)(0))
     VF_ENC_7BIT              ((vf_encoding_t)(1))
     VF_ENC_8BIT              ((vf_encoding_t)(2))
     VF_ENC_BASE64            ((vf_encoding_t)(3))
     VF_ENC_QUOTEDPRINTABLE    ((vf_encoding_t)(4))
     VF_ENC_VOBJECT           ((vf_encoding_t)(5))

 -- Public Type: uint16_t vf_get_t

     vf_get_t controls the operation of vf_get_property() (qv).  Controls how far the search algorithm is prepared to go in order to return a property ready for modification.

     Predefined values

     VFGP_FIND        ((vf_get_t)(0x0001))     Search for property
     VFGP_APPEND      ((vf_get_t)(0x0002))     Append property, no search
     VFGP_GET         ((vf_get_t)(0x0003))     Find & append if not present

 -- Public Type: uint32_t vf_search_flags_t

     vf_search_flags_t is used to describe how string matching is performed when searching for properties, qualifiers, values etc.