20.3 RFC 2426 – MIME, Part three

This section presents the facilities supported by Bigloo for dealing with vcards.

Bigloo Mail class: vcard

(class vcard
  (version::bstring (default "2.1"))
  (fn (default #f))
  (familyname (default #f))
  (firstname (default #f))
  (face (default #f))
  (url (default #f))
  (org (default #f))
  (emails::pair-nil (default '()))
  (phones::pair-nil (default '()))
  (addresses::pair-nil (default '())))

The class vard is used to reify in memory a vcard as parsed by the function port->vcard and string->vcard.

Except emails, phones, and addresses, all fields are optional. They should be either #f or a string.

• face is a flat list of strings.
• phones is an alist whose elements are pairs of two strings.
• addresses is a list composed of:
  • the postoffice, a string,
  • a list of strings denoting the street address,
  • a string denoting the city,
  • a string denoting the region,
  • a string denoting the zip code,
  • a string denoting the zip country.

  All street values are required and must be provided. The empty string should be used to denote empty values.

Bigloo Mail function: port->vcard::vcard ip [:charset-encoder]

Bigloo Mail function: string->vcard::vcard str [:charset-encoder]

These two functions parse a vcard to produce a vcard instance. The optional argument charset-encoder, when provided, must be a function of argument: a string to be decoded. Vcard strings are UTF-8 encoded. The charset-encoder can be used to encode on-the-fly the strings found in the vcard in a difference encoding.

This document was generated on October 23, 2011 using texi2html 5.0.