When should I use C++14 automatic return type deduction?

[*]

C++11 raises similar questions: when to use return type deduction in lambdas, and when to use auto variables.

The traditional answer to the question in C and C++03 has been “across statement boundaries we make types explicit, within expressions they are usually implicit but we can make them explicit with casts”. C++11 and C++1y introduce type deduction tools so that you can leave out the type in new places.

Sorry, but you’re not going to solve this up front by making general rules. You need to look at particular code, and decide for yourself whether or not it aids readability to specify types all over the place: is it better for your code to say, “the type of this thing is X”, or is it better for your code to say, “the type of this thing is irrelevant to understanding this part of the code: the compiler needs to know and we could probably work it out but we don’t need to say it here”?

Since “readability” is not objectively defined[*], and furthermore it varies by reader, you have a responsibility as the author/editor of a piece of code that cannot be wholly satisfied by a style guide. Even to the extent that a style guide does specify norms, different people will prefer different norms and will tend to find anything unfamiliar to be “less readable”. So the readability of a particular proposed style rule can often only be judged in the context of the other style rules in place.

All of your scenarios (even the first) will find use for somebody’s coding style. Personally I find the second to be the most compelling use case, but even so I anticipate that it will depend on your documentation tools. It’s not very helpful to see documented that the return type of a function template is auto, whereas seeing it documented as decltype(t+u) creates a published interface you can (hopefully) rely on.

[*] Occasionally someone tries to make some objective measurements. To the small extent that anyone ever comes up with any statistically significant and generally-applicable results, they are completely ignored by working programmers, in favour of the author’s instincts of what is “readable”.

Leave a Comment