wsprintfA, fonction (winuser.h)
Écrit les données mises en forme dans la mémoire tampon spécifiée. Tous les arguments sont convertis et copiés dans la mémoire tampon de sortie conformément à la spécification de format correspondante dans la chaîne de format. La fonction ajoute un caractère null de fin aux caractères qu’elle écrit, mais la valeur de retour n’inclut pas le caractère null de fin dans son nombre de caractères.
Syntaxe
int WINAPIV wsprintfA(
[out] LPSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
...
);
Paramètres
[out] unnamedParam1
Type : LPTSTR
Mémoire tampon qui doit recevoir la sortie mise en forme. La taille maximale de la mémoire tampon est de 1 024 octets.
[in] unnamedParam2
Type : LPCTSTR
Spécifications de contrôle de format. En plus des caractères ASCII ordinaires, une spécification de format pour chaque argument apparaît dans cette chaîne. Pour plus d’informations sur la spécification du format, consultez la section Remarques.
...
Un ou plusieurs arguments facultatifs. Le nombre et le type des paramètres d’argument dépendent des spécifications de contrôle de format correspondantes dans le paramètre lpFmt .
Valeur retournée
Type : int
Si la fonction réussit, la valeur de retour correspond au nombre de caractères stockés dans la mémoire tampon de sortie, sans compter le caractère null de fin.
Si la fonction échoue, la valeur de retour est inférieure à la longueur de la sortie attendue. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La chaîne de contrôle de format contient des spécifications de format qui déterminent le format de sortie des arguments suivant le paramètre lpFmt . Les spécifications de format, décrites ci-dessous, commencent toujours par un signe de pourcentage (%). Si un signe de pourcentage est suivi d’un caractère qui n’a aucune signification en tant que champ de format, le caractère n’est pas mis en forme (par exemple, %% produit un caractère de signe de pourcentage unique).
La chaîne de contrôle de format est lue de gauche à droite. Lorsque la première spécification de format (le cas échéant) est rencontrée, la valeur du premier argument après la chaîne de contrôle de format est convertie et copiée dans la mémoire tampon de sortie en fonction de la spécification de format. La deuxième spécification de format entraîne la conversion et la copie du deuxième argument, et ainsi de suite. S’il y a plus d’arguments que de spécifications de format, les arguments supplémentaires sont ignorés. S’il n’y a pas suffisamment d’arguments pour toutes les spécifications de format, les résultats ne sont pas définis.
Une spécification de format se présente sous la forme suivante :
%[-][#][0][width][.precision]type
Chaque champ est un caractère unique ou un nombre qui signifie une option de format particulière. Les caractères de type qui apparaissent après le dernier champ de format facultatif déterminent si l’argument associé est interprété comme un caractère, une chaîne ou un nombre. La spécification de format la plus simple contient uniquement le signe de pourcentage et un caractère de type (par exemple, %s). Les champs facultatifs contrôlent d’autres aspects de la mise en forme. Voici les champs facultatifs et obligatoires et leurs significations.
Notes
L’en-tête winuser.h définit wsprintf en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winuser.h (inclure Windows.h) |
Bibliothèque | User32.lib |
DLL | User32.dll |
Voir aussi
Conceptuel
Référence
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour