Compartir a través de


Función StrToIntA (shlwapi.h)

Convierte una cadena que representa un valor decimal en un entero. La macro StrToLong es idéntica a esta función.

Sintaxis

int StrToIntA(
  [in] PCSTR pszSrc
);

Parámetros

[in] pszSrc

Tipo: PCTSTR

Puntero a la cadena terminada en null que se va a convertir. Una cadena válida que representa un valor decimal contiene solo los caracteres 0-9 y debe tener el siguiente formulario para analizarse correctamente.

(optional white space)(optional sign)(one or more decimal digits)

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

Valor devuelto

Tipo: int

Devuelve el valor int representado por pszSrc. Por ejemplo, la cadena "123" devuelve el valor entero 123.

Observaciones

Si la cadena a la que apunta pszSrc 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 decimal no válida "12b34", StrToInt solo reconoce "12" y devuelve ese valor entero.

Nota

El encabezado shlwapi.h define StrToInt 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)

Consulte también

StrToIntEx