Xport Interface: stylesheet::iterator::operator *

Dereference operator for stylesheet::iterator and stylesheet::const_iterator.

stylesheet_item& stylesheet::iterator::operator *() const; iterator

const stylesheet_item& stylesheet::const_iterator::operator *() const; const_iterator

Parameters

None

Returns

Returns a reference (or const reference for const_iterator) to the underlying stylesheet item.

Remarks

Dereferences the stylesheet iterator, returning a reference to the underlying stylesheet item (for iterator), and a const reference to the underlying stylesheet item (for const_iterator). This can be very handy, especially for the iterator, as it allows the insertion of declarations using the insertion operator, as shown in the example below.

Complexity

Constant

Example

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

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

  stylesheet ss;
  ss.insert(stylesheet_comment("Sample stylesheet"));

  // add a rule for h1 elements
  stylesheet::iterator it = ss.insert(stylesheet_rule("h1"));
  *it << (declaration(text_align, "center"))
      << (declaration(css::color, "red"));

  // add a rule for p elements
  it = ss.insert(stylesheet_rule("p"));
  *it << (declaration(margin_left, "10px"))
      << (declaration(font_size, "10pt"));

  // write the stylesheet to cout
  stylesheet_formatter fmtr(std::cout);
  ss.write(fmtr);
}