package cpdf

  1. Overview
  2. Docs

Page specifications and ranges

Here are the rules for building input ranges:

  • A dash (-) defines ranges e.g 1-5 or 6-3.
  • A comma (,) allows one to specify several ranges, e.g. 1-2,4-5.
  • The word end represents the last page number.
  • The words odd and even can be used in place of or at the end of a page range to restrict to just the odd or even pages.
  • The words portrait and landscape can be used in place of or at the end of a page range to restrict to just those pages which are portrait or landscape. Note that the meaning of portrait and landscape does not take account of any viewing rotation in place. A page with equal width and height is considered neither portrait nor landscape.
  • The word reverse is the same as end-1.
  • The word all is the same as 1-end.
  • A range must contain no spaces.
  • A tilde (~) defines a page number counting from the end of the document rather than the beginning. Page ~1 is the last page, ~2 the penultimate page etc.
  • Prepending NOT to a whole page range inverts it, once the whole is parsed.
  • Appending DUP2 to a whole page range duplicates each page twice (or 3, or 4 etc. times), once the whole is parsed.
val parse_pagespec : Pdf.t -> string -> int list

Parse a (valid) page specification to a page range

val parse_pagespec_without_pdf : string -> int list

Same, but without a PDF. Thus 'end' etc. don't work

val validate_pagespec : string -> bool

Is a page specification, in theory, valid? This is the most we can find out without supplying a PDF, and thus knowing how many pages there are in it.

val string_of_pagespec : Pdf.t -> int list -> string

Return a string for the given range. Knows how to identify all, odd, even, x-y ranges etc.