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)

📥 Argument d'entrée

• 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).

📤 Argument de sortie

• 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

Version	📄 Description
1.0.0	version initiale