Xport Interface: stylesheet::begin

Returns a stylesheet iterator pointing to the first stylesheet item in the stylesheet.

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

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

Parameters

none

Returns

A stylesheet iterator (or const_iterator in the second variety) pointing to the first stylesheet item in the stylesheet. A stylesheet item can be a stylesheet_rule, stylesheet_comment, or a stylesheet_import object. If the stylesheet is empty, returns stylesheet::end().

Remarks

stylesheet_iterators can be used to traverse the objects in a stylesheet, and in standard algorithms. stylesheet::begin() returns an iterator which points to the first stylesheet object, if any, or stylesheet::end() if the stylesheet is empty.

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
  document doc(root_doc);
  stylesheet ss;

  // populate document
  std::cout << "Creating Xport Brochure.\n\n";
  xport_brochure broch;
  broch.create(doc, ss);

  // create a stylesheet formatter for output
  stylesheet_formatter fmtr(std::cout);

  // output the first stylesheet item
  stylesheet::const_iterator it = ss.begin();
  if (it != ss.end()) {
    it->write(fmtr);
    std::cout << "\n\n";
  }
}