Référence de l'API XPInstall:Objet InstallVersion:Méthodes:compareTo
Un article de MDC.
Sommaire |
[modifier] compareTo
Compare les informations de version spécifiées dans cet objet à celles spécifiées dans le paramètre version.
[modifier] Méthode de
Objet InstallVersion
[modifier] Syntaxe
compareTo ( InstallVersion version);
compareTo ( String version);
compareTo ( int major, int minor, int release, int build);
[modifier] Paramètres
La méthode compareTo a les paramètres suivants :
maj- Le numéro de version majeur.
min- Le numéro de version mineur.
rev- Le numéro de révision.
bld- Le numéro de compilation.
version- Une chaîne représentant les informations de version au format
4.1.2.1234.
[modifier] Retour
Si les versions sont les mêmes, cette méthode retourne 0. Si la version de cet objet représente une version plus petite (précédente) que celle représentée dans le paramètre version, cette méthode retourne un nombre négatif. Autrement, elle retourne un nombre positif. En particulier, cette méthode retourne l'un des nombres suivants :
- -4
- La version de l'objet a un numéro majeur plus petit (plus ancien) que le paramètre
version. - -3
- La version de l'objet a un numéro mineur plus petit (plus ancien) que le paramètre
version. - -2
- La version de l'objet a un numéro de version plus petit (plus ancien) que le paramètre
version. - -1
- La version de l'objet a un numéro de compilation plus petit (plus ancien) que le paramètre
version. - 0
- Les numéros de version sont égaux ; les deux objets représentent la même version.
- 1
- La version de l'objet a un numéro de compilation plus grand (plus récent) que le paramètre
version. - 2
- La version de l'objet a un numéro de version plus grand (plus récent) que le paramètre
version. - 3
- La version de l'objet a un numéro mineur plus grand (plus récent) que le paramètre
version. - 4
- La version de l'objet a un numéro majeur plus grand (plus récent) que le paramètre
version.
Les constantes suivantes sont définies et disponible pour vérifier la valeur retournée par compareTo :
InstallVersion.MAJOR_DIFFInstallVersion.MINOR_DIFFInstallVersion.REL_DIFFInstallVersion.BLD_DIFFInstallVersion.EQUALInstallVersion.MAJOR_DIFF_MINUSInstallVersion.MINOR_DIFF_MINUSInstallVersion.REL_DIFF_MINUSInstallVersion.BLD_DIFF_MINUS
[modifier] Exemple
Ce code est utilise la méthode compareTo pour déterminer si oui ou non la version 3.2.1 du logiciel « Royal Airways » a été précédemment installée :
existingVI = InstallTrigger.getVersion("/royalairways/royalsw");
if ( existingVI.compareTo("3.2.1") <= 0 ) {
// ... procède à la mise à jour ...
}