std::stoi, std::stol, std::stoll

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de cadenas

Cadenas terminadas en nulo

Cadenas de bytes

Cadenas multibyte

De caracteres anchos

Clases

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Funciones miembro basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Acceso a elementos basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) Iteradores basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Capacidad basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Operaciones basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Búsqueda basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constantes basic_string::npos

Funciones no miembro operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) E/S operator<<operator>> getline Comparación operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20) Conversión numérica (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring Clases auxiliares hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) Guías de deducción(C++17)

 

Definido en el archivo de encabezado <string>
int       stoi(conststd::string& str, std::size_t* pos =0, int base =10); int       stoi(conststd::wstring& str, std::size_t* pos =0, int base =10);	(1)	(desde C++11)
long      stol(conststd::string& str, std::size_t* pos =0, int base =10); long      stol(conststd::wstring& str, std::size_t* pos =0, int base =10);	(2)	(desde C++11)
longlong stoll(conststd::string& str, std::size_t* pos =0, int base =10); longlong stoll(conststd::wstring& str, std::size_t* pos =0, int base =10);	(3)	(desde C++11)

Interpreta un valor entero con signo en la cadena str.

1) Llama a std::strtol(str.c_str(), &ptr, base) o std::wcstol(str.c_str(), &ptr, base)

2) Llama a std::strtol(str.c_str(), &ptr, base) o std::wcstol(str.c_str(), &ptr, base)

3) Llama a std::strtoll(str.c_str(), &ptr, base) o std::wcstoll(str.c_str(), &ptr, base)

La función descarta cualquier carácter en blanco hasta que se encuentra el primer carácter que no es carácter en blanco. Entonces toma tantos caracteres como sea posible para formar una representación válida de número entero de base-n (donde n=base) y los convierte a un valor entero . El valor entero válido consiste en las siguientes partes:

• (opcional) Signo más (+) o menos (-)
• (opcional) Prefijo (0) que indica la base octal (se aplica cuando la base es 8)
• (opcional) Prefijo (0x o 0X) que indica la base hexadecimal (se aplica cuando la base es 16)
• Una secuencia de dígitos

El conjunto de valores válidos para base es {0,2,3,...,36}. El conjunto de dígitos válidos para enteros de base 2 es 01, para enteros de base 3 es 012, y así sucesivamente. Para bases mayores que 10, los dígitos válidos incluyen caracteres alfabéticos, empezando desde Aa para enteros de base 11, hasta Zz para enteros de base 36. Los caracteres alfabéticos pueden ser minúsculas o mayúsculas.

Pueden aceptarse formatos numéricos adicionales por la configuración regional de C actualmente instalada.

Si el valor de base es ​0​, la base numérica se detecta automáticamente: si el prefijo es 0, la base es octal, si el prefijo es 0x o 0X, la base es hexadecimal, de lo contrario la base es decimal.

Si el signo menos era parte de la secuencia de entrada, el valor numérico calculado a partir de la secuencia de dígitos se niega como si lo fuera por el menos unario en el tipo del resultado

Si pos no es un puntero nulo, entonces un puntero ptr, interno a las funciones de conversión, recibirá la dirección del primer carácter no convertido en str.c_str(), y el índice de ese carácter se calculará y almacenará en *pos, dando el número de caracteres que fueron procesados por la conversión.

El índice del carácter no convertido se almacena primero en pos. Si NULL se pasa como pos, se omite .

Original:

The index of the first unconverted character is stored in pos. If NULL is passed as pos, it is ignored.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parámetros

str	-	La cadena a convertir.
pos	-	Dirección de un número entero para almacenar el número de caracteres procesados.
base	-	La base numérica.

Valor de retorno

Valor entero que corresponde al contenido de str.

Excepciones

• std::invalid_argument si la conversión no se pudo realizar.
• std::out_of_range si el valor convertido caería fuera del rango del tipo del resultado.

Ejemplo

Ejecuta este código

#include <iostream>#include <string>   int main(){std::string str1 ="45";std::string str2 ="3.14159";std::string str3 ="31337 con palabras";std::string str4 ="palabras y 2";   int myint1 = std::stoi(str1);int myint2 = std::stoi(str2);int myint3 = std::stoi(str3);// ERROR: 'std::invalid_argument'// int myint4 = std::stoi(str4);   std::cout<<"std::stoi(\""<< str1 <<"\") es "<< myint1 <<'\n';std::cout<<"std::stoi(\""<< str2 <<"\") es "<< myint2 <<'\n';std::cout<<"std::stoi(\""<< str3 <<"\") es "<< myint3 <<'\n';//std::cout << "std::stoi(\"" << str4 << "\") es " << myint4 << '\n';}

Salida:

std::stoi("45") es 45 std::stoi("3.14159") es 3 std::stoi("31337 con palabras") es 31337

Véase también

atoiatolatoll (C++11)	Convierte una cadena de bytes en un valor entero. (función)
stoulstoull (C++11)(C++11)	Convierte una cadena a un entero sin signo (función)
stofstodstold (C++11)(C++11)(C++11)	Convierte una cadena en un valor de punto flotante (función)
to_string (C++11)	Convierte un valor de punto flotante o entero a una cadena string. (función)
from_chars (C++17)	Convierte una secuencia de caracteres a un valor entero o de punto flotante (función)