Función StrToIntExA (shlwapi.h)

Artículo
11/20/2024

Convierte una cadena que representa un número decimal o hexadecimal en un entero.

Sintaxis

BOOL StrToIntExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

Parámetros

[in] pszString

Tipo: PCTSTR

Puntero a la cadena terminada en null que se va a convertir. Para obtener más información sobre las formas válidas de la cadena, vea la sección Comentarios.

dwFlags

Tipo: STIF_FLAGS

Uno de los siguientes valores que especifican cómo se debe analizar pszString para su conversión a un entero.

STIF_DEFAULT

La cadena de pszString contiene la representación de un valor decimal.

STIF_SUPPORT_HEX

La cadena de pszString contiene la representación de un valor decimal o hexadecimal. Tenga en cuenta que, en representaciones hexadecimales, los caracteres A-F no distinguen mayúsculas de minúsculas.

[out] piRet

Tipo: int*

Puntero a un int que recibe la cadena convertida. Por ejemplo, en el caso de la cadena "123", el entero al que apunta este valor recibe el valor entero 123.

Si esta función devuelve FALSE, este valor no está definido.

Si el valor devuelto es demasiado grande para estar contenido en una variable de tipo int, este parámetro contiene los 32 bits de orden bajo del valor. Los bits de orden superior más allá de los que se pierden.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se convierte la cadena; De lo contrario, FALSE.

Observaciones

La cadena a la que apunta el parámetro pszString debe tener uno de los siguientes formularios para que se analicen correctamente.

Este formulario se acepta como un valor decimal bajo cualquiera de las marcas. Sintaxis ''' (espacio en blanco opcional)(signo opcional)(uno o varios dígitos decimales) '''
Estos formularios son necesarios para los valores hexadecimales cuando se pasa la marca STIF_SUPPORT_HEX. Sintaxis ''' (espacio en blanco opcional)(signo opcional)0x(uno o varios dígitos hexadecimales) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

El signo opcional puede ser el carácter '-' o '+'; si se omite, se supone que el signo es positivo.

Nota Si el valor se analiza como hexadecimal, se omite el signo opcional, aunque sea un carácter "-". Por ejemplo, la cadena "-0x1" se analiza como 1 en lugar de -1.

Si la cadena a la que apunta pszString contiene un carácter no válido, ese carácter se considera el final de la cadena que se va a convertir y se omite el resto. Por ejemplo, dada la cadena hexadecimal no válida "0x00am123", StrToIntEx solo reconoce "0x00a", la convierte en el valor entero 10 y devuelve TRUE.

Nota

El encabezado shlwapi.h define StrToIntEx 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, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)

Compartir a través de