130

C++11 added some new string conversion functions:

http://en.cppreference.com/w/cpp/string/basic_string/stoul

It includes stoi (string to int), stol (string to long), stoll (string to long long), stoul (string to unsigned long), stoull (string to unsigned long long). Notable in its absence is a stou (string to unsigned) function. Is there some reason it is not needed but all of the others are?

related: No "sto{short, unsigned short}" functions in C++11?

10
  • 7
    My question was intended to be more along the lines of "is there some non-obvious drawback of just using stoul". Obviously that will mess with template instantiation, but is there anything else that I'm not considering? Comments on why it was left out would be nice but secondary. Commented Jan 3, 2012 at 16:30
  • 20
    @NicolBolas I cannot see why this is not constructive. It is a perfectly valid question as I cannot see any reason for this inconsistency and anwers may give insights into some possibly existing valid but not that obvious reason for it. Commented Jan 3, 2012 at 16:33
  • 6
    @SethCarnegie Well, what your platform (and maybe the majority of platforms) does is just irrelevant, because an unsigned long just is no unsigned int. Commented Jan 3, 2012 at 16:35
  • 6
    @SethCarnegie: on my typical computer, unsigned long is 64 bits, and unsigned int 32. They are different types, and can't be assumed to be the same as each other. Commented Jan 3, 2012 at 16:35
  • 3
    @NicolBolas Like said, the OP (and me) doesn't know it is speculative, as there could just be a perfect valid reason for it burried deep in the language internals of C++. But since you say it's speculative I guess there is no such reason. But again, maybe a C++11-responsible person can still answer it. This is no "Wah wah, where is that damn stou"-question, but a question asking for a possibly definite reason for this obvious inconsistency. If you know there is no such reason, then well, post it as an answer. Commented Jan 3, 2012 at 16:39

3 Answers 3

42

The most pat answer would be that the C library has no corresponding “strtou”, and the C++11 string functions are all just thinly veiled wrappers around the C library functions: The std::sto* functions mirror strto*, and the std::to_string functions use sprintf.


Edit: As KennyTM points out, both stoi and stol use strtol as the underlying conversion function, but it is still mysterious why while there exists stoul that uses strtoul, there is no corresponding stou.

12
  • 19
    Do you know why the C++ Committee decided to go for such a C-ish approach? Something like boost::lexical_cast<>() seems like a more C++ way of doing things.
    – Paul Manta
    Commented Jan 3, 2012 at 17:27
  • 4
    @LightnessRacesinOrbit: For sto*, C++11 21.5/1: Effects: the first two functions call strtol(str.c_str(), ptr, base), and the last three functions call strtoul(str.c_str(), ptr, base), strtoll(str.c_str(), ptr, base), and strtoull(str.c_str(), ptr, base), respectively. Commented Jan 3, 2012 at 17:53
  • 15
    It doesn't matter whether the C++ standard says "must be implemented by calling ...", because the C++ standard still has the global as-if rule: if the standard says std::sto* must be implemented as wrappers for the C library functions, and a valid program cannot tell that they aren't secretly implemented differently, the implementation is valid.
    – user743382
    Commented Jan 3, 2012 at 18:12
  • 3
    Completely off-topic, I think the practical reasons for not using iostreams like Boost/lexical_cast does is sheer performance; I believe iostreams lose out against strtoul etc. by a considerable margin.
    – Kerrek SB
    Commented Jan 3, 2012 at 18:31
  • 3
    Well, I believe boost::lexical_cast is specialized for maximum performance for various types, and thus almost always has better performance than other methods: boost.org/doc/libs/release/doc/html/boost_lexical_cast/… Commented Aug 5, 2012 at 14:46
28

I've no idea why stoi exists but not stou, but the only difference between stoul and a hypothetical stou would be a check that the result is in the range of unsigned:

unsigned stou(std::string const & str, size_t * idx = 0, int base = 10) {
    unsigned long result = std::stoul(str, idx, base);
    if (result > std::numeric_limits<unsigned>::max()) {
        throw std::out_of_range("stou");
    }
    return result;
}

(Likewise, stoi is also similar to stol, just with a different range check; but since it already exists, there's no need to worry about exactly how to implement it.)

2
  • The difference between stoi and stol, or stol and stoll is also only a range check.
    – Hossein
    Commented Jan 3, 2012 at 17:30
  • 1
    @Hossein: Between stoi and stol, yes. But stol and stoll do not differ only in range check, they call different library functions.
    – Ben Voigt
    Commented Jul 5, 2014 at 20:59
0
unsigned long ulval = std::stoul(buf);
unsigned long mask = ~0xffffffffl;
unsigned int uival;
if( (ulval & mask) == 0 )
    uival = (unsigned int)ulval;
else {
    ...range error...
}

Using masks to do this with the expected value size in bits expressed in the mask, will make this work for 64-bit longs vs 32-bit ints, but also for 32-bit longs vs 32-bit ints.

In the case of 64-bit longs, ~0xffffffffl will become 0xffffffff00000000 and will thus see if any of the top 32 bits are set. With 32-bit longs, it ~0xffffffffl becomes 0x00000000 and the mask check will always be zero.

1
  • 1
    If buf is "0", this will assume a range error occurred.
    – Chris
    Commented Feb 28, 2022 at 2:29

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.