\hypertarget{classPageRange}{\section{Page\-Range Class Reference}
\label{classPageRange}\index{Page\-Range@{Page\-Range}}
}


{\ttfamily \#include $<$Page\-Range.\-h$>$}

\subsection*{Public Member Functions}
\begin{DoxyCompactItemize}
\item 
\hyperlink{classPageRange_aa537df1270205deaf962d7e97a71ed71}{Page\-Range} ()
\begin{DoxyCompactList}\small\item\em Constructs a new \hyperlink{classPageRange}{Page\-Range} object. \end{DoxyCompactList}\item 
bool \hyperlink{classPageRange_ac9b449e64277a53753be15a7b7244e1e}{add\-Spec} (const char, const char $\ast$)
\begin{DoxyCompactList}\small\item\em Add a constraint to the set of selected pages represented by this \hyperlink{classPageRange}{Page\-Range} object. \end{DoxyCompactList}\item 
bool \hyperlink{classPageRange_a47ef5138e837bddb5fb5a4442c9ea894}{is\-Selected} (const int, const int $\ast$)
\begin{DoxyCompactList}\small\item\em Returns true if the specified page is to be included. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Static Public Member Functions}
\begin{DoxyCompactItemize}
\item 
static void \hyperlink{classPageRange_a32a9416a8397953d349166b29cedbd08}{verbosity} (const \hyperlink{verbosity_8h_a886df075e73fd6d54e018791f87fa071}{verbosities} level)
\end{DoxyCompactItemize}


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


Constructs a new \hyperlink{classPageRange}{Page\-Range} object. 

This represents a selection of selected pages. When created, the {\ttfamily \hyperlink{classPageRange}{Page\-Range}} object represents all pages, but this set can be constrained in a variety of ways using the \hyperlink{classPageRange_ac9b449e64277a53753be15a7b7244e1e}{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_a47ef5138e837bddb5fb5a4442c9ea894}{is\-Selected} method. 

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


Add a constraint to the set of selected pages represented by this \hyperlink{classPageRange}{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{DoxyDescription}
\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 {\ttfamily \textbackslash{}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 {\ttfamily \textbackslash{}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 {\ttfamily \textbackslash{}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{DoxyDescription}

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

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



\begin{DoxyParams}{Parameters}
{\em type} & one of the letters `l', `p', `\-P'. \\
\hline
{\em spec} & a page specification conforming to the grammar above \\
\hline
\end{DoxyParams}


References normal.



Referenced by main().

\hypertarget{classPageRange_a47ef5138e837bddb5fb5a4442c9ea894}{\index{Page\-Range@{Page\-Range}!is\-Selected@{is\-Selected}}
\index{is\-Selected@{is\-Selected}!PageRange@{Page\-Range}}
\subsubsection[{is\-Selected}]{\setlength{\rightskip}{0pt plus 5cm}bool Page\-Range\-::is\-Selected (
\begin{DoxyParamCaption}
\item[{const int}]{pagenum, }
\item[{const int $\ast$}]{count}
\end{DoxyParamCaption}
)}}\label{classPageRange_a47ef5138e837bddb5fb5a4442c9ea894}


Returns true if the specified page is to be included. 

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


\begin{DoxyParams}{Parameters}
{\em pagenum} & a page-\/sequence number, counting pages from the beginning of the D\-V\-I file \\
\hline
{\em count} & is the array of Te\-X {\ttfamily \textbackslash{}count0-\/9} register \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
true if the current settings of this \hyperlink{classPageRange}{Page\-Range} object would indicate that the specified page is to be printed 
\end{DoxyReturn}


Referenced by main().

\hypertarget{classPageRange_a32a9416a8397953d349166b29cedbd08}{\index{Page\-Range@{Page\-Range}!verbosity@{verbosity}}
\index{verbosity@{verbosity}!PageRange@{Page\-Range}}
\subsubsection[{verbosity}]{\setlength{\rightskip}{0pt plus 5cm}static void Page\-Range\-::verbosity (
\begin{DoxyParamCaption}
\item[{const {\bf verbosities}}]{level}
\end{DoxyParamCaption}
)\hspace{0.3cm}{\ttfamily [inline]}, {\ttfamily [static]}}}\label{classPageRange_a32a9416a8397953d349166b29cedbd08}


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