C++ Are std::any and std::optional , “driving you up the wall” ?

Driving up the wall. No C++
Driving up the wall. No C++involved.

Well, they were, but not any more. Here is what I have realized since.


Is much more “normal” and usable of the two.  It is actually very nice and useful single instance standard & compliant kind-of-a container. And most importantly

You do not need to keep the type of T to use std::optional

That is the primary students confusion with optional. The value() method and the std::bad_optional_access lurking inside it.

Seeing something like above, a lot of C++ students, have been wondering what is the real worth of using std:: optional, at all.

Let me try and explain step by step

First the basics.

In other words, we must have the complete T, at the moment of ‘marriage, with optional<T> :

Type T, must be available at the moment of creation of optional<T>

The fact we have optional<T> instantiated with some type T, means there is a type ‘T’, declared and defined “somewhere” in the same program, but crucially in the same scope. And it has to exist in the same scope as its user aka optional<T> exists, at the moment of ‘marriage’ :

to fix that we must introduce T into the scope:

For each declared optional<T>, If the compile-time environment has both T and  std::optional<T> in the same scope at the point of declaration we will have no problems whatsoever.  Same applies for the usage of the instance of the particular defined optional type.

Above must compile and work as long as there is type T in the same scope as there was when the optional<T>  template was defined  with concrete type, in this case optional<int> .

And of course, with the auto keyword we do not have to know type the type T in advance.  Which is a rather big deal. Without auto one would need a separate version of magical_function , for each type T inside optional<T>.

The tool

For what it’s worth, I will give you one simple but very useful little utility, I am using always with optional’s.

With above I do not have to worry about (and code around ) the issue of ’empty’ optional’s.  Namely freshly minted optional will throw the exception if you ask it for a value and it has none yet. Behind that link, you will find an example on how to code around this. But who wants to retype this each time value is needed from optional.

In contrast to that, in my API, by design, the fallback value is default constructed type T. If user does not provide one.

Very comfortable “minuscule” API one might say.

No exception thrown. Especially welcome attribute in the embedded programming world.

The drawback is,  T has to have a default constructor. In C++ parlance it has to be trivially constructible.  We could stop that wrong usage at compile time, but that is out of scope of this article named primarily for C++ students.

Why not just using std::optional<T> dereference?

Allow me to simple copy/paste good explanation from here.

Let us recap and explain step by step. std::optional represents a value that may or may not be present, often replacing magic sentinel values (such as -1 or nullptr). It offers methods such as value(), which extract the T it contains and raises an exception if the the optional is empty. However, it also defines operator* and operator->. These methods also provide access to the underlying T, however

They do not check if the optional actually contains a value or not.

The following code for example, simply returns an uninitialized value:

If you use std::optional as a replacement for nullptr this can produce even more serious issues! Dereferencing a nullptr gives a segfault (which is not a security issue, except in older kernels). Dereferencing a nullopt however, gives you an uninitialized value as a pointer, which can be a serious security issue. While having a T* with an uninitialized value is also possible, these are much less common than dereferencing a pointer that was correctly initialized to nullptr.

And no, this doesn’t require you to be using raw pointers. You can get uninitialized/wild pointers with smart pointers as well:

End of copy/paste. Phew, thanks god my optival is not using the dereferencing operator at all.

And finally.

The std::any

Is the troubled kid on the standard C++ block. Quite a few authors have tried to articulate the reason of it’s existence.  I personally can perhaps see its value in one and a half, situations.

First (the half) is where you have a limited number of types to pass internally using std::any.  And this is how you code around getting the value from std::any :

That is ugly as hell.  Not feasible for more than a handful of possible types your design will define. But then one must ask why not just using the union.  Sigh.

The second and last, and I think the only reasonable situation I can imagine is using std::any for serialization/de-serialization . I.e for sending object’s “over a wire”, through messaging middle-ware, for storing uniformly into the database and a such.

As you might imagine the above SQLite scenario is far from simple. Very few teams or individuals spend their afternoons trying to write persistent objects management, in C++, when there is few very mature libraries for that, some even decades old and in widespread use.

Assuming we are all convinced we found a use case that might spare std::any from deprecation here is how I might use it.

I have to say, I do not use std::any, at the moment. I simply use optional<T>. But here is one little utility that makes using std::any much more bearable.

Just any hack

Let’s dive in head first, worry later, what can possibly go wrong?

The intent:  Have one function that returns two things,  std::pair :

  1. std::any  with the value inside
  2. proxy function returning the value, crucially with this original type.

This little number, does make std::any easier to handle or simply more palatable. This construct keeps std::any and its value type together.

Usage is simple:

One can now use the any for what any is usually useful for.

This certainly works , as long as you keep that pair returned,  thus making std::any use cases much easier to code.

This might appear trivial but it is not. That pair does not have to be deconstructed upon return.  It can be copied or moved around, while holding its load.

std::any is holding a memory block representing whatever it is given to keep.  Thus it can swap in/out that block while it has to move in and out of functions.

Now imagine the payload is not trivial. Just keep that pair.