cpp/string/basic string/stol

Interprets a signed integer value in the string.

Let be an internal (to the conversion functions) pointer of type   or , accordingly.

@1@ Calls. @2@ Calls. @3@ Calls. @4@ Calls. @5@ Calls. @6@ Calls.

If is not a null pointer, then the pointer  will receive an address of the first unconverted character in, and the index of that character will be calculated and stored in , giving the number of characters that were processed by the conversion.

Return value
Integer value corresponding to the content of str.

Exceptions

 * std if no conversion could be performed.
 * std if the converted value would fall out of the range of the result type or if the underlying function ( or ) sets errno to erange.