Xport Interface: stylesheet_item::begin

For a called stylesheet_rule, returns a stylesheet_item iterator pointing to the first declaration in the rule.

stylesheet_item::iterator stylesheet_item::begin();1st Variety

stylesheet_item::const_iterator stylesheet_item::begin() const;2nd Variety

Parameters

none

Returns

For a called stylesheetrule, returns a stylesheet_item iterator (or const_iterator in the second variety) pointing to the first declaration in the stylesheet rule. If there are no declarations in the stylesheet rule, or if this operation is called on a stylesheet_import or stylesheet_comment, returns stylesheet_item::end().

Remarks

stylesheet_Item iterators can be used to traverse the declarations in a stylesheet rule, and in standard algorithms. stylesheet_item::begin() returns an iterator which points to the first declaration object, if any, or stylesheet::end() if the stylesheet rule is empty.

This is one of the operations in stylesheete_item which is relevent only to the derived stylesheet_rule. When called on a derived stylesheet_import or stylesheet_comment, this operation always returns stylsheet_item::end().

Complexity

Constant

Example

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

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

  document doc(root_doc);
  stylesheet ss;

  // populate stylesheet
  xport_brochure broch;
  broch.create(doc, ss);

  stylesheet::const_iterator ss_it = ss.begin();

  // now write all the declarations to cout
  for (; ss_it != ss.end(); ++ss_it) {
    std::cout << "Declarations for " << ss_it->selector() << "\n";
    stylesheet_item::const_iterator it = ss_it->begin();
    for (; it != ss_it->end(); ++it) {
      std::cout << it->property_name() << ": " << it->value() << "\n";
    }
    std::cout << "\n\n";
  }
}