This helper functor seems useful in a few places. Adds tests and
improves documentation.

Fixes #3963