funzione wsprintfA (winuser.h)
Scrive i dati formattati nel buffer specificato. Tutti gli argomenti vengono convertiti e copiati nel buffer di output in base alla specifica di formato corrispondente nella stringa di formato. La funzione aggiunge un carattere null terminante ai caratteri scritti, ma il valore restituito non include il carattere Null terminante nel numero di caratteri.
Sintassi
int WINAPIV wsprintfA(
[out] LPSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
...
);
Parametri
[out] unnamedParam1
Tipo: LPTSTR
Buffer che deve ricevere l'output formattato. La dimensione massima del buffer è di 1.024 byte.
[in] unnamedParam2
Tipo: LPCTSTR
Specifiche del controllo del formato. Oltre ai caratteri ASCII normali, viene visualizzata una specifica di formato per ogni argomento in questa stringa. Per altre informazioni sulla specifica del formato, vedere la sezione Osservazioni.
...
Uno o più argomenti facoltativi. Il numero e il tipo di parametri di argomento dipendono dalle specifiche del controllo formato corrispondenti nel parametro lpFmt .
Valore restituito
Tipo: int
Se la funzione ha esito positivo, il valore restituito è il numero di caratteri archiviati nel buffer di output, senza contare il carattere null terminante.
Se la funzione ha esito negativo, il valore restituito è minore della lunghezza dell'output previsto. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La stringa di controllo formato contiene specifiche di formato che determinano il formato di output per gli argomenti che seguono il parametro lpFmt . Le specifiche di formato, illustrate di seguito, iniziano sempre con un segno percentuale (%). Se un segno percentuale viene seguito da un carattere che non ha alcun significato come campo di formato, il carattere non viene formattato (ad esempio, %% produce un carattere di segno percentuale singolo).
La stringa di controllo del formato viene letto da sinistra a destra. Quando viene rilevata la prima specifica di formato (se presente), il valore del primo argomento dopo la conversione e la copia della stringa di controllo formato nel buffer di output in base alla specifica del formato. La seconda specifica di formato causa la conversione e la copia del secondo argomento e così via. Se sono presenti più argomenti rispetto alle specifiche di formato, gli argomenti aggiuntivi vengono ignorati. Se non sono presenti argomenti sufficienti per tutte le specifiche di formato, i risultati non sono definiti.
Una specifica di formato presenta la forma seguente:
%[-][][#0][width][.precision]type
Ogni campo è un singolo carattere o un numero che indica un'opzione di formato specifica. I caratteri di tipo visualizzati dopo l'ultimo campo di formato facoltativo determinano se l'argomento associato viene interpretato come carattere, una stringa o un numero. La specifica di formato più semplice contiene solo il segno percentuale e un carattere di tipo ,ad esempio %s. I campi facoltativi controllano altri aspetti della formattazione. Di seguito sono riportati i campi facoltativi e obbligatori e i relativi significati.
Nota
L'intestazione winuser.h definisce wsprintf come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | winuser.h (include Windows.h) |
Libreria | User32.lib |
DLL | User32.dll |
Vedi anche
Informazioni concettuali
Riferimento
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per