Funzione IsDBCSLeadByte (winnls.h)

  • Articolo

Determina se un carattere specificato è un byte lead per la tabella codici ANSI di Windows predefinita del sistema (CP_ACP). Un byte iniziale è il primo byte di un carattere a due byte in un set di caratteri a byte doppio (DBCS) per la tabella codici.

Nota Per usare una tabella codici diversa, l'applicazione deve usare la funzione IsDBCSLeadByteEx .
 

Sintassi

BOOL IsDBCSLeadByte(
  [in] BYTE TestChar
);

Parametri

[in] TestChar

Carattere da testare.

Valore restituito

Restituisce un valore diverso da zero se il carattere di test è potenzialmente un byte di lead. La funzione restituisce 0 se il carattere di test non è un byte iniziale o se è un carattere a byte singolo. Per ottenere informazioni sull'errore estese, l'applicazione può chiamare GetLastError.

Commenti

Nota Questa funzione non convalida la presenza o la validità di un byte trail. Pertanto, MultiByteToWideChar potrebbe non riconoscere una sequenza che l'applicazione che usa IsDBCSLeadByte segnala come byte lead. L'applicazione può diventare facilmente non sincronizzata con i risultati di MultiByteToWideChar, causando potenzialmente errori imprevisti o mancate corrispondenze delle dimensioni del buffer.
 
In generale, invece di tentare una manipolazione di basso livello dei dati della tabella codici, le applicazioni devono usare MultiByteToWideChar per convertire i dati in UTF-16 e usarli in tale codifica.

I valori dei byte lead sono specifici di ogni DBCS distinto. Alcuni valori di byte possono essere visualizzati in una singola tabella codici come byte iniziale e finale di un carattere DBCS.

Per avere un senso di una stringa DBCS, un'applicazione inizia normalmente all'inizio di una stringa e analizza in avanti, tenendo traccia quando rileva un byte di lead e considerando il byte successivo come parte finale dello stesso carattere. Se l'applicazione deve eseguire il backup, deve usare CharPrev anziché tentare di sviluppare il proprio algoritmo.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione winnls.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

IsDBCSLeadByteEx

MultiByteToWideChar

Funzioni unicode e set di caratteri

Set di caratteri e Unicode