Xport Interface: stylesheet::at

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

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

const stylesheet_item& stylesheet::at(2nd Variety
  size_type n
) const;

Parameters

n

An index specifying the stylesheet_item to return.

Returns

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

Remarks

Returns a reference (or const reference in the 2nd variety) of the stylesheet_item 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.

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;

  xport_brochure broch;
  broch.create(doc, ss);

  // print the 10th stylesheet item in the stylesheet
  if (ss.size() > 10) {
    stylesheet_formatter fmtr(std::cout);
    ss.at(10).write(fmtr);
  }
}