Xport Interface: element::attributes

Retrieves all attribute values for the called element.

virtual std::map<xhtml_attribute, std::string>* element::attributes();1st Variety

virtual const std::map<xhtml_attribute, std::string>* element::attribute() const;2nd Variety

Parameters

none

Returns

Returns a pointer (or const pointer in the 2nd variety) to the element's attribute map.

Remarks

Return a pointer to a map of all attributes for the called element. The map will contain xhtml_attribute/string pairs. The attribute map does not contain any style attributes which may be present for the element. When called on a derived element object, a pointer (or const pointer in the 2nd variety) is to the element's attribute map is returned. In this map, the key type is xhtml_attribute enumerators, and the value type is a string representing the value for the corrasponding attribute.

Complexity

Constant

Example

#include "xhtml_doc.h"
#include "xport_brochure.h"
#include <iostream>

int main(int argc, char* argv[])
{
  using namespace Xport;

  // create an xhtml strict root document and stylesheet
  document doc(root_doc);
  stylesheet ss;

  // populate document with xport brochure
  xport_brochure broch;
  broch.create(doc, ss);

  // iterate over all elements in the doc, and report all elements with more than one attribute 
  markup::const_descendant_iterator it = doc.descendant_begin();
  for (; it != doc.descendant_end(); ++it) {
    if (it->markup_type() == mt_element) {
      const std::map<xhtml_attribute, std::string>* attr_map = it->attributes();
      if (attr_map->size() > 1) {
        std::cout << it->tag_name() << " element has multiple attributes.\n";
      }
    }
  }

  return 0;
}