# assert\_isequal

Vérifie que les valeurs calculées et attendues sont égales.

## 📝 Syntaxe

* assert\_isequal(computed, expected)
* res = assert\_isequal(computed, expected)
* \[res, msg] = assert\_isequal(computed, expected)

## 📥 Argument d'entrée

* computed - une valeur de n'importe quel type à tester pour l'égalité.
* expected - une valeur de n'importe quel type représentant le résultat attendu.

## 📤 Argument de sortie

* res - une valeur logique : true si les valeurs sont égales, false sinon.
* msg - une chaîne contenant le message d'erreur. Si res == true, alors msg == ''. Si res == false, alors msg contient le message d'échec de l'assertion.

## 📄 Description

assert\_isequal lève une erreur si la valeur calculée n'est pas égale à la valeur attendue.

Cette fonction effectue un test d'égalité stricte qui vérifie le même type, les mêmes dimensions et les mêmes valeurs. Elle utilise la même logique que la fonction isequaln.

Contrairement aux opérateurs d'égalité standards, cette fonction gère correctement les valeurs NaN, en les considérant égales lorsque les deux valeurs contiennent NaN aux mêmes positions.

Cette fonction est essentielle pour les tests unitaires afin de vérifier que les résultats calculés correspondent exactement aux résultats attendus.

## Fonction(s) utilisée(s)

isequaln

## 📚 Bibliographie

"Automated Software Testing for Matlab", Steven Eddins, 2009

## 💡 Exemples

Test d'égalité de matrices identiques :

```matlab
A = eye(3, 3);
assert_isequal(A, A)
```

Test qui démontre la détection de différence de type :

```matlab
A = eye(3, 3);
B = single(A);
try
    assert_isequal(A, B)
catch ME
    disp(['Error: ' ME.message])
end
```

Test de gestion de l'égalité avec NaN :

```matlab
A = NaN;
B = A;
assert_isequal(A, B)
```

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

```matlab
[res, msg] = assert_isequal([1, 2, 3], [1, 2, 4]);
if res
    disp('Values are equal')
else
    disp(['Values are not equal: ' msg])
end
```

## 🔗 Voir aussi

[isequaln](https://nelson-9.gitbook.io/nelson/markdown/fr/elementary_functions/isequaln), [assert\_isapprox](https://nelson-9.gitbook.io/nelson/markdown/fr/assert_functions/assert_isapprox), [assert\_istrue](https://nelson-9.gitbook.io/nelson/markdown/fr/assert_functions/assert_istrue), [assert\_isfalse](https://nelson-9.gitbook.io/nelson/markdown/fr/assert_functions/assert_isfalse).

## 🕔 Historique

| Version | 📄 Description   |
| ------- | ---------------- |
| 1.0.0   | version initiale |
