$fverpcmp function

$fverpcmp(path,version)

The $fverpcmp function compares the product version of the file specified by path with the version specified by version and returns a value < 0, 0, or > 0 depending on the comparison result:

The result can be used in conditional expressions; see Examples below.

If path does not refer to a file, if the file does not exist, or if the file does not have a VERSIONINFO resource, then its product version is treated as if it were 0.0.0.0.

The version parameter must consist of up to 4 decimal numbers separated by periods: a.b.c.d, from most to least significant. You may leave off less significant numbers; any missing numbers are treated as 0. Therefore, 2.1.0.0, 2.1.0 and 2.1 are equivalent.

The comparison is done numerically, not as text. This means, for example, that if the product version of path is 2.19, then $fverpcmp(path, 2.2) is > 0, because 19 > 2. It also means that 2.2 and 2.20 are not the same version (but 2.2 and 2.2.0 are).

Tip: To compare file versions instead of product versions, use the $fverfcmp function.

Windows Installer does not support symbolic functions; if you use this function during an MSI build, you will get diagnostic message BLD:U0010 and the result is undefined.

Parameters

All parameters may contain symbolic references; these are resolved before the function is applied. See Examples below.

path

File path of the file whose product version must be compared.

version

Version for the comparison.

Examples

Here are some usage examples for this function:

<$fverpcmp(<WindowsFolder>\Notepad.exe, 5)>

Returns < 0 if the Notepad.exe product version is < 5.0.0.0, 0 if it is 5.0.0.0, and > 0 if it is > 5.0.0.0.

<$fverpcmp(<WindowsFolder>\Notepad.exe, 5)> >= 0

Conditional expression that evaluates to TRUE if the Notepad.exe product version is 5.0.0.0 or greater, or FALSE if not.

<$fverpcmp(<WindowsFolder>\Notepad.exe, <MinVersion>)> >= 0

Conditional expression that evaluates to TRUE if the Notepad.exe product version is greater than or equal to <MinVersion>, or FALSE if not. <MinVersion> should evaluate to something that can be parsed as a version number.