\hypertarget{classPageRange}{
\section{Page\-Range Class Reference}
\label{classPageRange}\index{PageRange@{PageRange}}
}
{\tt \#include $<$Page\-Range.h$>$}

\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
\hyperlink{classPageRange_a0}{Page\-Range} ()
\begin{CompactList}\small\item\em Constructs a new Page\-Range object. \item\end{CompactList}\item 
bool \hyperlink{classPageRange_a1}{add\-Spec} (const char, const char $\ast$)
\begin{CompactList}\small\item\em Add a constraint to the set of selected pages represented by this Page\-Range object. \item\end{CompactList}\item 
bool \hyperlink{classPageRange_a2}{is\-Selected} (const int, const int $\ast$)
\begin{CompactList}\small\item\em Returns true if the specified page is to be included. \item\end{CompactList}\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
void \hyperlink{classPageRange_e0}{verbosity} (const \hyperlink{verbosity_8h_a6}{verbosities} level)
\end{CompactItemize}


\subsection{Constructor \& Destructor Documentation}
\hypertarget{classPageRange_a0}{
\index{PageRange@{Page\-Range}!PageRange@{PageRange}}
\index{PageRange@{PageRange}!PageRange@{Page\-Range}}
\subsubsection[PageRange]{\setlength{\rightskip}{0pt plus 5cm}Page\-Range::Page\-Range ()}}
\label{classPageRange_a0}


Constructs a new Page\-Range object. 

This represents a selection of selected pages. When created, the {\tt Page\-Range} object represents all pages, but this set can be constrained in a variety of ways using the \hyperlink{classPageRange_a1}{add\-Spec} method. The resulting object can be queried, to ask whether a particular page would be included in the set, using the \hyperlink{classPageRange_a2}{is\-Selected} method. 

\subsection{Member Function Documentation}
\hypertarget{classPageRange_a1}{
\index{PageRange@{Page\-Range}!addSpec@{addSpec}}
\index{addSpec@{addSpec}!PageRange@{Page\-Range}}
\subsubsection[addSpec]{\setlength{\rightskip}{0pt plus 5cm}bool Page\-Range::add\-Spec (const char {\em type}, const char $\ast$ {\em spec})}}
\label{classPageRange_a1}


Add a constraint to the set of selected pages represented by this Page\-Range object. 

The arguments are a selector, which is one of the characters `l', `p', or `P', and a string representing one or more numbers. The meanings of the three selectors are as follows.

\begin{description}
\item['l' pagenum ]The last page printed will be the first one num- bered num Default is the last page in the document. If the num is prefixed by an equals sign, then it (and any argument to the -p option) is treated as a sequence number, rather than a value to compare with {\tt $\backslash$count0} values. Thus, using -l =9 will end with the ninth page of the document, no matter what the pages are actually numbered.

\item['p' pagenum ]The first page printed will be the first one num- bered num. Default is the first page in the docu- ment. If the num is prefixed by an equals sign, then it (and any argument to the -l option) is treated as a sequence number, rather than a value to compare with {\tt $\backslash$count0} values. Thus, using -p =3 will start with the third page of the document, no matter what the pages are actually numbered.

\item['P' pagelist ]A comma-separated list of pages and ranges (a-b) may be given, which will be interpreted as {\tt $\backslash$count0} values. Pages not specified will not be printed. Multiple -pp options may be specified or all pages and page ranges can be specified with one -pp option. \end{description}


Any of these specifications may be prefixed by either {\tt =} or {\tt :n:} In the former case, DVI page numbers are used rather than Te\-X {\tt $\backslash$count} registers; in the latter case, the program examines the {\tt $\backslash$countn} register rather than the default {\tt $\backslash$count0}

Thus, the syntax of pagelist is extended to satisfy: \small\begin{alltt}
    pagenum:  prefix* number
    pagelist: prefix* page-or-range [',' page-or-range]*
    prefix: '=' | ':' number ':'
    page-or-range: number | number-number
 \end{alltt}\normalsize 


\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em type}]one of the letters `l', `p', `P'. \item[{\em spec}]a page specification conforming to the grammar above \end{description}
\end{Desc}
\hypertarget{classPageRange_a2}{
\index{PageRange@{Page\-Range}!isSelected@{isSelected}}
\index{isSelected@{isSelected}!PageRange@{Page\-Range}}
\subsubsection[isSelected]{\setlength{\rightskip}{0pt plus 5cm}bool Page\-Range::is\-Selected (const int {\em pagenum}, const int $\ast$ {\em count})}}
\label{classPageRange_a2}


Returns true if the specified page is to be included. 

We test either the page-sequence number or the Te\-X {\tt $\backslash$count0-9} registers, depending on how the page range was specified.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em pagenum}]a page-sequence number, counting pages from the beginning of the DVI file \item[{\em count}]is the array of Te\-X {\tt $\backslash$count0-9} register \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if the current settings of this Page\-Range object would indicate that the specified page is to be printed \end{Desc}
\hypertarget{classPageRange_e0}{
\index{PageRange@{Page\-Range}!verbosity@{verbosity}}
\index{verbosity@{verbosity}!PageRange@{Page\-Range}}
\subsubsection[verbosity]{\setlength{\rightskip}{0pt plus 5cm}void Page\-Range::verbosity (const \hyperlink{verbosity_8h_a6}{verbosities} {\em level})\hspace{0.3cm}{\tt  \mbox{[}inline, static\mbox{]}}}}
\label{classPageRange_e0}




The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
\hyperlink{PageRange_8h}{Page\-Range.h}\item 
\hyperlink{PageRange_8cc}{Page\-Range.cc}\end{CompactItemize}