.TH "PageRange" 3 "Mon Jan 12 2015" "Version dvi2bitmap1.0" "dvi2bitmap" \" -*- nroff -*-
.ad l
.nh
.SH NAME
PageRange \- 
.SH SYNOPSIS
.br
.PP
.PP
\fC#include <PageRange\&.h>\fP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBPageRange\fP ()"
.br
.RI "\fIConstructs a new \fBPageRange\fP object\&. \fP"
.ti -1c
.RI "bool \fBaddSpec\fP (const char, const char *)"
.br
.RI "\fIAdd a constraint to the set of selected pages represented by this \fBPageRange\fP object\&. \fP"
.ti -1c
.RI "bool \fBisSelected\fP (const int, const int *)"
.br
.RI "\fIReturns true if the specified page is to be included\&. \fP"
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static void \fBverbosity\fP (const \fBverbosities\fP level)"
.br
.in -1c
.SH "Constructor & Destructor Documentation"
.PP 
.SS "PageRange::PageRange ()"

.PP
Constructs a new \fBPageRange\fP object\&. This represents a selection of selected pages\&. When created, the \fC\fBPageRange\fP\fP object represents all pages, but this set can be constrained in a variety of ways using the \fBaddSpec\fP method\&. The resulting object can be queried, to ask whether a particular page would be included in the set, using the \fBisSelected\fP method\&. 
.SH "Member Function Documentation"
.PP 
.SS "bool PageRange::addSpec (const chartype, const char *spec)"

.PP
Add a constraint to the set of selected pages represented by this \fBPageRange\fP 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\&.
.PP
.IP "\fB'l' pagenum \fP" 1c
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 \fC\\count0\fP values\&. Thus, using -l =9 will end with the ninth page of the document, no matter what the pages are actually numbered\&.
.PP
.IP "\fB'p' pagenum \fP" 1c
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 \fC\\count0\fP values\&. Thus, using -p =3 will start with the third page of the document, no matter what the pages are actually numbered\&.
.PP
.IP "\fB'P' pagelist \fP" 1c
A comma-separated list of pages and ranges (a-b) may be given, which will be interpreted as \fC\\count0\fP 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\&. 
.PP
.PP
Any of these specifications may be prefixed by either \fC=\fP or \fC:n:\fP In the former case, DVI page numbers are used rather than TeX \fC\\count\fP registers; in the latter case, the program examines the \fC\\countn\fP register rather than the default \fC\\count0\fP
.PP
Thus, the syntax of pagelist is extended to satisfy: 
.PP
.nf

   pagenum:  prefix* number
   pagelist: prefix* page-or-range [',' page-or-range]*
   prefix: '=' | ':' number ':'
   page-or-range: number | number-number
.fi
.PP
.PP
\fBParameters:\fP
.RS 4
\fItype\fP one of the letters `l', `p', `P'\&. 
.br
\fIspec\fP a page specification conforming to the grammar above 
.RE
.PP

.PP
References normal\&.
.PP
Referenced by main()\&.
.SS "bool PageRange::isSelected (const intpagenum, const int *count)"

.PP
Returns true if the specified page is to be included\&. We test either the page-sequence number or the TeX \fC\\count0-9\fP registers, depending on how the page range was specified\&.
.PP
\fBParameters:\fP
.RS 4
\fIpagenum\fP a page-sequence number, counting pages from the beginning of the DVI file 
.br
\fIcount\fP is the array of TeX \fC\\count0-9\fP register 
.RE
.PP
\fBReturns:\fP
.RS 4
true if the current settings of this \fBPageRange\fP object would indicate that the specified page is to be printed 
.RE
.PP

.PP
Referenced by main()\&.
.SS "static void PageRange::verbosity (const \fBverbosities\fPlevel)\fC [inline]\fP, \fC [static]\fP"


.SH "Author"
.PP 
Generated automatically by Doxygen for dvi2bitmap from the source code\&.