Template:Short description Template:Redirect Template:More citations needed In computer science, boxing (a.k.a. wrapping) is the transformation of placing a primitive type within an object so that the value can be used as a reference. Unboxing is the reverse transformation of extracting the primitive value from its wrapper object. Autoboxing is the term for automatically applying boxing and/or unboxing transformations as needed.
BoxingEdit
Boxing's most prominent use is in Java where there is a distinction between reference and value types for reasons such as runtime efficiency and syntax and semantic issues. In Java, a Template:Java can only store values of type Template:Java. One might desire to have a Template:Java of Template:Java, but this is not directly possible. Instead Java defines primitive wrapper classes corresponding to each primitive type: Template:Java and Template:Java, Template:Java and Template:Java, Template:Java and Template:Java, etc. One can then define a Template:Java using the boxed type Template:Java and insert Template:Java values into the list by boxing them as Template:Java objects. (Using generic parameterized types introduced in J2SE 5.0, this type is represented as Template:Java.)
On the other hand, C# has no primitive wrapper classes, but allows boxing of any value type, returning a generic Template:C sharp reference. In Objective-C, any primitive value can be prefixed by a Template:ObjC to make an Template:ObjC out of it (e.g. Template:ObjC or Template:ObjC). This allows for adding them in any of the standard collections, such as an Template:ObjC.
Haskell has little or no notion of reference type, but still uses the term "boxed" for the runtime system's uniform pointer-to-tagged union representation.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>
The boxed object is always a copy of the value object, and is usually immutable. Unboxing the object also returns a copy of the stored value. Repeated boxing and unboxing of objects can have a severe performance impact, because boxing dynamically allocates new objects and unboxing (if the boxed value is no longer used) then makes them eligible for garbage collection. However, modern garbage collectors such as the default Java HotSpot garbage collector can more efficiently collect short-lived objects, so if the boxed objects are short-lived, the performance impact may not be severe.
In some languages, there is a direct equivalence between an unboxed primitive type and a reference to an immutable, boxed object type. In fact, it is possible to substitute all the primitive types in a program with boxed object types. Whereas assignment from one primitive to another will copy its value, assignment from one reference to a boxed object to another will copy the reference value to refer to the same object as the first reference. However, this will not cause any problems, because the objects are immutable, so there is semantically no real difference between two references to the same object or to different objects (unless you look at physical equality). For all operations other than assignment, such as arithmetic, comparison, and logical operators, one can unbox the boxed type, perform the operation, and re-box the result as needed. Thus, it is possible to not store primitive types at all.
AutoboxingEdit
Autoboxing is the term for getting a reference type out of a value type just through type conversion (either implicit or explicit). The compiler automatically supplies the extra source code that creates the object.
For example, in versions of Java prior to J2SE 5.0, the following code did not compile:
<syntaxhighlight lang=Java> Integer i = new Integer(9); Integer i = 9; // error in versions prior to 5.0! </syntaxhighlight>
Compilers prior to 5.0 would not accept the last line. Template:Java are reference objects, on the surface no different from Template:Java, Template:Java, and so forth. To convert from an Template:Java to an Template:Java, one had to "manually" instantiate the Integer object. As of J2SE 5.0, the compiler will accept the last line, and automatically transform it so that an Integer object is created to store the value Template:Java.<ref>oracle.com Java language guide entry on autoboxing</ref> This means that, from J2SE 5.0 on, something like Template:Java, where Template:Java and Template:Java are Template:Java themselves, will compile now — a and b are unboxed, the integer values summed up, and the result is autoboxed into a new Template:Java, which is finally stored inside variable Template:Java. The equality operators cannot be used this way, because the equality operators are already defined for reference types, for equality of the references; to test for equality of the value in a boxed type, one must still manually unbox them and compare the primitives, or use the Template:Java method.
Another example: J2SE 5.0 allows the programmer to treat a collection (such as a Template:Java) as if it contained Template:Java values instead of Template:Java objects. This does not contradict what was said above: the collection still only contains references to dynamic objects, and it cannot list primitive types. It cannot be a Template:Java, but it must be a Template:Java instead. However, the compiler automatically transforms the code so that the list will "silently" receive objects, while the source code only mentions primitive values. For example, the programmer can now write Template:Java and think as if the Template:Java Template:Java were added to the list; but, the compiler will have actually transformed the line into Template:Java.
Automatic unboxingEdit
With automatic unboxing the compiler automatically supplies the extra source code that retrieves the value out of that object, either by invoking some method on that object, or by other means.
For example, in versions of Java prior to J2SE 5.0, the following code did not compile:
<syntaxhighlight lang=Java> Integer k = new Integer(4); int l = k.intValue(); // always okay int m = k; // would have been an error, but okay now </syntaxhighlight>
C# doesn't support automatic unboxing in the same meaning as Java, because it doesn't have a separate set of primitive types and object types. All types that have both primitive and object version in Java, are automatically implemented by the C# compiler as either primitive (value) types or object (reference) types.
In both languages, automatic boxing does not downcast automatically, i.e. the following code won't compile:
C#: <syntaxhighlight lang="csharp"> int i = 42; object o = i; // box int j = o; // unbox (error) Console.WriteLine(j); // unreachable line, author might have expected output "42" </syntaxhighlight>
Java: <syntaxhighlight lang="java"> int i = 42; Object o = i; // box int j = o; // unbox (error) System.out.println(j); // unreachable line, author might have expected output "42" </syntaxhighlight>
Boxing in RustEdit
Rust have the <syntaxhighlight lang="text" class="" style="" inline="1">Box</syntaxhighlight> struct:<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> <syntaxhighlight lang="rust"> let number = Box::new(42); </syntaxhighlight> If the value needs to passed to another thread it needs to use <syntaxhighlight lang="text" class="" style="" inline="1">Arc</syntaxhighlight>.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref><ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>
Type helpersEdit
Modern Object Pascal has yet another way to perform operations on simple types, close to boxing, called type helpers in FreePascal or record helpers in Delphi and FreePascal in Delphi mode.
The dialects mentioned are Object Pascal compile-to-native languages, and so miss some of the features that C# and Java can implement. Notably run-time type inference on strongly typed variables.
But the feature is related to boxing.
It allows the programmer to use constructs like
<syntaxhighlight lang="pascal">
{$ifdef fpc}{$mode delphi}{$endif}
uses sysutils; // this unit contains wraps for the simple types
var
x:integer=100; s:string;
begin
s:= x.ToString; writeln(s);
end. </syntaxhighlight>