Xport Interface: markup::size

Returns the number of child markup objects contained in the called markup object.

markup::size_type markup::size();

Parameters

None

Returns

Returns the number of child markup objects contained within the called markup object.

Remarks

This operation is used to determine the number of children in the called markup object. The operation is only relevant when called on derived element objects, since element is the only type derived from markup which can contain other markup objects. If called on a derived element object, returns the number of children in the element.

This operation always returns 0 when called from any markup derived type other than element, which includes pcdata, comment, and procinstr.

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
  xport_brochure broch;
  broch.create(doc, ss);

  // iterate over all elements in the document, and output their size
  markup::const_descendant_iterator it = doc.descendant_begin();
  for (; it != doc.descendant_end(); ++it) {
    if (it->markup_type() == mt_element) {
      std::cout << it->tag_name() << " element has " << it->size() << (it->
      size() == 1 ? " child.\n" : " children.\n");
    }
  }

  return 0;
}