assert_istrue

Vérifie que la condition est vraie.

📝Syntaxe

assert_istrue(x)
r = assert_istrue(x)
[r, msg] = assert_istrue(x)
assert_istrue(x, err_msg)
r = assert_istrue(x, err_msg)
[r, msg] = assert_istrue(x, err_msg)

📥Arguments d'entrée

Paramètre	Description
x	une valeur logique à tester pour la véracité.
err_msg	une chaîne contenant le message d'erreur personnalisé à afficher en cas d'échec de l'assertion (optionnel).

📤Arguments de sortie

Paramètre	Description
r	une valeur logique : true si l'assertion réussit, false sinon.
msg	une chaîne contenant le message d'erreur. Si x == true, alors msg == ''. Si x == false, alors msg contient le message d'échec de l'assertion.

📄Description

assert_istrue lève une erreur si la valeur d'entrée est fausse.

Cette fonction lève également une erreur si l'entrée n'est pas une valeur logique, garantissant la sécurité de type.

Lorsque le paramètre optionnel err_msg est fourni, il sera utilisé comme message d'erreur à la place du message par défaut en cas d'échec de l'assertion.

Cette fonction est essentielle dans les tests unitaires pour vérifier que des conditions sont vraies ou que des opérations logiques retournent le résultat vrai attendu.

💡Exemples

Test qui réussit (3 égal 3 est vrai) :

assert_istrue(3 == 3)

Test qui démontre l'échec de l'assertion (3 égal 4 est faux) :

try
    assert_istrue(3 == 4)
catch ME
    disp(['Error: ' ME.message])
end

Test avec une valeur fausse explicite pour montrer l'échec :

r = assert_istrue(false)

Utilisation des valeurs de retour pour gérer les résultats d'assertion :

[r, msg] = assert_istrue(false)

Test avec un message d'erreur personnalisé :

[r, msg] = assert_istrue(3 == 4, 'your error message.');
if ~r
    disp(['Custom error: ' msg])
end

Exemple montrant une assertion réussie avec une valeur vraie :

assert_istrue(true);
disp('Assertion passed!')

🔗Voir aussi

assert_isfalse assert_checkerror assert_isequal

🕔Historique des versions

Version	Description
1.0.0	version initiale

Modifier cette page sur GitHub