HOWTO · MATLAB
Renvoyer plusieurs valeurs à partir d'une fonction Matlab
Dans MATLAB, une fonction peut déclarer plusieurs sorties entre crochets. L’appelant peut ne récupérer que celles dont il a besoin, ou regrouper les valeurs dans une structure ou un tableau de cellules.
Sur cette page
Une fonction MATLAB peut renvoyer plusieurs sorties distinctes lors d’un même appel. Elle déclare les variables de sortie dans sa signature, attribue une valeur à chacune dans son corps, et l’appelant reçoit les valeurs dans cet ordre. Lorsque celles-ci forment un enregistrement logique, renvoyez plutôt une structure ou un tableau de cellules : il s’agit d’une seule sortie contenant plusieurs champs ou éléments.
Comment les fonctions MATLAB renvoient plusieurs sorties
Dans la définition d’une fonction, les crochets indiquent les sorties distinctes, dans l’ordre. Par exemple, [sumValue, diffValue] déclare deux sorties. Elles ne sont pas regroupées dans un objet spécial de « retours multiples » : chaque sortie est une valeur ordinaire attribuée à la variable correspondante chez l’appelant. Si l’appelant demande une sortie, la fonction doit lui attribuer une valeur avant de se terminer.
Cette distinction compte pour choisir la manière d’appeler la fonction. L’appelant peut demander uniquement la première sortie ou en demander plusieurs. Il ne peut pas sauter une position en la laissant vide : utilisez ~ pour une position dont la valeur n’est pas nécessaire. Les structures et les tableaux de cellules fonctionnent autrement : la fonction renvoie une structure ou un tableau de cellules unique, puis l’appelant en sélectionne les champs ou les éléments.
Définir et appeler une fonction avec plusieurs sorties
La signature de la fonction nomme chaque sortie, et le corps attribue une valeur à chacune. Dans MATLAB, une fonction nommée peut prendre la forme function [sumValue, diffValue, productValue] = calculate(a, b). Cet exemple autonome en Octave utilise un handle de fonction anonyme avec deal pour exécuter l’appel à trois sorties dans un seul script tout en conservant le calcul d’origine.
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
calculate = @(a, b) deal(a + b, a - b, a * b);
[sumValue, diffValue, productValue] = calculate(5, 3);
printf("sum = %d\ndifference = %d\nproduct = %d\n", sumValue, diffValue, productValue);
sum = 8
difference = 2
product = 15
Le handle de fonction renvoie la somme, la différence et le produit dans cet ordre. L’appelant les associe à sumValue, diffValue et productValue dans le même ordre. Pour une fonction MATLAB autonome, enregistrez la fonction nommée dans un fichier portant le même nom qu’elle ; la syntaxe ci-dessus déclare explicitement ses trois variables de sortie.
Ne récupérer que les sorties nécessaires
Si une fonction renvoie [first, second, third], un appel qui attribue deux variables reçoit les deux premières sorties et ne demande pas la troisième. Pour conserver la troisième valeur tout en ignorant la deuxième, utilisez [first, ~, third] = functionName(inputs). Le tilde sert d’espace réservé à une position de sortie ; il ne modifie pas les calculs de la fonction.
Choisissez le nombre et les positions des sorties demandées en fonction de la tâche. Si vous n’avez besoin que d’un résultat et qu’il s’agit de la première sortie, attribuez une seule variable. Si vous avez besoin d’une sortie ultérieure, insérez des espaces réservés pour les positions précédentes. Si une valeur apparaît dans la mauvaise variable, vérifiez la déclaration : MATLAB associe les sorties selon leur position, et non selon les noms de variables choisis par l’appelant.
Regrouper des résultats liés dans une structure ou un tableau de cellules
Renvoyez une structure lorsque les résultats ont des noms significatifs ou représentent un seul enregistrement. Par exemple, une fonction peut attribuer result.total = a + b et result.count = 2, puis déclarer uniquement function result = summarize(a, b). L’appelant reçoit une valeur et lit summary.total ou summary.count. Les champs nommés rendent leur signification visible au moment de l’utilisation et permettent d’ajouter des champs liés sans élargir la signature d’appel à plusieurs sorties.
Un tableau de cellules constitue lui aussi une seule sortie. Il convient lorsque les éléments regroupés peuvent être de types différents ou sont naturellement accessibles par position. Une fonction peut construire items = {a + b, a - b, "computed"} et renvoyer items ; l’appelant accède au contenu d’un élément avec des accolades, par exemple result{1}. Comme les positions n’ont pas de noms descriptifs, documentez leur signification ou préférez une structure si les lecteurs doivent identifier chaque élément sans mémoriser un indice.
Ni une structure ni un tableau de cellules ne crée à lui seul plusieurs sorties de fonction. Dans ces exemples, la signature de la fonction comporte toujours une seule variable de sortie ; c’est la valeur renvoyée qui contient plusieurs éléments de données.
Choisir le bon modèle de sortie
Utilisez des sorties distinctes lorsque chaque résultat a un rôle prévisible et que les appelants ont souvent besoin de sous-ensembles différents, par exemple une valeur et son état. Leur ordre fait partie de l’interface de la fonction : gardez-le stable et documentez-le. Utilisez une structure lorsque les valeurs forment un enregistrement nommé, surtout si des noms de champs descriptifs rendent les appels plus faciles à comprendre. Utilisez un tableau de cellules lorsqu’une collection positionnelle est utile et que ses éléments peuvent être de types différents.
Choisissez en fonction de la manière dont les appelants utiliseront les données, sans supposer un avantage de vitesse. Si le nombre ou la signification des sorties varie selon le mode, envisagez une structure de forme cohérente plutôt que de laisser les appelants deviner ce que représente chaque position.
Erreurs courantes et dépannage
- Une sortie demandée n’a pas reçu de valeur : attribuez une valeur à chaque sortie que les appelants peuvent demander, sur tous les chemins d’exécution de la fonction.
- Les valeurs apparaissent dans les mauvaises variables : comparez l’ordre de la liste des sorties de la fonction à celui de la liste d’affectation de l’appelant ; les noms ne définissent aucune correspondance.
- L’appel demande trop de sorties : faites correspondre le nombre de sorties demandées à la définition de la fonction, ou mettez à jour ensemble la définition et ses appelants.
- Un résultat regroupé est traité comme une sortie distincte : une fonction qui renvoie
resulta une seule sortie. Utilisezresult.fieldpour une structure ouresult{index}pour un tableau de cellules. - Il faut demander une sortie intermédiaire inutile pour atteindre une sortie ultérieure : placez
~à cette position afin de conserver la position déclarée de la sortie suivante.
Pour déboguer, examinez ensemble la signature de la fonction, les affectations de ses sorties et le membre de gauche de l’appelant. Cela permet généralement de déterminer s’il manque une affectation, si le nombre de sorties ne correspond pas ou si l’ordre a été mal interprété.