When to use references vs. pointers

by

Use reference wherever you can, pointers wherever you must.

Avoid pointers until you can’t.

The reason is that pointers make things harder to follow/read, less safe and far more dangerous manipulations than any other constructs.

So the rule of thumb is to use pointers only if there is no other choice.

For example, returning a pointer to an object is a valid option when the function can return nullptr in some cases and it is assumed it will. That said, a better option would be to use something similar to std::optional (requires C++17; before that, there’s boost::optional).

Another example is to use pointers to raw memory for specific memory manipulations. That should be hidden and localized in very narrow parts of the code, to help limit the dangerous parts of the whole code base.

In your example, there is no point in using a pointer as argument because:

  1. if you provide nullptr as the argument, you’re going in undefined-behaviour-land;
  2. the reference attribute version doesn’t allow (without easy to spot tricks) the problem with 1.
  3. the reference attribute version is simpler to understand for the user: you have to provide a valid object, not something that could be null.

If the behaviour of the function would have to work with or without a given object, then using a pointer as attribute suggests that you can pass nullptr as the argument and it is fine for the function. That’s kind of a contract between the user and the implementation.

More Related Contents:

  1. What are the differences between a pointer variable and a reference variable in C++?
  2. Reason to Pass a Pointer by Reference in C++?
  3. C++ pass an array by reference
  4. Why are references not reseatable in C++
  5. C++ standard: dereferencing NULL pointer to get a reference? [duplicate]
  6. Why is ‘this’ a pointer and not a reference?
  7. How are references implemented internally?
  8. how does the ampersand(&) sign work in c++? [duplicate]
  9. What are the differences between a pointer variable and a reference variable?
  10. Passing references to pointers in C++
  11. Difference between pointer to a reference and reference to a pointer
  12. What’s the meaning of * and & when applied to variable names?
  13. Function pointer vs Function reference
  14. error: invalid initialization of non-const reference of type ‘int&’ from an rvalue of type ‘int’
  15. What is the difference between std::reference_wrapper and a simple pointer?
  16. Why can’t I do polymorphism with normal variables?
  17. Why doesn’t reference-to-member exist in C++?
  18. Difference between const. pointer and reference?
  19. Returning non-const reference from a const member function
  20. C++: difference between ampersand “&” and asterisk “*” in function/method declaration?
  21. Why do some people prefer “T const&” over “const T&”?
  22. dereferencing a pointer when passing by reference
  23. Use const wherever possible in C++?
  24. Where ampersand “&” can be put when passing argument by reference?
  25. Why isn’t operator overloading for pointers allowed to work?
  26. C++ strings: [] vs. *
  27. Why is a c++ reference considered safer than a pointer?
  28. What is the proper way to return an object from a C++ function?
  29. Meaning of *& and **& in C++
  30. Pass by pointer & Pass by reference [duplicate]

Leave a Comment