---
name: "Pandoc::Version"
section: "3pm"
platform: "linux"
package: "libpandoc-wrapper-perl"
version: "0.9.2-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Pandoc::Version"
---

# Pandoc::Version(3pm)

version number of pandoc and its libraries

## NAME

Pandoc::Version - version number of pandoc and its libraries

## SYNOPSIS

```
  $version = Pandoc::Version->new("1.17.2");     # create version
  $version = bless [1,17,2], 'Pandoc::Version';  # equivalent
  "$version";       # stringify to "1.17.2"
  $version > 1.9;   # compare
  $version->[0];    # major
  $version->[1];    # minor
  $version->match('1.17');   # true for 1.17, 1.17.x, 1.17.x.y...
```

## DESCRIPTION

This module is used to store and compare version numbers of pandoc executable and Haskell libraries compiled into pandoc. A Pandoc::Version object is an array reference of one or more non-negative integer values.

In most cases there is no need to create Pandoc::Version objects by hand. Just use the instances returned by methods `"version"` and `"libs"` of module Pandoc and trust in overloading.

## METHODS

### string

Return a string representation of a version, for instance `"1.17.0.4"`. This method is automatically called by overloading in string context.

### number

Return a number representation of a version, for instance `1.017000004`. This method is automatically called by overloading in number context.

### cmp( $version )

Compare two version numbers. This is method is used automatically by overloading to compare version objects with strings or numbers (operators `"eq"`, `"lt"`, `"le"`, `"ge"`, `"=="`, `"<"`, `">"`, `"<="`, and `">="`).

### match( $version )

Return whether a version number matches another version number if cut to the same number of parts. For instance `1.2.3` matches `1`, `1.2`, and `1.2.3`.

### fulfills( $version\_requirement )

Return whether a version number fullfills a version requirement, such as `"!=1.16, <=1.17"`. See "Version Ranges" in CPAN::Meta::Spec for possible values.

### TO\_JSON

Return an array reference of the version number to serialize in JSON format.

## SEE ALSO

version is a similar module for Perl version numbers.

SemVer extends versions to Semantic Versioning as described at \<http://semver.org/\>.

Pandoc::Release to get information about and download pandoc releases.