La classe BirtComp fournit des fonctions pour comparer des valeurs, par exemple pour déterminer si une valeur est égale, supérieure ou inférieure à une autre. Toutes les fonctions renvoient des valeurs booléennes. Cette classe est statique. L'application ne peut pas créer d'instance de la classe.
Cette fonction compare une ou plusieurs valeurs au contenu d'une zone.
Syntaxe
Paramètres
source
Zone dont le contenu doit être utilisé pour la comparaison.
target
Valeur ou valeurs à trouver dans la source.
Renvoie
Booléen. True si une valeur target correspond à une valeur dans la source ; autrement retourne false.
Exemples
L'exemple suivant permet de vérifier si les valeurs Canada, Mexico ou USA figurent dans la zone Country. Si un ou plusieurs de ces pays se trouvent dans la zone, la fonction retourne true.
L'exemple suivant permet de vérifier si 15 janvier 2009 ou 31 janvier 2009 figure dans la zone payDate :
L'exemple suivant permet de vérifier si deux codes produit spécifiques figurent dans la zone productCode. Si l'une ou l'autre des valeurs figurent dans la zone, la chaîne Obsolete s'affiche. Autrement la valeur productCode s'affiche, telle qu'elle apparaît dans la zone.
Cette fonction permet de vérifier si une valeur se trouve entre deux valeurs.
Syntaxe
Paramètres
source
Valeur à tester.
target1
Première valeur de la plage de valeurs à comparer.
target2
Seconde valeur de la plage de valeurs à comparer.
Renvoie
True si la valeur source se trouve entre les valeurs target1 et target ; autrement retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test se trouvent dans une plage de valeurs :
L'exemple suivant calcule les dates d'envoi. Si une valeur OrderDate se trouve en décembre 2008 (entre le 1 décembre 2008 et le 31 décembre 2008), il ajoute 5 jours à la valeur OrderDate. Si une valeur OrderDate est dans un mois autre que décembre, il ajoute 3 jours à la valeur OrderDate.
Cette fonction permet de déterminer si une valeur de chaîne correspond à une autre en fonction de critères définis.
Syntaxe
Paramètres
source1
Première valeur de chaîne à utiliser dans la comparaison.
source2
Seconde valeur de chaîne à utiliser dans la comparaison.
ignoreCase
Spécifiez true pour effectuer une comparaison en ne respectant pas la casse. Spécifiez false pour effectuer une comparaison en respectant la casse.
trim
Spécifiez true pour supprimer les blancs de début ou de fin avant de comparer les deux valeurs. Les blancs au milieu d'une chaîne ne sont pas supprimés. Spécifiez false pour que les blancs de début ou de fin soient incluent dans la comparaison.
Renvoie
True si la valeur source1 correspond à la valeur source2 ; autrement, retourne false.
Exemples
Les expressions suivantes comparent des chaînes avec des critères différents définis :
Cette fonction détermine si une valeur est égale à une autre.
Syntaxe
Paramètres
source
Première valeur à utiliser dans la comparaison.
target
Seconde valeur à utiliser dans la comparaison.
Renvoie
True si la valeur source est égale à la valeur target ; autrement retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test sont égales à des valeurs définies :
Cette fonction détermine si une valeur est supérieure ou égale à une autre.
Syntaxe
Paramètres
source
Première valeur à utiliser dans la comparaison.
target
Seconde valeur à utiliser dans la comparaison.
Renvoie
True si la valeur source est supérieure ou égale à la valeur target ; autrement retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test sont supérieures ou égales à des valeurs définies :
Cette fonction permet de déterminer si une valeur est supérieure à une autre.
Syntaxe
Paramètres
source
Première valeur à utiliser dans la comparaison.
target
Seconde valeur à utiliser dans la comparaison.
Renvoie
True si la valeur source est supérieure à la valeur target. Autrement, retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test sont supérieures à des valeurs définies :
Cette fonction permet de déterminer si une valeur est inférieure ou égale à une autre.
Syntaxe
Paramètres
source
Première valeur à utiliser dans la comparaison.
target
Seconde valeur à utiliser dans la comparaison.
Renvoie
True si la valeur source est inférieure ou égale à la valeur target ; autrement retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test sont inférieures ou égales à des valeurs définies :
Cette fonction permet de déterminer si une valeur est inférieure à une autre.
Syntaxe
Paramètres
source
Première valeur à utiliser dans la comparaison.
target
Seconde valeur à utiliser dans la comparaison.
Renvoie
True si la valeur source est inférieure à la valeur target. Autrement, retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test sont inférieures à des valeurs définies :
Cette fonction permet de déterminer si une valeur de chaîne correspond à un modèle. Le modèle doit utiliser une syntaxe correspondant au modèle SQL.
Syntaxe
Paramètres
source
Valeur de chaîne à évaluer.
target
Modèle de chaîne à comparer. Vous devez placer le modèle entre guillemets (" "). Utilisez la casse correcte lorsque vous tapez les caractères à comparer. Vous pouvez utiliser les caractères spéciaux suivants dans un modèle :
Pour faire correspondre un pourcentage (%) ou un caractère de soulignement (_) littéral, faites précéder ces caractères de deux barres obliques inverses (\\). Par exemple, pour établir une correspondance avec S_10, utilisez le modèle suivant :
Pour établir une correspondance avec 50%, utilisez le modèle suivant :
Renvoie
True si la valeur source correspond à la valeur target. Autrement, retourne false.
Exemples
L'exemple suivant retourne True pour les valeurs de la zone productCode qui commencent par S18 :
L'exemple suivant retourne True pour les valeurs productName qui contiennent la sous-chaîne Ford précédée d'un seul caractère :
Cette fonction permet de déterminer si une valeur de chaîne correspond à un modèle. Le modèle doit utiliser la syntaxe des expressions régulières JavaScript.
Syntaxe
Paramètres
source
Valeur de chaîne à évaluer.
target
Modèle de chaîne à comparer. Dans la syntaxe d'expression régulière JavaScript, vous définissez un modèle dans une paire de barres (/) obliques. Vous pouvez utiliser n'importe quel caractère spécial pris en charge dans les expressions régulière JavaScript :
Pour établir une correspondance avec un caractère spécial littéralement, faites précéder le caractère spécial d'une barre oblique inverse (\). Par exemple, pour établir une correspondance avec S*10, utilisez le modèle suivant :
Renvoie
True si la valeur source correspond à la valeur target. Autrement, retourne false.
Exemples
L'exemple suivant retourne True pour les valeurs de la zone productCode qui commencent par S18 :
L'exemple suivant retourne True pour les valeurs productName qui contiennent la sous-chaîne Ford :
Cette fonction permet de déterminer si une valeur se trouve entre deux valeurs définies.
Syntaxe
Paramètres
source
Valeur à tester.
target1
Première valeur de la plage de valeurs à comparer.
target2
Seconde valeur de la plage de valeurs à comparer.
Renvoie
True si la valeur source ne se trouve pas entre les valeurs target1 et target ; autrement retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test se trouvent hors d'une plage donnée de valeurs :
L'exemple suivant calcule les dates d'envoi. Si une valeur OrderDate ne se trouve pas en décembre 2008 (pas entre le 1 décembre 2008 et le 31 décembre 2008), il ajoute 3 jours à la valeur OrderDate. Si la valeur OrderDate se trouve en décembre, il ajoute 5 jours à la valeur OrderDate.
Cette fonction détermine si une valeur n'est pas égale à une autre.
Syntaxe
Paramètres
source
Première valeur à utiliser dans la comparaison.
target
Seconde valeur à utiliser dans la comparaison.
Renvoie
True si la valeur source n'est pas égale à la valeur target ; autrement retourne false.
Exemples
Les expressions suivantes permettent de déterminer si des valeurs de zone de test ne sont pas égales à des valeurs définies :
Cette fonction permet de déterminer si une valeur de chaîne ne correspond pas à un modèle. Le modèle doit utiliser une syntaxe correspondant au modèle SQL.
Syntaxe
Paramètres
source
Valeur de chaîne à évaluer.
target
Modèle de chaîne à comparer. Vous devez placer le modèle entre guillemets (" "). Utilisez la casse correcte lorsque vous tapez les caractères à comparer. Vous pouvez utiliser les caractères spéciaux suivants dans un modèle :
Pour faire correspondre un pourcentage (%) ou un caractère de soulignement (_) littéral, faites précéder ces caractères de deux barres obliques inverses (\\). Par exemple, pour établir une correspondance avec S_10, utilisez le modèle suivant :
Pour établir une correspondance avec 50%, utilisez :
Renvoie
True si la valeur source n'est pas égale à la valeur target ; autrement retourne false.
Exemples
L'exemple suivant retourne false pour les valeurs de la zone productCode qui commencent par S18 :
L'exemple suivant retourne false pour les valeurs productName qui contiennent la sous-chaîne Ford précédée d'un seul caractère :