Xport Interface: stylesheet_item::at

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

declaration& stylesheet_item::at(1st Variety
  size_type n
);

const declaration& stylesheet::at(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 exception safe. If n is out of valid range, a std::out_of_range exception will be thrown.

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. When called on a stylesheet_import or stylesheet_comment, this operation always throws a std::out_of_range exception.

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
  std::cout << it->at(3).property_name() << ": " << it->at(3).value();
  std::cout << "\n\n";
}