Xport Interface: stylesheet_item::operator []

Returns a reference (or const reference in the 2nd variety) to the declaration at the specified index.

declaration& stylesheet_item::operator[](1st Variety
  size_type n
);

const declaration& stylesheet::operator[](2nd Variety
  size_type n
) const;

Parameters

n

An index specifying the declaration to return.

Returns

A reference (or const reference in the 2nd variety) of the declaration which resides at the specified index.

Remarks

Returns a reference (or const reference in the 2nd variety) of the declaration which resides at the specified index. Caller must insure that n is in a valid range. This operation is not exception safe. For an exception save indexed operation, use stylesheet_item::at().

This is one of the operations of stylesheet_item which is relevent only when called on a stylesheet_rule., since only stylesheet rules can include declarations.

Complexity

Constant

Example

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

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

  stylesheet ss;

  // insert a couple rules
  stylesheet::iterator it = ss.insert(stylesheet_rule("html"));
  it->insert(declaration(css::margin, "5px"));
  it->insert(declaration(css::padding, "5px"));
  it->insert(declaration(font_family, "Tahoma"));

  it = ss.insert(stylesheet_rule("#sidebar"));
  it->insert(declaration(css::position, "absolute"));
  it->insert(declaration(css::right, "5px"));
  it->insert(declaration(css::top, "10px"));
  it->insert(declaration(css::width, "100px"));

  // now write the 3rd declation of the 2nd rule to cout
  const stylesheet_item& decl = *it;
  std::cout << decl[3].property_name() << ": " << decl[3].value();
  std::cout << "\n\n";
}