Commande dspmsg

Objectif

Affiche un message sélectionné dans un catalogue de messages.

Syntaxe

dspmsg [ -s SetNumber ] CatalogName MessageNumber [ ' DefaultMessage ' [ Arguments ] ]

Descriptif

La commande dspmsg affiche le texte d'un message particulier d'un catalogue de messages généré à l'aide de la commande gencat ou, si le message ne peut pas être extrait, un message par défaut fourni en tant que paramètre de la commande. La commande dspmsg dirige le message vers la sortie standard. Cette commande est destinée à être utilisée dans les scripts shell en remplacement de la commande echo .

Remarque: La commande dspmsg recherche les fichiers de catalogue sous NLSPATH si LC_FASTMSG est défini sur False dans l'environnement local C ou POSIX .

LC__FASTMSG indique que les messages par défaut sont utilisés pour les environnements locaux C et POSIX et que NLSPATH est ignoré lorsque LC__FASTMSG est défini sur True.

La valeur par défaut de LC__FASTMSG est True dans /etc/environment.

La variable d'environnement NLSPATH et la catégorie LC_MESSAGES sont utilisées pour rechercher le catalogue de messages spécifié si aucun caractère / (barre oblique) n'est utilisé dans la valeur du paramètre CatalogName . Si le catalogue nommé par le paramètre CatalogName est introuvable ou si le message nommé par le paramètre MessageNumber (et la valeur facultative SetNumber ) est introuvable, la valeur DefaultMessage est affichée. Si aucune valeur DefaultMessage n'est spécifiée, un message d'erreur généré par le système s'affiche.

La commande dspmsg permet de remplacer jusqu'à dix arguments de chaîne dans le message s'il contient la spécification de conversion de sous-routine %s, %n, %ldou %n$ld printf . Les arguments manquants pour les spécifications de conversion génèrent un message d'erreur dspmsg . Les caractères d'échappement de contrôle de sous-routine printf normaux (par exemple, \n) sont reconnus.

L'utilisation de chaînes de format de sous-routine printf est recommandée dans le catalogue. Ce format permet l'insertion correcte des arguments même si les chaînes de format du message sont dans un ordre différent de celui du message par défaut. Vous devez placer le message par défaut entre apostrophes si vous utilisez la notation %n pour les insertions de message.

Indicateurs

Article Descriptif
-s SetNumber Indique un numéro d'ensemble facultatif. La valeur par défaut de la variable SetNumber est 1.

Exemples

Pour afficher le numéro d'ensemble 1, le message numéro 2 de latest.catcatalogue, entrez:

dspmsg    -s    1    test.cat    2    'message    %s    not    found'    2

Si le message est introuvable,message 2 not founds'affiche.

Fichiers

Article Descriptif
/usr/bin/dspmsg Contient la commande dspmsg .