Función StrToIntExW (shlwapi.h)

  • Artículo

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

Sintaxis

BOOL StrToIntExW(
  [in]  PCWSTR     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 valores siguientes 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 valor 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 que se pierden.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si la cadena se convierte; en caso contrario , FALSE.

Comentarios

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

  • Este formulario se acepta como un valor decimal en 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, dado que 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 4.71 o posterior)