In the C++ programming language, a reference is a simple reference datatype that is less powerful but safer than the pointer type inherited from C. The name C++ reference may cause confusion, as in computer science a reference is a general concept datatype, with pointers and C++ references being specific reference datatype implementations. The definition of a reference in C++ is such that it does not need to exist. It can be implemented as a new name for an existing object (similar to rename keyword in Ada).
Contents
Syntax and terminology
The declaration of the form:
<Type> & <Name>where <Type>
is a type and <Name>
is an identifier whose type is reference to <Type>
.
Examples:
int A = 5;
int& rA = A;
extern int& rB;
Here, rA
and rB
are of type "reference to int
"
int& foo ();
foo()
is a function that returns a "reference to int
"
void bar (int& rP);
bar()
is a function with a reference parameter, which is a "reference to int
"
class MyClass { int& m_b; /* ... */ };
MyClass
is a class
with a member which is reference to int
int funcX() { return 42 ; }; int (&xFunc)() = funcX;
funcX()
is a function that returns a (non-reference type) int
and xFunc()
is an alias for funcX
const int& ref = 65;
const int& ref
is a constant reference pointing to a piece of storage having value 65.
Types which are of kind "reference to <Type>
" are sometimes called reference types. Identifiers which are of reference type are called reference variables. To call them variable, however, is in fact a misnomer, as we will see.
Relationship to pointers
C++ references differ from pointers in several essential ways:
There is a simple conversion between pointers and references: the address-of operator (&
) will yield a pointer referring to the same object when applied to a reference, and a reference which is initialized from the dereference (*
) of a pointer value will refer to the same object as that pointer, where this is possible without invoking undefined behavior. This equivalence is a reflection of the typical implementation, which effectively compiles references into pointers which are implicitly dereferenced at each use. Though that is usually the case, the C++ Standard does not force compilers to implement references using pointers.
A consequence of this is that in many implementations, operating on a variable with automatic or static lifetime through a reference, although syntactically similar to accessing it directly, can involve hidden dereference operations that are costly.
Also, because the operations on references are so limited, they are much easier to understand than pointers and are more resistant to errors. While pointers can be made invalid through a variety of mechanisms, ranging from carrying a null value to out-of-bounds arithmetic to illegal casts to producing them from arbitrary integers, a previously-valid reference only becomes invalid in two cases:
The first is easy to detect automatically if the reference has static scoping, but is still a problem if the reference is a member of a dynamically allocated object; the second is more difficult to assure. These are the only concerns with references, and are suitably addressed by a reasonable allocation policy.
Analogies
Polymorphic behaviour
Continuing the relationship between references and pointers (in C++ context), the former exhibit polymorphic capabilities, as one might expect:
The source above is valid C++ and generates the following output:This is class A
This is class B
ISO definition
References are defined by the ISO C++ standard as follows (excluding the example section):
In a declaration T D where D has the form
and the type of the identifier in the declaration T D1 is "derived-declarator-type-list T
," then the type of the identifier of D is "derived-declarator-type-list reference to T
." Cv-qualified references are ill-formed except when the cv-qualifiers (const
and volatile) are introduced through the use of a typedef
(7.1.3) or of a template type argument (14.3), in which case the cv-qualifiers are ignored. [Example: in
the type of aref
is "reference to int
", not "const
reference to int
". ] [Note: a reference can be thought of as a name of an object. ] A declarator that specifies the type "reference to cv void" is ill-formed.
It is unspecified whether or not a reference requires storage (3.7).
initializerextern
Note