warning()
warning(msg)
warning(id, msg)
warning(state)
warning(state, id)
st = warning()
warning(st)
| 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. |
| Paramètre | Description |
|---|---|
| st | une structure : paramètres d'avertissement. |
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.
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');
| Version | Description |
|---|---|
| 1.0.0 | version initiale |