Immutable object
Object whose state cannot be modified after it is created
- 31 min read
- 2 chapters
- 1 lab on Lably
Learn it on Lably
Strings and other concrete objects are typically expressed as immutable objects to improve readability and runtime efficiency in object-oriented programming. Immutable objects are also useful because they are inherently thread-safe. Other benefits are that they are simpler to understand and reason about and offer higher security than mutable objects.
Concepts
Immutable variables
In imperative programming, values held in program variables whose content never changes are known as constants to differentiate them from variables that could be altered during execution. Examples include conversion factors from meters to feet, or the value of pi to several decimal places.
Read-only fields may be calculated when the program runs (unlike constants, which are known beforehand), but never change after they are initialized.
Weak vs strong immutability
Sometimes, one talks of certain fields of an object being immutable. This means that there is no way to change those parts of the object state, even though other parts of the object may be changeable (weakly immutable). If all fields are immutable, then the object is immutable. If the whole object cannot be extended by another class, the object is called strongly immutable. This might, for example, help to explicitly enforce certain invariants about certain data in the object staying the same through the lifetime of the object. In some languages, this is done with a keyword (e.g. const in C++, final in Java) that designates the field as immutable. Some languages reverse it: in OCaml, fields of an object or record are by default immutable, and must be explicitly marked with mutable to be so.
References to objects
In most object-oriented languages, objects can be referred to using references. Some examples of such languages are Java, C++, C#, VB.NET, and many scripting languages, such as Perl, Python, and Ruby. In this case, it matters whether the state of an object can vary when objects are shared via references.
Referencing vs copying objects
If an object is known to be immutable, it is preferred to create a reference of it instead of copying the entire object. This is done to conserve memory by preventing data duplication and avoid calls to constructors and destructors; it also results in a potential boost in execution speed.
The reference copying technique is much more difficult to use for mutable objects, because if any user of a mutable object reference changes it, all other users of that reference see the change. If this is not the intended effect, it can be difficult to notify the other users to have them respond correctly. In these situations, defensive copying of the entire object rather than the reference is usually an easy but costly solution. The observer pattern is an alternative technique for handling changes to mutable objects.
Copy-on-write
A technique that blends the advantages of mutable and immutable objects, and is supported directly in almost all modern hardware, is copy-on-write (COW). Using this technique, when a user asks the system to copy an object, it instead merely creates a new reference that still points to the same object. As soon as a user attempts to modify the object through a particular reference, the system makes a real copy, applies the modification to that, and sets the reference to refer to the new copy. The other users are unaffected, because they still refer to the original object. Therefore, under COW, all users appear to have a mutable version of their objects, although in the case that users do not modify their objects, the space-saving and speed advantages of immutable objects are preserved. Copy-on-write is popular in virtual memory systems because it allows them to save memory space while still correctly handling anything an application program might do.
Interning
The practice of always using references in place of copies of equal objects is known as interning. If interning is used, two objects are considered equal if and only if their references, typically represented as pointers or integers, are equal. Some languages do this automatically: for example, Python automatically interns short strings. If the algorithm that implements interning is guaranteed to do so in every case that it is possible, then comparing objects for equality is reduced to comparing their pointers – a substantial gain in speed in most applications. (Even if the algorithm is not guaranteed to be comprehensive, there still exists the possibility of a fast path case improvement when the objects are equal and use the same reference.) Interning is generally only useful for immutable objects.
Thread safety
Immutable objects can be useful in multi-threaded applications. Multiple threads can act on data represented by immutable objects without concern of the data being changed by other threads. Immutable objects are therefore considered more thread-safe than mutable objects.
Violating immutability
Immutability does not imply that the object as stored in the computer's memory is unwriteable. Rather, immutability is a compile-time construct that indicates what a programmer can do through the normal interface of the object, not necessarily what they can absolutely do (for instance, by circumventing the type system or violating const correctness in C or C++).
Sign in to keep reading
One more chapter is free with a Lably account.
Language-specific details
In Python, Java and the .NET Framework, strings are immutable objects. Both Java and the .NET Framework have mutable versions of string. In Java these are StringBuffer and StringBuilder (mutable versions of Java String) and in .NET this is StringBuilder (mutable version of .Net String). Python 3 has a mutable string (bytes) variant, named bytearray.
Additionally, all of the primitive wrapper classes in Java are immutable.
Similar patterns are the Immutable Interface and Immutable Wrapper.
In pure functional programming languages it is not possible to create mutable objects without extending the language (e.g. via a mutable references library or a foreign function interface), so all objects are immutable.
Ada
In Ada, any object is declared either variable (i.e. mutable; typically the implicit default), or constant (i.e. immutable) via the constant keyword.
<span id="mwlg"></span> <span class="kd" id="mwlw">type</span> <span class="kt" id="mwmA">Some_type</span> <span class="kr" id="mwmQ">is</span> <span class="kr" id="mwmg">new</span> <span class="kt" id="mwmw">Integer</span><span class="p" id="mwnA">;</span> <span class="c1" id="mwnQ">-- could be anything more complicated</span> <span class="no" id="mwng">x</span><span class="p" id="mwnw">:</span> <span class="kr" id="mwoA">constant</span> <span class="n" id="mwoQ">Some_type</span><span class="p" id="mwog">:=</span> <span class="mi" id="mwow">1</span><span class="p" id="mwpA">;</span> <span class="c1" id="mwpQ">-- immutable</span> <span class="n" id="mwpg">y</span><span class="p" id="mwpw">:</span> <span class="n" id="mwqA">Some_type</span><span class="p" id="mwqQ">;</span> <span class="c1" id="mwqg">-- mutable</span>
Subprogram parameters are immutable in the in mode, and mutable in the in out and out modes.
<span id="mwsQ"></span> <span class="kd" id="mwsg">procedure</span> <span class="nf" id="mwsw">Do_it</span><span class="p" id="mwtA">(</span><span class="nv" id="mwtQ">a</span><span class="p" id="mwtg">: </span><span class="nv" id="mwtw">in</span> <span class="nv" id="mwuA">Integer</span><span class="p" id="mwuQ">;</span> <span class="nv" id="mwug">b</span><span class="p" id="mwuw">: </span><span class="nv" id="mwvA">in</span> <span class="nv" id="mwvQ">out</span> <span class="nv" id="mwvg">Integer</span><span class="p" id="mwvw">;</span> <span class="nv" id="mwwA">c</span><span class="p" id="mwwQ">: </span><span class="nv" id="mwwg">out</span> <span class="nv" id="mwww">Integer</span><span class="p" id="mwxA">)</span> <span class="kr" id="mwxQ">is</span> <span class="kr" id="mwxg">begin</span> <span class="c1" id="mwxw">-- a is immutable</span> <span class="n" id="mwyA">b</span><span class="p" id="mwyQ">:=</span> <span class="n" id="mwyg">b</span> <span class="o" id="mwyw">+</span> <span class="n" id="mwzA">a</span><span class="p" id="mwzQ">;</span> <span class="n" id="mwzg">c</span><span class="p" id="mwzw">:=</span> <span class="n" id="mw0A">a</span><span class="p" id="mw0Q">;</span> <span class="kr" id="mw0g">end</span> <span class="nf" id="mw0w">Do_it</span><span class="p" id="mw1A">;</span>
C#
In C# one can enforce immutability of the fields of a class with the readonly statement. By enforcing all the fields as immutable, the type becomes an immutable type.
<span id="mw4A"></span><span class="k" id="mw4Q">class</span><span class="w" id="mw4g"> </span><span class="nc" id="mw4w">ImmutableType</span> <span class="p" id="mw5A">{</span> <span class="w" id="mw5Q"> </span><span class="k" id="mw5g">public</span><span class="w" id="mw5w"> </span><span class="k" id="mw6A">readonly</span><span class="w" id="mw6Q"> </span><span class="kt" id="mw6g">double</span><span class="w" id="mw6w"> </span><span class="n" id="mw7A">Value</span><span class="w" id="mw7Q"> </span><span class="p" id="mw7g">{</span><span class="w" id="mw7w"> </span><span class="k" id="mw8A">get</span><span class="p" id="mw8Q">;</span><span class="w" id="mw8g"> </span><span class="p" id="mw8w">}</span> <span class="w" id="mw9A"> </span><span class="k" id="mw9Q">public</span><span class="w" id="mw9g"> </span><span class="nf" id="mw9w">ImmutableType</span><span class="p" id="mw-A">(</span><span class="kt" id="mw-Q">double</span><span class="w" id="mw-g"> </span><span class="n" id="mw-w">x</span><span class="p" id="mw_A">)</span><span class="w" id="mw_Q"> </span> <span class="w" id="mw_g"> </span><span class="p" id="mw_w">{</span><span class="w" id="mwAQA"> </span> <span class="w" id="mwAQE"> </span><span class="n" id="mwAQI">Value</span><span class="w" id="mwAQM"> </span><span class="o" id="mwAQQ">=</span><span class="w" id="mwAQU"> </span><span class="n" id="mwAQY">x</span><span class="p" id="mwAQc">;</span><span class="w" id="mwAQg"> </span> <span class="w" id="mwAQk"> </span><span class="p" id="mwAQo">}</span> <span class="w" id="mwAQs"> </span><span class="k" id="mwAQw">public</span><span class="w" id="mwAQ0"> </span><span class="n" id="mwAQ4">ImmutableType</span><span class="w" id="mwAQ8"> </span><span class="nf" id="mwARA">Square</span><span class="p" id="mwARE">()</span><span class="w" id="mwARI"> </span> <span class="w" id="mwARM"> </span><span class="p" id="mwARQ">{</span><span class="w" id="mwARU"> </span> <span class="w" id="mwARY"> </span><span class="k" id="mwARc">return</span><span class="w" id="mwARg"> </span><span class="k" id="mwARk">new</span><span class="w" id="mwARo"> </span><span class="nf" id="mwARs">ImmutableType</span><span class="p" id="mwARw">(</span><span class="n" id="mwAR0">Value</span><span class="w" id="mwAR4"> </span><span class="o" id="mwAR8">*</span><span class="w" id="mwASA"> </span><span class="n" id="mwASE">Value</span><span class="p" id="mwASI">);</span><span class="w" id="mwASM"> </span> <span class="w" id="mwASQ"> </span><span class="p" id="mwASU">}</span> <span class="p" id="mwASY">}</span>C# has records which are immutable.
<span id="mwATI"></span><span class="k" id="mwATM">record</span><span class="w" id="mwATQ"> </span><span class="nf" id="mwATU">Person</span><span class="p" id="mwATY">(</span><span class="kt" id="mwATc">string</span><span class="w" id="mwATg"> </span><span class="n" id="mwATk">FirstName</span><span class="p" id="mwATo">,</span><span class="w" id="mwATs"> </span><span class="kt" id="mwATw">string</span><span class="w" id="mwAT0"> </span><span class="n" id="mwAT4">LastName</span><span class="p" id="mwAT8">);</span>
C++
In C++, a const-correct implementation of ShoppingCart would allow the user to create instances of the class and then use them as either const (immutable) or mutable, as desired, by providing two different versions of the items() method. (Notice that in C++ it is not necessary — and in fact impossible — to provide a specialized constructor for const instances.)
<span id="mwAUk"></span><span class="k" id="mwAUo">import</span><span class="w" id="mwAUs"> </span><span class="n" id="mwAUw">std</span><span class="p" id="mwAU0">;</span> <span class="k" id="mwAU4">using</span><span class="w" id="mwAU8"> </span><span class="n" id="mwAVA">std</span><span class="o" id="mwAVE">::</span><span class="n" id="mwAVI">vector</span><span class="p" id="mwAVM">;</span> <span class="k" id="mwAVQ">using</span><span class="w" id="mwAVU"> </span><span class="n" id="mwAVY">std</span><span class="o" id="mwAVc">::</span><span class="n" id="mwAVg">views</span><span class="o" id="mwAVk">::</span><span class="n" id="mwAVo">transform</span><span class="p" id="mwAVs">;</span> <span class="k" id="mwAVw">class</span><span class="w" id="mwAV0"> </span><span class="nc" id="mwAV4">ShoppingCart</span><span class="w" id="mwAV8"> </span><span class="p" id="mwAWA">{</span> <span class="k" id="mwAWE">private</span><span class="o" id="mwAWI">:</span> <span class="w" id="mwAWM"> </span><span class="n" id="mwAWQ">vector</span><span class="o" id="mwAWU"><</span><span class="n" id="mwAWY">Merchandise</span><span class="o" id="mwAWc">></span><span class="w" id="mwAWg"> </span><span class="n" id="mwAWk">items</span><span class="p" id="mwAWo">;</span> <span class="k" id="mwAWs">public</span><span class="o" id="mwAWw">:</span> <span class="w" id="mwAW0"> </span><span class="k" id="mwAW4">explicit</span><span class="w" id="mwAW8"> </span><span class="n" id="mwAXA">Cart</span><span class="p" id="mwAXE">(</span><span class="k" id="mwAXI">const</span><span class="w" id="mwAXM"> </span><span class="n" id="mwAXQ">vector</span><span class="o" id="mwAXU"><</span><span class="n" id="mwAXY">Merchandise</span><span class="o" id="mwAXc">>&</span><span class="w" id="mwAXg"> </span><span class="n" id="mwAXk">items</span><span class="p" id="mwAXo">)</span><span class="o" id="mwAXs">:</span><span class="w" id="mwAXw"> </span> <span class="w" id="mwAX0"> </span><span class="n" id="mwAX4">items</span><span class="p" id="mwAX8">{</span><span class="n" id="mwAYA">items</span><span class="p" id="mwAYE">}</span><span class="w" id="mwAYI"> </span><span class="p" id="mwAYM">{}</span> <span class="w" id="mwAYQ"> </span><span class="n" id="mwAYU">vector</span><span class="o" id="mwAYY"><</span><span class="n" id="mwAYc">Merchandise</span><span class="o" id="mwAYg">>&</span><span class="w" id="mwAYk"> </span><span class="n" id="mwAYo">items</span><span class="p" id="mwAYs">()</span><span class="w" id="mwAYw"> </span><span class="p" id="mwAY0">{</span><span class="w" id="mwAY4"> </span> <span class="w" id="mwAY8"> </span><span class="k" id="mwAZA">return</span><span class="w" id="mwAZE"> </span><span class="n" id="mwAZI">items</span><span class="p" id="mwAZM">;</span><span class="w" id="mwAZQ"> </span> <span class="w" id="mwAZU"> </span><span class="p" id="mwAZY">}</span> <span class="w" id="mwAZc"> </span><span class="k" id="mwAZg">const</span><span class="w" id="mwAZk"> </span><span class="n" id="mwAZo">vector</span><span class="o" id="mwAZs"><</span><span class="n" id="mwAZw">Merchandise</span><span class="o" id="mwAZ0">>&</span><span class="w" id="mwAZ4"> </span><span class="n" id="mwAZ8">items</span><span class="p" id="mwAaA">()</span><span class="w" id="mwAaE"> </span><span class="k" id="mwAaI">const</span><span class="w" id="mwAaM"> </span><span class="p" id="mwAaQ">{</span><span class="w" id="mwAaU"> </span> <span class="w" id="mwAaY"> </span><span class="k" id="mwAac">return</span><span class="w" id="mwAag"> </span><span class="n" id="mwAak">items</span><span class="p" id="mwAao">;</span> <span class="w" id="mwAas"> </span><span class="p" id="mwAaw">}</span> <span class="w" id="mwAa0"> </span><span class="kt" id="mwAa4">double</span><span class="w" id="mwAa8"> </span><span class="n" id="mwAbA">computeTotalCost</span><span class="p" id="mwAbE">()</span><span class="w" id="mwAbI"> </span><span class="k" id="mwAbM">const</span><span class="w" id="mwAbQ"> </span><span class="p" id="mwAbU">{</span><span class="w" id="mwAbY"> </span> <span class="w" id="mwAbc"> </span><span class="k" id="mwAbg">return</span><span class="w" id="mwAbk"> </span><span class="n" id="mwAbo">std</span><span class="o" id="mwAbs">::</span><span class="n" id="mwAbw">ranges</span><span class="o" id="mwAb0">::</span><span class="n" id="mwAb4">accumulate</span><span class="p" id="mwAb8">(</span> <span class="w" id="mwAcA"> </span><span class="n" id="mwAcE">items</span><span class="w" id="mwAcI"> </span><span class="o" id="mwAcM">|</span><span class="w" id="mwAcQ"> </span><span class="n" id="mwAcU">transform</span><span class="p" id="mwAcY">([](</span><span class="k" id="mwAcc">const</span><span class="w" id="mwAcg"> </span><span class="n" id="mwAck">Merchandise</span><span class="o" id="mwAco">&</span><span class="w" id="mwAcs"> </span><span class="n" id="mwAcw">m</span><span class="p" id="mwAc0">)</span><span class="w" id="mwAc4"> </span><span class="o" id="mwAc8">-></span><span class="w" id="mwAdA"> </span><span class="kt" id="mwAdE">double</span><span class="w" id="mwAdI"> </span><span class="p" id="mwAdM">{</span><span class="w" id="mwAdQ"> </span><span class="k" id="mwAdU">return</span><span class="w" id="mwAdY"> </span><span class="n" id="mwAdc">m</span><span class="p" id="mwAdg">.</span><span class="n" id="mwAdk">getPrice</span><span class="p" id="mwAdo">();</span><span class="w" id="mwAds"> </span><span class="p" id="mwAdw">}),</span><span class="w" id="mwAd0"> </span> <span class="w" id="mwAd4"> </span><span class="mf" id="mwAd8">0.0</span> <span class="w" id="mwAeA"> </span><span class="p" id="mwAeE">);</span> <span class="w" id="mwAeI"> </span><span class="p" id="mwAeM">}</span> <span class="p" id="mwAeQ">};</span>Note that, when there is a data member that is a pointer or reference to another object, then it is possible to mutate the object pointed to or referenced only within a non-const method.
C++ also provides abstract (as opposed to bitwise) immutability via the mutable keyword, which lets a member variable be changed from within a const method.
<span id="mwAew"></span><span class="k" id="mwAe0">import</span><span class="w" id="mwAe4"> </span><span class="n" id="mwAe8">std</span><span class="p" id="mwAfA">;</span> <span class="k" id="mwAfE">using</span><span class="w" id="mwAfI"> </span><span class="n" id="mwAfM">std</span><span class="o" id="mwAfQ">::</span><span class="n" id="mwAfU">optional</span><span class="p" id="mwAfY">;</span> <span class="k" id="mwAfc">using</span><span class="w" id="mwAfg"> </span><span class="n" id="mwAfk">std</span><span class="o" id="mwAfo">::</span><span class="n" id="mwAfs">vector</span><span class="p" id="mwAfw">;</span> <span class="k" id="mwAf0">using</span><span class="w" id="mwAf4"> </span><span class="n" id="mwAf8">std</span><span class="o" id="mwAgA">::</span><span class="n" id="mwAgE">views</span><span class="o" id="mwAgI">::</span><span class="n" id="mwAgM">transform</span><span class="p" id="mwAgQ">;</span> <span class="k" id="mwAgU">class</span><span class="w" id="mwAgY"> </span><span class="nc" id="mwAgc">ShoppingCart</span><span class="w" id="mwAgg"> </span><span class="p" id="mwAgk">{</span> <span class="k" id="mwAgo">private</span><span class="o" id="mwAgs">:</span> <span class="w" id="mwAgw"> </span><span class="n" id="mwAg0">vector</span><span class="o" id="mwAg4"><</span><span class="n" id="mwAg8">Merchandise</span><span class="o" id="mwAhA">></span><span class="w" id="mwAhE"> </span><span class="n" id="mwAhI">items</span><span class="p" id="mwAhM">;</span> <span class="w" id="mwAhQ"> </span><span class="k" id="mwAhU">mutable</span><span class="w" id="mwAhY"> </span><span class="n" id="mwAhc">optional</span><span class="o" id="mwAhg"><</span><span class="kt" id="mwAhk">int</span><span class="o" id="mwAho">></span><span class="w" id="mwAhs"> </span><span class="n" id="mwAhw">totalCost</span><span class="p" id="mwAh0">;</span> <span class="k" id="mwAh4">public</span><span class="o" id="mwAh8">:</span> <span class="w" id="mwAiA"> </span><span class="k" id="mwAiE">explicit</span><span class="w" id="mwAiI"> </span><span class="n" id="mwAiM">Cart</span><span class="p" id="mwAiQ">(</span><span class="k" id="mwAiU">const</span><span class="w" id="mwAiY"> </span><span class="n" id="mwAic">vector</span><span class="o" id="mwAig"><</span><span class="n" id="mwAik">Merchandise</span><span class="o" id="mwAio">>&</span><span class="w" id="mwAis"> </span><span class="n" id="mwAiw">items</span><span class="p" id="mwAi0">)</span><span class="o" id="mwAi4">:</span><span class="w" id="mwAi8"> </span> <span class="w" id="mwAjA"> </span><span class="n" id="mwAjE">items</span><span class="p" id="mwAjI">{</span><span class="n" id="mwAjM">items</span><span class="p" id="mwAjQ">}</span><span class="w" id="mwAjU"> </span><span class="p" id="mwAjY">{}</span> <span class="w" id="mwAjc"> </span><span class="k" id="mwAjg">const</span><span class="w" id="mwAjk"> </span><span class="n" id="mwAjo">vector</span><span class="o" id="mwAjs"><</span><span class="n" id="mwAjw">Merchandise</span><span class="o" id="mwAj0">>&</span><span class="w" id="mwAj4"> </span><span class="n" id="mwAj8">items</span><span class="p" id="mwAkA">()</span><span class="w" id="mwAkE"> </span><span class="k" id="mwAkI">const</span><span class="w" id="mwAkM"> </span><span class="p" id="mwAkQ">{</span><span class="w" id="mwAkU"> </span> <span class="w" id="mwAkY"> </span><span class="k" id="mwAkc">return</span><span class="w" id="mwAkg"> </span><span class="n" id="mwAkk">items</span><span class="p" id="mwAko">;</span><span class="w" id="mwAks"> </span> <span class="w" id="mwAkw"> </span><span class="p" id="mwAk0">}</span> <span class="w" id="mwAk4"> </span><span class="kt" id="mwAk8">int</span><span class="w" id="mwAlA"> </span><span class="n" id="mwAlE">computeTotalCost</span><span class="p" id="mwAlI">()</span><span class="w" id="mwAlM"> </span><span class="k" id="mwAlQ">const</span><span class="w" id="mwAlU"> </span><span class="p" id="mwAlY">{</span> <span class="w" id="mwAlc"> </span><span class="k" id="mwAlg">if</span><span class="w" id="mwAlk"> </span><span class="p" id="mwAlo">(</span><span class="o" id="mwAls">!</span><span class="n" id="mwAlw">totalCost</span><span class="p" id="mwAl0">)</span><span class="w" id="mwAl4"> </span><span class="p" id="mwAl8">{</span> <span class="w" id="mwAmA"> </span><span class="n" id="mwAmE">totalCost</span><span class="w" id="mwAmI"> </span><span class="o" id="mwAmM">=</span><span class="w" id="mwAmQ"> </span><span class="n" id="mwAmU">std</span><span class="o" id="mwAmY">::</span><span class="n" id="mwAmc">ranges</span><span class="o" id="mwAmg">::</span><span class="n" id="mwAmk">accumulate</span><span class="p" id="mwAmo">(</span> <span class="w" id="mwAms"> </span><span class="n" id="mwAmw">items</span><span class="w" id="mwAm0"> </span><span class="o" id="mwAm4">|</span><span class="w" id="mwAm8"> </span><span class="n" id="mwAnA">transform</span><span class="p" id="mwAnE">([](</span><span class="k" id="mwAnI">const</span><span class="w" id="mwAnM"> </span><span class="n" id="mwAnQ">Merchandise</span><span class="o" id="mwAnU">&</span><span class="w" id="mwAnY"> </span><span class="n" id="mwAnc">m</span><span class="p" id="mwAng">)</span><span class="w" id="mwAnk"> </span><span class="o" id="mwAno">-></span><span class="w" id="mwAns"> </span><span class="kt" id="mwAnw">double</span><span class="w" id="mwAn0"> </span><span class="p" id="mwAn4">{</span><span class="w" id="mwAn8"> </span><span class="k" id="mwAoA">return</span><span class="w" id="mwAoE"> </span><span class="n" id="mwAoI">m</span><span class="p" id="mwAoM">.</span><span class="n" id="mwAoQ">getPrice</span><span class="p" id="mwAoU">();</span><span class="w" id="mwAoY"> </span><span class="p" id="mwAoc">}),</span><span class="w" id="mwAog"> </span> <span class="w" id="mwAok"> </span><span class="mf" id="mwAoo">0.0</span> <span class="w" id="mwAos"> </span><span class="p" id="mwAow">);</span> <span class="w" id="mwAo0"> </span><span class="p" id="mwAo4">}</span> <span class="w" id="mwAo8"> </span><span class="k" id="mwApA">return</span><span class="w" id="mwApE"> </span><span class="o" id="mwApI">*</span><span class="n" id="mwApM">totalCost</span><span class="p" id="mwApQ">;</span> <span class="w" id="mwApU"> </span><span class="p" id="mwApY">}</span> <span class="p" id="mwApc">};</span>D
In D, there exist two type qualifiers, const and immutable, for variables that cannot be changed. Unlike C++'s const, Java's final, and C#'s readonly, they are transitive and recursively apply to anything reachable through references of such a variable. The difference between const and immutable is what they apply to: const is a property of the variable: there might legally exist mutable references to referred value, i.e. the value can actually change. In contrast, immutable is a property of the referred value: the value and anything transitively reachable from it cannot change (without breaking the type system, leading to undefined behavior). Any reference of that value must be marked const or immutable. Basically for any unqualified type T, const(T) is the disjoint union of T (mutable) and immutable(T).
<span id="mwArI"></span><span class="k" id="mwArM">class</span><span class="w" id="mwArQ"> </span><span class="n" id="mwArU">Example</span><span class="w" id="mwArY"> </span><span class="p" id="mwArc">{</span> <span class="w" id="mwArg"> </span><span class="n" id="mwArk">Object</span><span class="w" id="mwAro"> </span><span class="n" id="mwArs">mutableField</span><span class="p" id="mwArw">;</span><span class="w" id="mwAr0"> </span><span class="c1" id="mwAr4">// mutable</span> <span class="w" id="mwAr8"> </span><span class="k" id="mwAsA">const</span><span class="w" id="mwAsE"> </span><span class="n" id="mwAsI">Object</span><span class="w" id="mwAsM"> </span><span class="n" id="mwAsQ">constField</span><span class="p" id="mwAsU">;</span> <span class="w" id="mwAsY"> </span><span class="k" id="mwAsc">immutable</span><span class="w" id="mwAsg"> </span><span class="n" id="mwAsk">Object</span><span class="w" id="mwAso"> </span><span class="n" id="mwAss">immutableField</span><span class="p" id="mwAsw">;</span> <span class="p" id="mwAs0">}</span>For a mutable Example object, its mutableField can be written to. For a const(Example) object, mutableField cannot be modified, it inherits const; immutableField is still immutable as it is the stronger guarantee. For an immutable(Example), all fields are immutable.
In a function like this:
<span id="mwAtk"></span><span class="kt" id="mwAto">void</span><span class="w" id="mwAts"> </span><span class="n" id="mwAtw">fn</span><span class="p" id="mwAt0">(</span><span class="n" id="mwAt4">Example</span><span class="w" id="mwAt8"> </span><span class="n" id="mwAuA">m</span><span class="p" id="mwAuE">,</span><span class="w" id="mwAuI"> </span><span class="k" id="mwAuM">const</span><span class="w" id="mwAuQ"> </span><span class="n" id="mwAuU">Example</span><span class="w" id="mwAuY"> </span><span class="n" id="mwAuc">c</span><span class="p" id="mwAug">,</span><span class="w" id="mwAuk"> </span><span class="k" id="mwAuo">immutable</span><span class="w" id="mwAus"> </span><span class="n" id="mwAuw">Example</span><span class="w" id="mwAu0"> </span><span class="n" id="mwAu4">i</span><span class="p" id="mwAu8">)</span><span class="w" id="mwAvA"> </span><span class="p" id="mwAvE">{</span><span class="w" id="mwAvI"> </span> <span class="w" id="mwAvM"> </span><span class="c1" id="mwAvQ">// inside the braces</span> <span class="p" id="mwAvU">}</span>Inside the braces, c might refer to the same object as m, so mutations to m could indirectly change c as well. Also, c might refer to the same object as i, but since the value then is immutable, there are no changes. However, m and i cannot legally refer to the same object.
In the language of guarantees, mutable has no guarantees (the function might change the object), const is an outward-only guarantee that the function will not change anything, and immutable is a bidirectional guarantee (the function will not change the value and the caller must not change it).
Values that are const or immutable must be initialized by direct assignment at the point of declaration or by a constructor.
Because const parameters forget if the value was mutable or not, a similar construct, inout, acts, in a sense, as a variable for mutability information. A function of type const(S) function(const(T)) returns const(S) typed values for mutable, const and immutable arguments. In contrast, a function of type inout(S) function(inout(T)) returns S for mutable T arguments, const(S) for const(T) values, and immutable(S) for immutable(T) values.
Casting immutable values to mutable inflicts undefined behavior upon change, even if the original value comes from a mutable origin. Casting mutable values to immutable can be legal when there remain no mutable references afterward. "An expression may be converted from mutable (...) to immutable if the expression is unique and all expressions it transitively refers to are either unique or immutable." If the compiler cannot prove uniqueness, the casting can be done explicitly and it is up to the programmer to ensure that no mutable references exist.
The type string is an alias for immutable(char)[], i.e. a typed slice of memory of immutable characters. Making substrings is cheap, as it just copies and modifies a pointer and a length filed, and safe, as the underlying data cannot be changed. Objects of type const(char)[] can refer to strings, but also to mutable buffers.
Making a shallow copy of a const or immutable value removes the outer layer of immutability: Copying an immutable string (immutable(char[])) returns a string (immutable(char)[]). The immutable pointer and length are being copied and the copies are mutable. The referred data has not been copied and keeps its qualifier, in the example immutable. It can be stripped by making a depper copy, e.g. using the dup function.
Java
A classic example of an immutable object is an instance of the Java String class
<span id="mwAys"></span><span class="n" id="mwAyw">String</span><span class="w" id="mwAy0"> </span><span class="n" id="mwAy4">s</span><span class="w" id="mwAy8"> </span><span class="o" id="mwAzA">=</span><span class="w" id="mwAzE"> </span><span class="s" id="mwAzI">"ABC"</span><span class="p" id="mwAzM">;</span> <span class="n" id="mwAzQ">s</span><span class="p" id="mwAzU">.</span><span class="na" id="mwAzY">toLowerCase</span><span class="p" id="mwAzc">();</span><span class="w" id="mwAzg"> </span><span class="c1" id="mwAzk">// This accomplishes nothing!</span>
The method toLowerCase() does not change the data "ABC" that s contains. Instead, a new String object is instantiated and given the data "abc" during its construction. A reference to this String object is returned by the toLowerCase() method. To make the String s contain the data "abc", a different approach is needed:
<span id="mwA0E"></span><span class="n" id="mwA0I">s</span><span class="w" id="mwA0M"> </span><span class="o" id="mwA0Q">=</span><span class="w" id="mwA0U"> </span><span class="n" id="mwA0Y">s</span><span class="p" id="mwA0c">.</span><span class="na" id="mwA0g">toLowerCase</span><span class="p" id="mwA0k">();</span>
Now the String s references a new String object that contains "abc". There is nothing in the syntax of the declaration of the class String that enforces it as immutable; rather, none of the String class's methods ever affect the data that a String object contains, thus making it immutable.
The keyword final (detailed article) is used in implementing immutable primitive types and object references, but it cannot, by itself, make the objects themselves immutable. See below examples:
Primitive type variables (int, long, short, etc.) can be reassigned after being defined. This can be prevented by using final.
<span id="mwA1w"></span><span class="kt" id="mwA10">int</span><span class="w" id="mwA14"> </span><span class="n" id="mwA18">i</span><span class="w" id="mwA2A"> </span><span class="o" id="mwA2E">=</span><span class="w" id="mwA2I"> </span><span class="mi" id="mwA2M">42</span><span class="p" id="mwA2Q">;</span><span class="w" id="mwA2U"> </span><span class="c1" id="mwA2Y">//int is a primitive type</span> <span class="n" id="mwA2c">i</span><span class="w" id="mwA2g"> </span><span class="o" id="mwA2k">=</span><span class="w" id="mwA2o"> </span><span class="mi" id="mwA2s">43</span><span class="p" id="mwA2w">;</span><span class="w" id="mwA20"> </span><span class="c1" id="mwA24">// OK</span> <span class="kd" id="mwA28">final</span><span class="w" id="mwA3A"> </span><span class="kt" id="mwA3E">int</span><span class="w" id="mwA3I"> </span><span class="n" id="mwA3M">j</span><span class="w" id="mwA3Q"> </span><span class="o" id="mwA3U">=</span><span class="w" id="mwA3Y"> </span><span class="mi" id="mwA3c">42</span><span class="p" id="mwA3g">;</span> <span class="n" id="mwA3k">j</span><span class="w" id="mwA3o"> </span><span class="o" id="mwA3s">=</span><span class="w" id="mwA3w"> </span><span class="mi" id="mwA30">43</span><span class="p" id="mwA34">;</span><span class="w" id="mwA38"> </span><span class="c1" id="mwA4A">// does not compile. j is final so can't be reassigned</span>
Reference types cannot be made immutable just by using the final keyword. final only prevents reassignment.
<span id="mwA4Y"></span><span class="kd" id="mwA4c">final</span><span class="w" id="mwA4g"> </span><span class="n" id="mwA4k">MyObject</span><span class="w" id="mwA4o"> </span><span class="n" id="mwA4s">m</span><span class="w" id="mwA4w"> </span><span class="o" id="mwA40">=</span><span class="w" id="mwA44"> </span><span class="k" id="mwA48">new</span><span class="w" id="mwA5A"> </span><span class="n" id="mwA5E">MyObject</span><span class="p" id="mwA5I">();</span><span class="w" id="mwA5M"> </span><span class="c1" id="mwA5Q">//m is of reference type</span> <span class="n" id="mwA5U">m</span><span class="p" id="mwA5Y">.</span><span class="na" id="mwA5c">data</span><span class="w" id="mwA5g"> </span><span class="o" id="mwA5k">=</span><span class="w" id="mwA5o"> </span><span class="mi" id="mwA5s">100</span><span class="p" id="mwA5w">;</span><span class="w" id="mwA50"> </span><span class="c1" id="mwA54">// OK. We can change state of object m (m is mutable and final doesn't change this fact)</span> <span class="n" id="mwA58">m</span><span class="w" id="mwA6A"> </span><span class="o" id="mwA6E">=</span><span class="w" id="mwA6I"> </span><span class="k" id="mwA6M">new</span><span class="w" id="mwA6Q"> </span><span class="n" id="mwA6U">MyObject</span><span class="p" id="mwA6Y">();</span><span class="w" id="mwA6c"> </span><span class="c1" id="mwA6g">// does not compile. m is final so can't be reassigned</span>
Primitive wrappers (Integer, Long, Short, Double, Float, Character, Byte, Boolean) are also all immutable. Immutable classes can be implemented by following a few simple guidelines.
JavaScript
In JavaScript, all primitive types (Undefined, Null, Boolean, Number, BigInt, String, Symbol) are immutable, but custom objects are generally mutable.
<span id="mwA7s"></span><span class="kd" id="mwA7w">function</span><span class="w" id="mwA70"> </span><span class="nx" id="mwA74">doSomething</span><span class="p" id="mwA78">(</span><span class="nx" id="mwA8A">x</span><span class="p" id="mwA8E">)</span><span class="w" id="mwA8I"> </span><span class="p" id="mwA8M">{</span><span class="w" id="mwA8Q"> </span><span class="cm" id="mwA8U">/* does changing x here change the original? */</span><span class="w" id="mwA8Y"> </span><span class="p" id="mwA8c">};</span> <span class="kd" id="mwA8g">var</span><span class="w" id="mwA8k"> </span><span class="nx" id="mwA8o">str</span><span class="w" id="mwA8s"> </span><span class="o" id="mwA8w">=</span><span class="w" id="mwA80"> </span><span class="s1" id="mwA84">'a string'</span><span class="p" id="mwA88">;</span> <span class="kd" id="mwA9A">var</span><span class="w" id="mwA9E"> </span><span class="nx" id="mwA9I">obj</span><span class="w" id="mwA9M"> </span><span class="o" id="mwA9Q">=</span><span class="w" id="mwA9U"> </span><span class="p" id="mwA9Y">{</span><span class="w" id="mwA9c"> </span><span class="nx" id="mwA9g">an</span><span class="o" id="mwA9k">:</span><span class="w" id="mwA9o"> </span><span class="s1" id="mwA9s">'object'</span><span class="w" id="mwA9w"> </span><span class="p" id="mwA90">};</span> <span class="nx" id="mwA94">doSomething</span><span class="p" id="mwA98">(</span><span class="nx" id="mwA-A">str</span><span class="p" id="mwA-E">);</span><span class="w" id="mwA-I"> </span><span class="c1" id="mwA-M">// strings, numbers and bool types are immutable, function gets a copy</span> <span class="nx" id="mwA-Q">doSomething</span><span class="p" id="mwA-U">(</span><span class="nx" id="mwA-Y">obj</span><span class="p" id="mwA-c">);</span><span class="w" id="mwA-g"> </span><span class="c1" id="mwA-k">// objects are passed in by reference and are mutable inside function</span> <span class="nx" id="mwA-o">doAnotherThing</span><span class="p" id="mwA-s">(</span><span class="nx" id="mwA-w">str</span><span class="p" id="mwA-0">,</span><span class="w" id="mwA-4"> </span><span class="nx" id="mwA-8">obj</span><span class="p" id="mwA_A">);</span><span class="w" id="mwA_E"> </span><span class="c1" id="mwA_I">// `str` has not changed, but `obj` may have.</span>To simulate immutability in an object, one may define properties as read-only (writable: false).
<span id="mwA_Y"></span><span class="kd" id="mwA_c">var</span><span class="w" id="mwA_g"> </span><span class="nx" id="mwA_k">obj</span><span class="w" id="mwA_o"> </span><span class="o" id="mwA_s">=</span><span class="w" id="mwA_w"> </span><span class="p" id="mwA_0">{};</span> <span class="nb" id="mwA_4">Object</span><span class="p" id="mwA_8">.</span><span class="nx" id="mwBAA">defineProperty</span><span class="p" id="mwBAE">(</span><span class="nx" id="mwBAI">obj</span><span class="p" id="mwBAM">,</span><span class="w" id="mwBAQ"> </span><span class="s1" id="mwBAU">'foo'</span><span class="p" id="mwBAY">,</span><span class="w" id="mwBAc"> </span><span class="p" id="mwBAg">{</span><span class="w" id="mwBAk"> </span><span class="nx" id="mwBAo">value</span><span class="o" id="mwBAs">:</span><span class="w" id="mwBAw"> </span><span class="s1" id="mwBA0">'bar'</span><span class="p" id="mwBA4">,</span><span class="w" id="mwBA8"> </span><span class="nx" id="mwBBA">writable</span><span class="o" id="mwBBE">:</span><span class="w" id="mwBBI"> </span><span class="kc" id="mwBBM">false</span><span class="w" id="mwBBQ"> </span><span class="p" id="mwBBU">});</span> <span class="nx" id="mwBBY">obj</span><span class="p" id="mwBBc">.</span><span class="nx" id="mwBBg">foo</span><span class="w" id="mwBBk"> </span><span class="o" id="mwBBo">=</span><span class="w" id="mwBBs"> </span><span class="s1" id="mwBBw">'bar2'</span><span class="p" id="mwBB0">;</span><span class="w" id="mwBB4"> </span><span class="c1" id="mwBB8">// silently ignored</span>However, the approach above still lets new properties be added. Alternatively, one may use Object.freeze to make existing objects immutable.
<span id="mwBCQ"></span><span class="kd" id="mwBCU">var</span><span class="w" id="mwBCY"> </span><span class="nx" id="mwBCc">obj</span><span class="w" id="mwBCg"> </span><span class="o" id="mwBCk">=</span><span class="w" id="mwBCo"> </span><span class="p" id="mwBCs">{</span><span class="w" id="mwBCw"> </span><span class="nx" id="mwBC0">foo</span><span class="o" id="mwBC4">:</span><span class="w" id="mwBC8"> </span><span class="s1" id="mwBDA">'bar'</span><span class="w" id="mwBDE"> </span><span class="p" id="mwBDI">};</span> <span class="nb" id="mwBDM">Object</span><span class="p" id="mwBDQ">.</span><span class="nx" id="mwBDU">freeze</span><span class="p" id="mwBDY">(</span><span class="nx" id="mwBDc">obj</span><span class="p" id="mwBDg">);</span> <span class="nx" id="mwBDk">obj</span><span class="p" id="mwBDo">.</span><span class="nx" id="mwBDs">foo</span><span class="w" id="mwBDw"> </span><span class="o" id="mwBD0">=</span><span class="w" id="mwBD4"> </span><span class="s1" id="mwBD8">'bars'</span><span class="p" id="mwBEA">;</span><span class="w" id="mwBEE"> </span><span class="c1" id="mwBEI">// cannot edit property, silently ignored</span> <span class="nx" id="mwBEM">obj</span><span class="p" id="mwBEQ">.</span><span class="nx" id="mwBEU">foo2</span><span class="w" id="mwBEY"> </span><span class="o" id="mwBEc">=</span><span class="w" id="mwBEg"> </span><span class="s1" id="mwBEk">'bar2'</span><span class="p" id="mwBEo">;</span><span class="w" id="mwBEs"> </span><span class="c1" id="mwBEw">// cannot add property, silently ignored</span>With the implementation of ECMA262, JavaScript has the ability to create immutable references that cannot be reassigned. However, using a const declaration doesn't mean that value of the read-only reference is immutable, just that the name cannot be assigned to a new value.
<span id="mwBFI"></span><span class="kd" id="mwBFM">const</span><span class="w" id="mwBFQ"> </span><span class="nx" id="mwBFU">ALWAYS_IMMUTABLE</span><span class="w" id="mwBFY"> </span><span class="o" id="mwBFc">=</span><span class="w" id="mwBFg"> </span><span class="kc" id="mwBFk">true</span><span class="p" id="mwBFo">;</span> <span class="k" id="mwBFs">try</span><span class="w" id="mwBFw"> </span><span class="p" id="mwBF0">{</span> <span class="w" id="mwBF4"> </span><span class="nx" id="mwBF8">ALWAYS_IMMUTABLE</span><span class="w" id="mwBGA"> </span><span class="o" id="mwBGE">=</span><span class="w" id="mwBGI"> </span><span class="kc" id="mwBGM">false</span><span class="p" id="mwBGQ">;</span> <span class="p" id="mwBGU">}</span><span class="w" id="mwBGY"> </span><span class="k" id="mwBGc">catch</span><span class="w" id="mwBGg"> </span><span class="p" id="mwBGk">(</span><span class="nx" id="mwBGo">err</span><span class="p" id="mwBGs">)</span><span class="w" id="mwBGw"> </span><span class="p" id="mwBG0">{</span> <span class="w" id="mwBG4"> </span><span class="nx" id="mwBG8">console</span><span class="p" id="mwBHA">.</span><span class="nx" id="mwBHE">log</span><span class="p" id="mwBHI">(</span><span class="s2" id="mwBHM">"Can't reassign an immutable reference."</span><span class="p" id="mwBHQ">);</span> <span class="p" id="mwBHU">}</span> <span class="kd" id="mwBHY">const</span><span class="w" id="mwBHc"> </span><span class="nx" id="mwBHg">arr</span><span class="w" id="mwBHk"> </span><span class="o" id="mwBHo">=</span><span class="w" id="mwBHs"> </span><span class="p" id="mwBHw">[</span><span class="mf" id="mwBH0">1</span><span class="p" id="mwBH4">,</span><span class="w" id="mwBH8"> </span><span class="mf" id="mwBIA">2</span><span class="p" id="mwBIE">,</span><span class="w" id="mwBII"> </span><span class="mf" id="mwBIM">3</span><span class="p" id="mwBIQ">];</span> <span class="nx" id="mwBIU">arr</span><span class="p" id="mwBIY">.</span><span class="nx" id="mwBIc">push</span><span class="p" id="mwBIg">(</span><span class="mf" id="mwBIk">4</span><span class="p" id="mwBIo">);</span> <span class="nx" id="mwBIs">console</span><span class="p" id="mwBIw">.</span><span class="nx" id="mwBI0">log</span><span class="p" id="mwBI4">(</span><span class="nx" id="mwBI8">arr</span><span class="p" id="mwBJA">);</span><span class="w" id="mwBJE"> </span><span class="c1" id="mwBJI">// [1, 2, 3, 4]</span>The use of immutable state has become a rising trend in JavaScript since the introduction of React, which favours Flux-like state management patterns such as Redux.
Perl
In Perl, one can create an immutable class with the Moo library by simply declaring all the attributes read only:
<span id="mwBJ8"></span><span class="k" id="mwBKA">package</span><span class="w" id="mwBKE"> </span><span class="nn" id="mwBKI">Immutable</span><span class="p" id="mwBKM">;</span> <span class="k" id="mwBKQ">use</span><span class="w" id="mwBKU"> </span><span class="nn" id="mwBKY">Moo</span><span class="p" id="mwBKc">;</span> <span class="n" id="mwBKg">has</span><span class="w" id="mwBKk"> </span><span class="n" id="mwBKo">value</span><span class="w" id="mwBKs"> </span><span class="o" id="mwBKw">=></span><span class="w" id="mwBK0"> </span><span class="p" id="mwBK4">(</span> <span class="w" id="mwBK8"> </span><span class="n" id="mwBLA">is</span><span class="w" id="mwBLE"> </span><span class="o" id="mwBLI">=></span><span class="w" id="mwBLM"> </span><span class="s" id="mwBLQ">'ro'</span><span class="p" id="mwBLU">,</span><span class="w" id="mwBLY"> </span><span class="c1" id="mwBLc"># read only</span> <span class="w" id="mwBLg"> </span><span class="n" id="mwBLk">default</span><span class="w" id="mwBLo"> </span><span class="o" id="mwBLs">=></span><span class="w" id="mwBLw"> </span><span class="s" id="mwBL0">'data'</span><span class="p" id="mwBL4">,</span><span class="w" id="mwBL8"> </span><span class="c1" id="mwBMA"># can be overridden by supplying the constructor with</span> <span class="w" id="mwBME"> </span><span class="c1" id="mwBMI"># a value: Immutable->new(value => 'something else');</span> <span class="p" id="mwBMM">);</span> <span class="mi" id="mwBMQ">1</span><span class="p" id="mwBMU">;</span>
Creating an immutable class used to require two steps: first, creating accessors (either automatically or manually) that prevent modification of object attributes, and secondly, preventing direct modification of the instance data of instances of that class (this was usually stored in a hash reference, and could be locked with Hash::Util's lock_hash function):
<span id="mwBMk"></span><span class="k" id="mwBMo">package</span><span class="w" id="mwBMs"> </span><span class="nn" id="mwBMw">Immutable</span><span class="p" id="mwBM0">;</span> <span class="k" id="mwBM4">use</span><span class="w" id="mwBM8"> </span><span class="nn" id="mwBNA">strict</span><span class="p" id="mwBNE">;</span> <span class="k" id="mwBNI">use</span><span class="w" id="mwBNM"> </span><span class="nn" id="mwBNQ">warnings</span><span class="p" id="mwBNU">;</span> <span class="k" id="mwBNY">use</span><span class="w" id="mwBNc"> </span><span class="nn" id="mwBNg">base</span><span class="w" id="mwBNk"> </span><span class="sx" id="mwBNo">qw(Class::Accessor)</span><span class="p" id="mwBNs">;</span> <span class="c1" id="mwBNw"># create read-only accessors</span> <span class="nn" id="mwBN0">__PACKAGE__</span><span class="o" id="mwBN4">-></span><span class="n" id="mwBN8">mk_ro_accessors</span><span class="p" id="mwBOA">(</span><span class="sx" id="mwBOE">qw(value)</span><span class="p" id="mwBOI">);</span> <span class="k" id="mwBOM">use</span><span class="w" id="mwBOQ"> </span><span class="nn" id="mwBOU">Hash::Util</span><span class="w" id="mwBOY"> </span><span class="s" id="mwBOc">'lock_hash'</span><span class="p" id="mwBOg">;</span> <span class="k" id="mwBOk">sub</span><span class="w" id="mwBOo"> </span><span class="nf" id="mwBOs">new</span><span class="w" id="mwBOw"> </span><span class="p" id="mwBO0">{</span> <span class="w" id="mwBO4"> </span><span class="k" id="mwBO8">my</span><span class="w" id="mwBPA"> </span><span class="nv" id="mwBPE">$class</span><span class="w" id="mwBPI"> </span><span class="o" id="mwBPM">=</span><span class="w" id="mwBPQ"> </span><span class="nb" id="mwBPU">shift</span><span class="p" id="mwBPY">;</span> <span class="w" id="mwBPc"> </span><span class="k" id="mwBPg">return</span><span class="w" id="mwBPk"> </span><span class="nv" id="mwBPo">$class</span><span class="w" id="mwBPs"> </span><span class="k" id="mwBPw">if</span><span class="w" id="mwBP0"> </span><span class="nb" id="mwBP4">ref</span><span class="p" id="mwBP8">(</span><span class="nv" id="mwBQA">$class</span><span class="p" id="mwBQE">);</span> <span class="w" id="mwBQI"> </span><span class="nb" id="mwBQM">die</span><span class="w" id="mwBQQ"> </span><span class="s" id="mwBQU">"Arguments to new must be key => value pairs\n"</span> <span class="w" id="mwBQY"> </span><span class="k" id="mwBQc">unless</span><span class="w" id="mwBQg"> </span><span class="p" id="mwBQk">(</span><span class="nv" id="mwBQo">@_</span><span class="w" id="mwBQs"> </span><span class="nv" id="mwBQw">%</span><span class="w" id="mwBQ0"> </span><span class="nv" id="mwBQ4">2</span><span class="w" id="mwBQ8"> </span><span class="o" id="mwBRA">==</span><span class="w" id="mwBRE"> </span><span class="mi" id="mwBRI">0</span><span class="p" id="mwBRM">);</span> <span class="w" id="mwBRQ"> </span><span class="k" id="mwBRU">my</span><span class="w" id="mwBRY"> </span><span class="nv" id="mwBRc">%defaults</span><span class="w" id="mwBRg"> </span><span class="o" id="mwBRk">=</span><span class="w" id="mwBRo"> </span><span class="p" id="mwBRs">(</span> <span class="w" id="mwBRw"> </span><span class="n" id="mwBR0">value</span><span class="w" id="mwBR4"> </span><span class="o" id="mwBR8">=></span><span class="w" id="mwBSA"> </span><span class="s" id="mwBSE">'data'</span><span class="p" id="mwBSI">,</span> <span class="w" id="mwBSM"> </span><span class="p" id="mwBSQ">);</span> <span class="w" id="mwBSU"> </span><span class="k" id="mwBSY">my</span><span class="w" id="mwBSc"> </span><span class="nv" id="mwBSg">$obj</span><span class="w" id="mwBSk"> </span><span class="o" id="mwBSo">=</span><span class="w" id="mwBSs"> </span><span class="p" id="mwBSw">{</span> <span class="w" id="mwBS0"> </span><span class="nv" id="mwBS4">%defaults</span><span class="p" id="mwBS8">,</span> <span class="w" id="mwBTA"> </span><span class="nv" id="mwBTE">@_</span><span class="p" id="mwBTI">,</span> <span class="w" id="mwBTM"> </span><span class="p" id="mwBTQ">};</span> <span class="w" id="mwBTU"> </span><span class="nb" id="mwBTY">bless</span><span class="w" id="mwBTc"> </span><span class="nv" id="mwBTg">$obj</span><span class="p" id="mwBTk">,</span><span class="w" id="mwBTo"> </span><span class="nv" id="mwBTs">$class</span><span class="p" id="mwBTw">;</span> <span class="w" id="mwBT0"> </span><span class="c1" id="mwBT4"># prevent modification of the object data</span> <span class="w" id="mwBT8"> </span><span class="n" id="mwBUA">lock_hash</span><span class="w" id="mwBUE"> </span><span class="nv" id="mwBUI">%$obj</span><span class="p" id="mwBUM">;</span> <span class="p" id="mwBUQ">}</span> <span class="mi" id="mwBUU">1</span><span class="p" id="mwBUY">;</span>Or, with a manually written accessor:
<span id="mwBUo"></span><span class="k" id="mwBUs">package</span><span class="w" id="mwBUw"> </span><span class="nn" id="mwBU0">Immutable</span><span class="p" id="mwBU4">;</span> <span class="k" id="mwBU8">use</span><span class="w" id="mwBVA"> </span><span class="nn" id="mwBVE">strict</span><span class="p" id="mwBVI">;</span> <span class="k" id="mwBVM">use</span><span class="w" id="mwBVQ"> </span><span class="nn" id="mwBVU">warnings</span><span class="p" id="mwBVY">;</span> <span class="k" id="mwBVc">use</span><span class="w" id="mwBVg"> </span><span class="nn" id="mwBVk">Hash::Util</span><span class="w" id="mwBVo"> </span><span class="s" id="mwBVs">'lock_hash'</span><span class="p" id="mwBVw">;</span> <span class="k" id="mwBV0">sub</span><span class="w" id="mwBV4"> </span><span class="nf" id="mwBV8">new</span><span class="w" id="mwBWA"> </span><span class="p" id="mwBWE">{</span> <span class="w" id="mwBWI"> </span><span class="k" id="mwBWM">my</span><span class="w" id="mwBWQ"> </span><span class="nv" id="mwBWU">$class</span><span class="w" id="mwBWY"> </span><span class="o" id="mwBWc">=</span><span class="w" id="mwBWg"> </span><span class="nb" id="mwBWk">shift</span><span class="p" id="mwBWo">;</span> <span class="w" id="mwBWs"> </span><span class="k" id="mwBWw">return</span><span class="w" id="mwBW0"> </span><span class="nv" id="mwBW4">$class</span><span class="w" id="mwBW8"> </span><span class="k" id="mwBXA">if</span><span class="w" id="mwBXE"> </span><span class="nb" id="mwBXI">ref</span><span class="p" id="mwBXM">(</span><span class="nv" id="mwBXQ">$class</span><span class="p" id="mwBXU">);</span> <span class="w" id="mwBXY"> </span><span class="nb" id="mwBXc">die</span><span class="w" id="mwBXg"> </span><span class="s" id="mwBXk">"Arguments to new must be key => value pairs\n"</span> <span class="w" id="mwBXo"> </span><span class="k" id="mwBXs">unless</span><span class="w" id="mwBXw"> </span><span class="p" id="mwBX0">(</span><span class="nv" id="mwBX4">@_</span><span class="w" id="mwBX8"> </span><span class="nv" id="mwBYA">%</span><span class="w" id="mwBYE"> </span><span class="nv" id="mwBYI">2</span><span class="w" id="mwBYM"> </span><span class="o" id="mwBYQ">==</span><span class="w" id="mwBYU"> </span><span class="mi" id="mwBYY">0</span><span class="p" id="mwBYc">);</span> <span class="w" id="mwBYg"> </span><span class="k" id="mwBYk">my</span><span class="w" id="mwBYo"> </span><span class="nv" id="mwBYs">%defaults</span><span class="w" id="mwBYw"> </span><span class="o" id="mwBY0">=</span><span class="w" id="mwBY4"> </span><span class="p" id="mwBY8">(</span> <span class="w" id="mwBZA"> </span><span class="n" id="mwBZE">value</span><span class="w" id="mwBZI"> </span><span class="o" id="mwBZM">=></span><span class="w" id="mwBZQ"> </span><span class="s" id="mwBZU">'data'</span><span class="p" id="mwBZY">,</span> <span class="w" id="mwBZc"> </span><span class="p" id="mwBZg">);</span> <span class="w" id="mwBZk"> </span><span class="k" id="mwBZo">my</span><span class="w" id="mwBZs"> </span><span class="nv" id="mwBZw">$obj</span><span class="w" id="mwBZ0"> </span><span class="o" id="mwBZ4">=</span><span class="w" id="mwBZ8"> </span><span class="p" id="mwBaA">{</span> <span class="w" id="mwBaE"> </span><span class="nv" id="mwBaI">%defaults</span><span class="p" id="mwBaM">,</span> <span class="w" id="mwBaQ"> </span><span class="nv" id="mwBaU">@_</span><span class="p" id="mwBaY">,</span> <span class="w" id="mwBac"> </span><span class="p" id="mwBag">};</span> <span class="w" id="mwBak"> </span><span class="nb" id="mwBao">bless</span><span class="w" id="mwBas"> </span><span class="nv" id="mwBaw">$obj</span><span class="p" id="mwBa0">,</span><span class="w" id="mwBa4"> </span><span class="nv" id="mwBa8">$class</span><span class="p" id="mwBbA">;</span> <span class="w" id="mwBbE"> </span><span class="c1" id="mwBbI"># prevent modification of the object data</span> <span class="w" id="mwBbM"> </span><span class="n" id="mwBbQ">lock_hash</span><span class="w" id="mwBbU"> </span><span class="nv" id="mwBbY">%$obj</span><span class="p" id="mwBbc">;</span> <span class="p" id="mwBbg">}</span> <span class="c1" id="mwBbk"># read-only accessor</span> <span class="k" id="mwBbo">sub</span><span class="w" id="mwBbs"> </span><span class="nf" id="mwBbw">value</span><span class="w" id="mwBb0"> </span><span class="p" id="mwBb4">{</span> <span class="w" id="mwBb8"> </span><span class="k" id="mwBcA">my</span><span class="w" id="mwBcE"> </span><span class="nv" id="mwBcI">$self</span><span class="w" id="mwBcM"> </span><span class="o" id="mwBcQ">=</span><span class="w" id="mwBcU"> </span><span class="nb" id="mwBcY">shift</span><span class="p" id="mwBcc">;</span> <span class="w" id="mwBcg"> </span><span class="k" id="mwBck">if</span><span class="w" id="mwBco"> </span><span class="p" id="mwBcs">(</span><span class="k" id="mwBcw">my</span><span class="w" id="mwBc0"> </span><span class="nv" id="mwBc4">$new_value</span><span class="w" id="mwBc8"> </span><span class="o" id="mwBdA">=</span><span class="w" id="mwBdE"> </span><span class="nb" id="mwBdI">shift</span><span class="p" id="mwBdM">)</span><span class="w" id="mwBdQ"> </span><span class="p" id="mwBdU">{</span> <span class="w" id="mwBdY"> </span><span class="c1" id="mwBdc"># trying to set a new value</span> <span class="w" id="mwBdg"> </span><span class="nb" id="mwBdk">die</span><span class="w" id="mwBdo"> </span><span class="s" id="mwBds">"This object cannot be modified\n"</span><span class="p" id="mwBdw">;</span> <span class="w" id="mwBd0"> </span><span class="p" id="mwBd4">}</span><span class="w" id="mwBd8"> </span><span class="k" id="mwBeA">else</span><span class="w" id="mwBeE"> </span><span class="p" id="mwBeI">{</span> <span class="w" id="mwBeM"> </span><span class="k" id="mwBeQ">return</span><span class="w" id="mwBeU"> </span><span class="nv" id="mwBeY">$self</span><span class="o" id="mwBec">-></span><span class="p" id="mwBeg">{</span><span class="n" id="mwBek">value</span><span class="p" id="mwBeo">}</span> <span class="w" id="mwBes"> </span><span class="p" id="mwBew">}</span> <span class="p" id="mwBe0">}</span> <span class="mi" id="mwBe4">1</span><span class="p" id="mwBe8">;</span>PHP
In PHP have readonly properties since version 8.1 and readonly classes since version 8.2.
<span id="mwBf0"></span><span class="k" id="mwBf4">readonly</span> <span class="k" id="mwBf8">class</span> <span class="nc" id="mwBgA">BlogData</span> <span class="p" id="mwBgE">{</span> <span class="k" id="mwBgI">public</span> <span class="nx" id="mwBgM">string</span> <span class="nv" id="mwBgQ">$title</span><span class="p" id="mwBgU">;</span> <span class="k" id="mwBgY">public</span> <span class="nx" id="mwBgc">Status</span> <span class="nv" id="mwBgg">$status</span><span class="p" id="mwBgk">;</span> <span class="k" id="mwBgo">public</span> <span class="k" id="mwBgs">function</span> <span class="fm" id="mwBgw">__construct</span><span class="p" id="mwBg0">(</span><span class="nx" id="mwBg4">string</span> <span class="nv" id="mwBg8">$title</span><span class="p" id="mwBhA">,</span> <span class="nx" id="mwBhE">Status</span> <span class="nv" id="mwBhI">$status</span><span class="p" id="mwBhM">)</span> <span class="p" id="mwBhQ">{</span> <span class="nv" id="mwBhU">$this</span><span class="o" id="mwBhY">-></span><span class="na" id="mwBhc">title</span> <span class="o" id="mwBhg">=</span> <span class="nv" id="mwBhk">$title</span><span class="p" id="mwBho">;</span> <span class="nv" id="mwBhs">$this</span><span class="o" id="mwBhw">-></span><span class="na" id="mwBh0">status</span> <span class="o" id="mwBh4">=</span> <span class="nv" id="mwBh8">$status</span><span class="p" id="mwBiA">;</span> <span class="p" id="mwBiE">}</span> <span class="p" id="mwBiI">}</span>Python
In Python, some built-in types (numbers, Booleans, strings, tuples, frozensets) are immutable, but custom classes are generally mutable. To simulate immutability in a class, one could override attribute setting and deletion to raise exceptions:
<span id="mwBig"></span><span class="kn" id="mwBik">from</span><span class="w" id="mwBio"> </span><span class="nn" id="mwBis">typing</span><span class="w" id="mwBiw"> </span><span class="kn" id="mwBi0">import</span> <span class="n" id="mwBi4">Any</span><span class="p" id="mwBi8">,</span> <span class="n" id="mwBjA">NoReturn</span> <span class="k" id="mwBjE">class</span><span class="w" id="mwBjI"> </span><span class="nc" id="mwBjM">ImmutablePoint</span><span class="p" id="mwBjQ">:</span> <span class="w" id="mwBjU"> </span><span class="sd" id="mwBjY">"""An immutable class with two attributes 'x' and 'y'."""</span> <span class="vm" id="mwBjc">__slots__</span><span class="p" id="mwBjg">:</span> <span class="nb" id="mwBjk">list</span><span class="p" id="mwBjo">[</span><span class="nb" id="mwBjs">str</span><span class="p" id="mwBjw">]</span> <span class="o" id="mwBj0">=</span> <span class="p" id="mwBj4">[</span><span class="s2" id="mwBj8">"x"</span><span class="p" id="mwBkA">,</span> <span class="s2" id="mwBkE">"y"</span><span class="p" id="mwBkI">]</span> <span class="k" id="mwBkM">def</span><span class="w" id="mwBkQ"> </span><span class="fm" id="mwBkU">__setattr__</span><span class="p" id="mwBkY">(</span><span class="bp" id="mwBkc">self</span><span class="p" id="mwBkg">,</span> <span class="o" id="mwBkk">*</span><span class="n" id="mwBko">args</span><span class="p" id="mwBks">:</span> <span class="nb" id="mwBkw">tuple</span><span class="p" id="mwBk0">[</span><span class="n" id="mwBk4">Any</span><span class="p" id="mwBk8">,</span> <span class="o" id="mwBlA">...</span><span class="p" id="mwBlE">])</span> <span class="o" id="mwBlI">-></span> <span class="n" id="mwBlM">NoReturn</span><span class="p" id="mwBlQ">:</span> <span class="k" id="mwBlU">raise</span> <span class="ne" id="mwBlY">TypeError</span><span class="p" id="mwBlc">(</span><span class="s2" id="mwBlg">"Can not modify immutable instance."</span><span class="p" id="mwBlk">)</span> <span class="fm" id="mwBlo">__delattr__</span><span class="p" id="mwBls">:</span> <span class="n" id="mwBlw">Callable</span><span class="p" id="mwBl0">[[</span><span class="n" id="mwBl4">Tuple</span><span class="p" id="mwBl8">[</span><span class="n" id="mwBmA">Any</span><span class="p" id="mwBmE">,</span> <span class="o" id="mwBmI">...</span><span class="p" id="mwBmM">]],</span> <span class="n" id="mwBmQ">NoReturn</span><span class="p" id="mwBmU">]</span> <span class="o" id="mwBmY">=</span> <span class="fm" id="mwBmc">__setattr__</span> <span class="k" id="mwBmg">def</span><span class="w" id="mwBmk"> </span><span class="fm" id="mwBmo">__init__</span><span class="p" id="mwBms">(</span><span class="bp" id="mwBmw">self</span><span class="p" id="mwBm0">,</span> <span class="n" id="mwBm4">x</span><span class="p" id="mwBm8">:</span> <span class="nb" id="mwBnA">int</span><span class="p" id="mwBnE">,</span> <span class="n" id="mwBnI">y</span><span class="p" id="mwBnM">:</span> <span class="nb" id="mwBnQ">int</span><span class="p" id="mwBnU">)</span> <span class="o" id="mwBnY">-></span> <span class="kc" id="mwBnc">None</span><span class="p" id="mwBng">:</span> <span class="c1" id="mwBnk"># We can no longer use self.value = value to store the instance data</span> <span class="c1" id="mwBno"># so we must explicitly call the superclass</span> <span class="nb" id="mwBns">super</span><span class="p" id="mwBnw">()</span><span class="o" id="mwBn0">.</span><span class="fm" id="mwBn4">__setattr__</span><span class="p" id="mwBn8">(</span><span class="s2" id="mwBoA">"x"</span><span class="p" id="mwBoE">,</span> <span class="n" id="mwBoI">x</span><span class="p" id="mwBoM">)</span> <span class="nb" id="mwBoQ">super</span><span class="p" id="mwBoU">()</span><span class="o" id="mwBoY">.</span><span class="fm" id="mwBoc">__setattr__</span><span class="p" id="mwBog">(</span><span class="s2" id="mwBok">"y"</span><span class="p" id="mwBoo">,</span> <span class="n" id="mwBos">y</span><span class="p" id="mwBow">)</span>
The standard library helpers collections.namedtuple and typing.NamedTuple, available from Python 3.6 onward, create simple immutable classes. The following example is roughly equivalent to the above, plus some tuple-like features:
<span id="mwBpQ"></span><span class="kn" id="mwBpU">from</span><span class="w" id="mwBpY"> </span><span class="nn" id="mwBpc">typing</span><span class="w" id="mwBpg"> </span><span class="kn" id="mwBpk">import</span> <span class="n" id="mwBpo">NamedTuple</span> <span class="kn" id="mwBps">import</span><span class="w" id="mwBpw"> </span><span class="nn" id="mwBp0">collections</span> <span class="n" id="mwBp4">Point</span><span class="p" id="mwBp8">:</span> <span class="n" id="mwBqA">NamedTuple</span> <span class="o" id="mwBqE">=</span> <span class="n" id="mwBqI">collections</span><span class="o" id="mwBqM">.</span><span class="n" id="mwBqQ">namedtuple</span><span class="p" id="mwBqU">(</span><span class="s2" id="mwBqY">"Point"</span><span class="p" id="mwBqc">,</span> <span class="p" id="mwBqg">[</span><span class="s2" id="mwBqk">"x"</span><span class="p" id="mwBqo">,</span> <span class="s2" id="mwBqs">"y"</span><span class="p" id="mwBqw">])</span> <span class="c1" id="mwBq0"># the following creates a similar namedtuple to the above</span> <span class="k" id="mwBq4">class</span><span class="w" id="mwBq8"> </span><span class="nc" id="mwBrA">Point</span><span class="p" id="mwBrE">(</span><span class="n" id="mwBrI">NamedTuple</span><span class="p" id="mwBrM">):</span> <span class="n" id="mwBrQ">x</span><span class="p" id="mwBrU">:</span> <span class="nb" id="mwBrY">int</span> <span class="n" id="mwBrc">y</span><span class="p" id="mwBrg">:</span> <span class="nb" id="mwBrk">int</span>
Introduced in Python 3.7, dataclasses allow developers to emulate immutability with frozen instances. If a frozen dataclass is built, dataclasses will override __setattr__() and __delattr__() to raise FrozenInstanceError if invoked.
<span id="mwBsQ"></span><span class="kn" id="mwBsU">from</span><span class="w" id="mwBsY"> </span><span class="nn" id="mwBsc">dataclasses</span><span class="w" id="mwBsg"> </span><span class="kn" id="mwBsk">import</span> <span class="n" id="mwBso">dataclass</span> <span class="nd" id="mwBss">@dataclass</span><span class="p" id="mwBsw">(</span><span class="n" id="mwBs0">frozen</span><span class="o" id="mwBs4">=</span><span class="kc" id="mwBs8">True</span><span class="p" id="mwBtA">)</span> <span class="k" id="mwBtE">class</span><span class="w" id="mwBtI"> </span><span class="nc" id="mwBtM">Point</span><span class="p" id="mwBtQ">:</span> <span class="n" id="mwBtU">x</span><span class="p" id="mwBtY">:</span> <span class="nb" id="mwBtc">int</span> <span class="n" id="mwBtg">y</span><span class="p" id="mwBtk">:</span> <span class="nb" id="mwBto">int</span>
Racket
Racket substantially diverges from other Scheme implementations by making its core pair type ("cons cells") immutable. Instead, it provides a parallel mutable pair type, via mcons, mcar, set-mcar! etc. In addition, many immutable types are supported, for example, immutable strings and vectors, and these are used extensively. New structs are immutable by default, unless a field is specifically declared mutable, or the whole struct:
<span id="mwBuQ"></span><span class="p" id="mwBuU">(</span><span class="k" id="mwBuY">struct</span><span class="w" id="mwBuc"> </span><span class="n" id="mwBug">foo1</span><span class="w" id="mwBuk"> </span><span class="p" id="mwBuo">(</span><span class="n" id="mwBus">x</span><span class="w" id="mwBuw"> </span><span class="n" id="mwBu0">y</span><span class="p" id="mwBu4">))</span><span class="w" id="mwBu8"> </span><span class="c1" id="mwBvA">; all fields immutable</span> <span class="p" id="mwBvE">(</span><span class="k" id="mwBvI">struct</span><span class="w" id="mwBvM"> </span><span class="n" id="mwBvQ">foo2</span><span class="w" id="mwBvU"> </span><span class="p" id="mwBvY">(</span><span class="n" id="mwBvc">x</span><span class="w" id="mwBvg"> </span><span class="p" id="mwBvk">[</span><span class="n" id="mwBvo">y</span><span class="w" id="mwBvs"> </span><span class="kd" id="mwBvw">#:mutable</span><span class="p" id="mwBv0">]))</span><span class="w" id="mwBv4"> </span><span class="c1" id="mwBv8">; one mutable field</span> <span class="p" id="mwBwA">(</span><span class="k" id="mwBwE">struct</span><span class="w" id="mwBwI"> </span><span class="n" id="mwBwM">foo3</span><span class="w" id="mwBwQ"> </span><span class="p" id="mwBwU">(</span><span class="n" id="mwBwY">x</span><span class="w" id="mwBwc"> </span><span class="n" id="mwBwg">y</span><span class="p" id="mwBwk">)</span><span class="w" id="mwBwo"> </span><span class="kd" id="mwBws">#:mutable</span><span class="p" id="mwBww">)</span><span class="w" id="mwBw0"> </span><span class="c1" id="mwBw4">; all fields mutable</span>
The language also supports immutable hash tables, implemented functionally, and immutable dictionaries.
Rust
Rust's ownership system allows developers to declare immutable variables, and pass immutable references. By default, all variables and references are immutable. Mutable variables and references are explicitly created with the mut keyword.
Constant items in Rust are always immutable.
<span id="mwBxg"></span><span class="c1" id="mwBxk">// constant items are always immutable</span> <span class="k" id="mwBxo">const</span><span class="w" id="mwBxs"> </span><span class="n" id="mwBxw">ALWAYS_IMMUTABLE</span><span class="p" id="mwBx0">:</span><span class="w" id="mwBx4"> </span><span class="kt" id="mwBx8">bool</span><span class="w" id="mwByA"> </span><span class="o" id="mwByE">=</span><span class="w" id="mwByI"> </span><span class="kc" id="mwByM">true</span><span class="p" id="mwByQ">;</span> <span class="k" id="mwByU">struct</span><span class="w" id="mwByY"> </span><span class="nc" id="mwByc">MyPair</span><span class="w" id="mwByg"> </span><span class="p" id="mwByk">{</span> <span class="w" id="mwByo"> </span><span class="n" id="mwBys">x</span><span class="p" id="mwByw">:</span><span class="w" id="mwBy0"> </span><span class="kt" id="mwBy4">usize</span><span class="p" id="mwBy8">,</span> <span class="w" id="mwBzA"> </span><span class="n" id="mwBzE">y</span><span class="p" id="mwBzI">:</span><span class="w" id="mwBzM"> </span><span class="kt" id="mwBzQ">usize</span><span class="p" id="mwBzU">,</span> <span class="p" id="mwBzY">}</span> <span class="k" id="mwBzc">fn</span><span class="w" id="mwBzg"> </span><span class="nf" id="mwBzk">main</span><span class="p" id="mwBzo">()</span><span class="w" id="mwBzs"> </span><span class="p" id="mwBzw">{</span> <span class="w" id="mwBz0"> </span><span class="c1" id="mwBz4">// explicitly declare a mutable variable</span> <span class="w" id="mwBz8"> </span><span class="kd" id="mwB0A">let</span><span class="w" id="mwB0E"> </span><span class="k" id="mwB0I">mut</span><span class="w" id="mwB0M"> </span><span class="n" id="mwB0Q">mutable_obj</span><span class="w" id="mwB0U"> </span><span class="o" id="mwB0Y">=</span><span class="w" id="mwB0c"> </span><span class="n" id="mwB0g">MyPair</span><span class="w" id="mwB0k"> </span><span class="p" id="mwB0o">{</span><span class="w" id="mwB0s"> </span><span class="n" id="mwB0w">x</span><span class="p" id="mwB00">:</span><span class="w" id="mwB04"> </span><span class="mi" id="mwB08">1</span><span class="p" id="mwB1A">,</span><span class="w" id="mwB1E"> </span><span class="n" id="mwB1I">y</span><span class="p" id="mwB1M">:</span><span class="w" id="mwB1Q"> </span><span class="mi" id="mwB1U">2</span><span class="w" id="mwB1Y"> </span><span class="p" id="mwB1c">};</span> <span class="w" id="mwB1g"> </span><span class="n" id="mwB1k">mutable_obj</span><span class="p" id="mwB1o">.</span><span class="n" id="mwB1s">x</span><span class="w" id="mwB1w"> </span><span class="o" id="mwB10">=</span><span class="w" id="mwB14"> </span><span class="mi" id="mwB18">3</span><span class="p" id="mwB2A">;</span><span class="w" id="mwB2E"> </span><span class="c1" id="mwB2I">// okay</span> <span class="w" id="mwB2M"> </span><span class="kd" id="mwB2Q">let</span><span class="w" id="mwB2U"> </span><span class="n" id="mwB2Y">mutable_ref</span><span class="w" id="mwB2c"> </span><span class="o" id="mwB2g">=</span><span class="w" id="mwB2k"> </span><span class="o" id="mwB2o">&</span><span class="k" id="mwB2s">mut</span><span class="w" id="mwB2w"> </span><span class="n" id="mwB20">mutable_obj</span><span class="p" id="mwB24">;</span> <span class="w" id="mwB28"> </span><span class="n" id="mwB3A">mutable_ref</span><span class="p" id="mwB3E">.</span><span class="n" id="mwB3I">x</span><span class="w" id="mwB3M"> </span><span class="o" id="mwB3Q">=</span><span class="w" id="mwB3U"> </span><span class="mi" id="mwB3Y">1</span><span class="p" id="mwB3c">;</span><span class="w" id="mwB3g"> </span><span class="c1" id="mwB3k">// okay</span> <span class="w" id="mwB3o"> </span><span class="kd" id="mwB3s">let</span><span class="w" id="mwB3w"> </span><span class="n" id="mwB30">immutable_ref</span><span class="w" id="mwB34"> </span><span class="o" id="mwB38">=</span><span class="w" id="mwB4A"> </span><span class="o" id="mwB4E">&</span><span class="n" id="mwB4I">mutable_obj</span><span class="p" id="mwB4M">;</span> <span class="w" id="mwB4Q"> </span><span class="n" id="mwB4U">immutable_ref</span><span class="p" id="mwB4Y">.</span><span class="n" id="mwB4c">x</span><span class="w" id="mwB4g"> </span><span class="o" id="mwB4k">=</span><span class="w" id="mwB4o"> </span><span class="mi" id="mwB4s">3</span><span class="p" id="mwB4w">;</span><span class="w" id="mwB40"> </span><span class="c1" id="mwB44">// error E0594</span> <span class="w" id="mwB48"> </span><span class="c1" id="mwB5A">// by default, variables are immutable</span> <span class="w" id="mwB5E"> </span><span class="kd" id="mwB5I">let</span><span class="w" id="mwB5M"> </span><span class="n" id="mwB5Q">immutable_obj</span><span class="w" id="mwB5U"> </span><span class="o" id="mwB5Y">=</span><span class="w" id="mwB5c"> </span><span class="n" id="mwB5g">MyPair</span><span class="w" id="mwB5k"> </span><span class="p" id="mwB5o">{</span><span class="w" id="mwB5s"> </span><span class="n" id="mwB5w">x</span><span class="p" id="mwB50">:</span><span class="w" id="mwB54"> </span><span class="mi" id="mwB58">4</span><span class="p" id="mwB6A">,</span><span class="w" id="mwB6E"> </span><span class="n" id="mwB6I">y</span><span class="p" id="mwB6M">:</span><span class="w" id="mwB6Q"> </span><span class="mi" id="mwB6U">5</span><span class="w" id="mwB6Y"> </span><span class="p" id="mwB6c">};</span> <span class="w" id="mwB6g"> </span><span class="n" id="mwB6k">immutable_obj</span><span class="p" id="mwB6o">.</span><span class="n" id="mwB6s">x</span><span class="w" id="mwB6w"> </span><span class="o" id="mwB60">=</span><span class="w" id="mwB64"> </span><span class="mi" id="mwB68">6</span><span class="p" id="mwB7A">;</span><span class="w" id="mwB7E"> </span><span class="c1" id="mwB7I">// error E0596</span> <span class="w" id="mwB7M"> </span><span class="kd" id="mwB7Q">let</span><span class="w" id="mwB7U"> </span><span class="n" id="mwB7Y">mutable_ref2</span><span class="w" id="mwB7c"> </span><span class="o" id="mwB7g">=</span><span class="w" id="mwB7k"> </span><span class="o" id="mwB7o">&</span><span class="k" id="mwB7s">mut</span><span class="w" id="mwB7w"> </span><span class="n" id="mwB70">immutable_obj</span><span class="p" id="mwB74">;</span><span class="w" id="mwB78"> </span><span class="c1" id="mwB8A">// error E0596</span> <span class="w" id="mwB8E"> </span><span class="kd" id="mwB8I">let</span><span class="w" id="mwB8M"> </span><span class="n" id="mwB8Q">immutable_ref2</span><span class="w" id="mwB8U"> </span><span class="o" id="mwB8Y">=</span><span class="w" id="mwB8c"> </span><span class="o" id="mwB8g">&</span><span class="n" id="mwB8k">immutable_obj</span><span class="p" id="mwB8o">;</span> <span class="w" id="mwB8s"> </span><span class="n" id="mwB8w">immutable_ref2</span><span class="p" id="mwB80">.</span><span class="n" id="mwB84">x</span><span class="w" id="mwB88"> </span><span class="o" id="mwB9A">=</span><span class="w" id="mwB9E"> </span><span class="mi" id="mwB9I">6</span><span class="p" id="mwB9M">;</span><span class="w" id="mwB9Q"> </span><span class="c1" id="mwB9U">// error E0594</span> <span class="w" id="mwB9Y"> </span> <span class="p" id="mwB9c">}</span>Scala
In Scala, any entity (narrowly, a binding) can be defined as mutable or immutable: in the declaration, one can use val (value) for immutable entities and var (variable) for mutable ones. Note that even though an immutable binding can not be reassigned, it may still refer to a mutable object and it is still possible to call mutating methods on that object: the binding is immutable, but the underlying object may be mutable.
For example, the following code snippet:
<span id="mwB-I"></span><span class="kd" id="mwB-M">val</span><span class="w" id="mwB-Q"> </span><span class="n" id="mwB-U">maxValue</span><span class="w" id="mwB-Y"> </span><span class="o" id="mwB-c">=</span><span class="w" id="mwB-g"> </span><span class="mi" id="mwB-k">100</span> <span class="kd" id="mwB-o">var</span><span class="w" id="mwB-s"> </span><span class="n" id="mwB-w">currentValue</span><span class="w" id="mwB-0"> </span><span class="o" id="mwB-4">=</span><span class="w" id="mwB-8"> </span><span class="mi" id="mwB_A">1</span>
defines an immutable entity maxValue (the integer type is inferred at compile-time) and a mutable entity named currentValue.
By default, collection classes such as List and Map are immutable, so update-methods return a new instance rather than mutating an existing one. While this may sound inefficient, the implementation of these classes and their guarantees of immutability mean that the new instance can re-use existing nodes, which, especially in the case of creating copies, is very efficient.

