warning
Afficher un message d'avertissement.
📝Syntaxe
warning()
warning(msg)
warning(id, msg)
warning(state)
warning(state, id)
st = warning()
warning(st)
📥Arguments d'entrée
Paramètre Description
id une chaîne : identifiant pour l'avertissement.
msg une chaîne : message d'avertissement.
state une chaîne : 'on', 'off', 'aserror', 'all' ou 'query'.
st une structure : définir les paramètres d'avertissement.
📤Arguments de sortie
Paramètre Description
st une structure : paramètres d'avertissement.
📄Description

warning affiche un message d'avertissement.

warning(' ') réinitialise l'état de lastwarn.

Lors d'un appel warning(id, msg, ...) ou warning(state, id), l'identifiant s'écrit composant:mnémonique, avec un ou plusieurs champs composants suivis d'un mnémonique, chaque champ commençant par une lettre et ne contenant que des lettres, des chiffres ou des tirets bas, séparés par des deux-points (exemple : 'Nelson:io:fileNotFound'). Les avertissements levés par Nelson utilisent Nelson comme premier composant ; dans votre propre code, utilisez un composant de votre choix (par exemple le nom de votre module).

Quelques règles gardent les identifiants utiles : le composant devrait pointer vers la zone qui lève l'avertissement et le mnémonique devrait nommer le cas précis en camelCase ; un identifiant court à deux champs suffit pour les cas qui peuvent survenir partout ; donnez à un identifiant un seul texte de message (un identifiant réutilisé avec plusieurs messages différents ne peut pas être traduit) ; et réutilisez un identifiant existant pour le même cas plutôt qu'un quasi-doublon. L'identifiant est aussi ce que warning('off', id) et warning('on', id) activent ou désactivent, donc un identifiant stable permet aux utilisateurs de contrôler l'avertissement.

💡Exemples
warning('your warning message.')
warning('on', 'myModule:identifier');
warning('myModule:identifier', 'my message 1 on');
warning('off', 'myModule:identifier');
warning('myModule:identifier', 'my message 2 off');
warning('aserror', 'myModule:identifier');
warning('myModule:identifier', 'my message 3 as error');
🔗Voir aussi
lasterrorerrorlastwarn
🕔Historique des versions
Version Description
1.0.0 version initiale
Modifier cette page sur GitHub