Función CharNextA (winuser.h)

Recupera un puntero al siguiente carácter de una cadena. Esta función puede controlar cadenas que constan de caracteres de un solo o varios bytes.

Sintaxis

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

Parámetros

[in] lpsz

Tipo: LPCTSTR de

Carácter de una cadena terminada en null.

Valor devuelto

Tipo: LPTSTR de

El valor devuelto es un puntero al siguiente carácter de la cadena, o al carácter nulo de terminación si está al final de la cadena.

Si lpsz apunta al carácter nulo de terminación, el valor devuelto es igual a lpsz.

Observaciones

Cuando se llama como función ANSI, CharNext usa la página de códigos predeterminada del sistema, mientras que charNextExA especifica una página de códigos que se va a usar.

Esta función funciona con expectativas de "usuario" predeterminadas de caracteres al tratar con diacríticos. Por ejemplo: una cadena que contiene U+0061 U+030a "LATIN SMALL LETTER A" + COMBINING RING ABOVE", que parece "å", avanzará dos puntos de código, no uno. Una cadena que contiene U+0061 U+0301 U+0302 U+0303 U+0304, que parece "a'^~ Centrándose", avanzará cinco puntos de código, no uno, etc.

Nota

El encabezado winuser.h define CharNext como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll

Consulte también

CharNextExA

charPrev de

conceptual de

de referencia de

cadenas de