Reference parameter (source code)

= Reference parameter

A <reference parameter> designates the caller's actual storage. Assigning through it can change what the caller subsequently observes; passing a complete independent copy would instead change only the local copy. A <value parameter> containing an object reference is another case: copying that reference does not copy the referenced <software object>.

In <Oberon>, a variable parameter is marked `VAR` and stands for the supplied actual variable. For example, a procedure accepting `VAR x: INTEGER` can increment the caller's <integer> through `x`.<The Programming Language Oberon by Niklaus Wirth>[revision 3 May 2016, sections 9.2 and 10.1, variable versus value parameters]{ref}

A read-only <algorithm> can use a <reference parameter> to avoid copying a large <array>, while its <formal specification> still prohibits writes. <Reference aliasing> remains relevant: two parameters can designate overlapping storage. A proof of <algorithm correctness> must account for the actual aliasing rules rather than assume that different parameter names denote independent values.