---

CCARD

Purpose

Card parser is for the general parsing of card (doh!) objects, aka vCards & vCals. It is a event orientated parser designed to be used in a similar manner to expat (a XML parser).

ccard License

All code is under the Mozilla Public License 1.1 (MPL 1.1) as specified in license.txt

Features

• generic for any card sytax, e.g vCard & vCal
• reports errors in sytax
• Event orientated (ie reentrant & stream orientated)
• Handles line folding
• Automatic decoding of params
• Handles quoted-printable and base64 decoding

Does NOT

• Generate cards (parser *only*)
• verify overall card structure - ie if required properties are missing - tough.

Usage

1. Create a card parser
   • CARD_ParserCreate()

2. Init the parser:
   • CARD_SetUserData()
   • CARD_SetPropHandler()
   • CARD_SetDataHandler()

3. Feed it Data
   • CARD_Parse()
   • Handle the parse events in the callbacks specified in 2.
   • Keep feeding it data in as large and small chunks as you like

4. Free the card parser
   • CARD_ParserFree()

Reference

- const char *CARD_ParserVersion()
- CARD_Parser CARD_ParserCreate(CARD_Char *encoding)
- void CARD_ParserFree(CARD_Parser p)
- int CARD_Parse(CARD_Parser p, const char *s, int len, int isFinal)
- void CARD_SetUserData(CARD_Parser p, void *userData)
- void *CARD_GetUserData(CARD_Parser p)
- void CARD_SetPropHandler(CARD_Parser p, CARD_PropHandler cardProp)
- void CARD_SetDataHandler(CARD_Parser p, CARD_DataHandler cardData)
- typedef void (*CARD_PropHandler)(void *userData, const CARD_Char *propname, const CARD_Char **params);
- typedef void (*CARD_DataHandler)(void *userData, const CARD_Char *data, int len);

---