Comment le boxing et le unboxing se décompilent en C#
Une conversion implicite de int vers object est invisible en C#, mais elle alloue sur le tas, et l'IL le dit clairement avec un opcode box. Voici d'où viennent box, unbox.any et le préfixe constrained., pourquoi le code générique utilise constrained. pour éviter une allocation par boxing, et comment Glass.NET reconstruit du C# lisible pendant que l'IL révèle l'allocation que le code source dissimule.
Une conversion implicite de int vers object est l”une des choses coûteuses les plus discrètes de C#. Vous écrivez object o = n; (pas de cast, pas de cérémonie) et une allocation sur le tas se produit. Le C# n”en dit rien. L”IL en dit tout, dans un seul opcode : box. Le boxing, son inverse unbox.any et le préfixe constrained. que le code générique utilise pour éviter le boxing forment une petite famille d”instructions qui, ensemble, expliquent d”où viennent les allocations cachées en .NET. Elles illustrent aussi bien le travail d”un décompilateur : Glass.NET vous rend le C# lisible qu”a écrit l”auteur, et la vue IL vous rend l”allocation que l”auteur n”a jamais tapée.
Glass.NET est un décompilateur et explorateur d”assemblies .NET gratuit, bâti sur le moteur d”ILSpy. Tout ce qui suit est de l”analyse statique : il lit les métadonnées et les corps de méthodes d”un assembly que vous possédez déjà ; il ne charge ni n”exécute jamais la cible.
L”opcode box
Commençons par la conversion par boxing la plus simple possible :
public static object Wrap(int n) => n;
Le type de retour est object et l”argument est int, donc une conversion doit avoir lieu. Dans l”IL, elle est explicite :
ldarg.0
box [System.Runtime]System.Int32
ret
box dépile le int, alloue un Int32 boxé sur le tas managé et empile la référence. C”est toute l”histoire du boxing : un type valeur est copié dans un objet fraîchement alloué pour qu”un emplacement de type référence puisse le contenir. Le même opcode apparaît pour une conversion vers une interface que la valeur implémente, vers System.ValueType, vers System.Enum ou vers dynamic : partout où une valeur doit devenir une référence.
Glass.NET décompile Wrap en return n;, ce qui est exactement le code source. L”allocation n”est pas visible dans cette ligne parce qu”elle ne l”était jamais non plus dans la ligne d”origine. Basculez la même méthode vers la vue IL et le box Int32 est bien là : la seule instruction qui transforme un retour anodin en une allocation.
Le unboxing est un cast
La direction inverse est un cast d”object vers un type valeur :
public static int Unwrap(object o) => (int)o;
ldarg.0
unbox.any [System.Runtime]System.Int32
ret
unbox.any est la forme moderne et pratique : il extrait la valeur int de la boîte et la laisse sur la pile, en levant InvalidCastException si o n”est pas vraiment un Int32 boxé. Il équivaut à l”ancien duo unbox (qui produit un pointeur managé dans la boîte sans copie) suivi de ldobj (qui lit la valeur à travers ce pointeur). Ce que vous verrez presque toujours dans la sortie décompilée, c”est unbox.any, car le cast C# (int)o lui correspond directement ; le unbox seul apparaît quand le code source a pris l”adresse d”une valeur boxée ou l”a mutée sur place. Un décompilateur qui lit unbox.any Int32 le reconvertit en le cast (int) dont il provient.
Où le boxing se cache : string.Format
Les conversions ci-dessus sont visibles parce que les types diffèrent d”une ligne. Le boxing devient intéressant quand il est enfoui dans un appel de bibliothèque. Un cas classique est une chaîne de format composite :
public static string Line(int id, bool ok) =>
string.Format("{0}:{1}", id, ok);
Ici string.Format se lie à la surcharge Format(string, object[]), donc chacun des deux arguments de type valeur doit devenir un object. L”IL construit le tableau et boxe au fur et à mesure qu”il le remplit :
ldstr "{0}:{1}"
ldc.i4.2
newarr [System.Runtime]System.Object
dup
ldc.i4.0
ldarg.0
box [System.Runtime]System.Int32 // id
stelem.ref
dup
ldc.i4.1
ldarg.1
box [System.Runtime]System.Boolean // ok
stelem.ref
call string [System.Runtime]System.String::Format(string, object[])
ret
Une allocation de tableau plus deux boxings pour un seul appel de formatage. Le C# décompilé est le one-liner net que vous avez écrit ; le coût est dans le newarr et dans les deux opcodes box en dessous. Le voir est souvent la première étape pour comprendre pourquoi un chemin de logging chaud alloue plus qu”il n”y paraît.
Le fameux : Enum.HasFlag
Enum.HasFlag est la surprise canonique. Sa signature prend un System.Enum, qui est un type référence, donc l”appeler sur un enum de type valeur boxe, deux fois :
[Flags] enum Access { Read = 1, Write = 2 }
public static bool CanWrite(Access a) => a.HasFlag(Access.Write);
ldarg.0
box Access
ldc.i4.2
box Access
call instance bool [System.Runtime]System.Enum::HasFlag(class [System.Runtime]System.Enum)
ret
Le récepteur a est boxé, et l”argument Access.Write est boxé. Le code source décompilé est le propre a.HasFlag(Access.Write) ; l”IL est l”endroit où les deux allocations s”annoncent d”elles-mêmes. (C”est exactement pourquoi le conseil courant est d”écrire (a & Access.Write) != 0 dans le code chaud ; et si vous décompilez cette version, les opcodes box disparaissent simplement, remplacés par un and et une comparaison.)
Le préfixe constrained. : le boxing que vous pouvez éviter
Le code générique fait face à un dilemme. Considérez :
public static string Describe<T>(T value) => value.ToString();
À la compilation, le compilateur ne sait pas si T sera une struct ou une class. S”il boxait toujours value pour appeler object.ToString(), chaque struct allouerait. S”il ne boxait jamais, les types référence seraient cassés. La réponse du CLR est le préfixe constrained., qui reporte la décision au JIT :
.method public static string Describe<T>(!!T value)
{
ldarga.s value // l'adresse de la valeur, pas une copie
constrained. !!T
callvirt instance string [System.Runtime]System.Object::ToString()
ret
}
Remarquez ldarga : il charge l”adresse de l”argument, un pointeur managé, plutôt que la valeur. Le préfixe constrained. !!T indique alors au JIT comment dispatcher à travers ce pointeur une fois T connu :
Ainsi, Describe(new DateTime()) appelle DateTime.ToString() directement sans allocation, car DateTime redéfinit ToString. Describe(someCustomStruct) qui ne redéfinit pas ToString boxe une fois et appelle object.ToString(). Describe("hello") déréférence le pointeur et effectue un appel virtuel ordinaire. Un même corps de méthode IL, trois comportements choisis par le JIT, et toute la raison d”être du préfixe est de garder le premier cas sans allocation.
Glass.NET reconstruit les trois cas comme le même value.ToString(), car c”est le code source. Ce que la vue IL ajoute, c”est le préfixe constrained. !!T lui-même, qui est votre signal que le site d”appel est générique et que le fait qu”il alloue ou non dépend entièrement du T concret. C”est une distinction que vous ne pouvez pas du tout lire à partir du C#.
Pourquoi les deux vues comptent ensemble
Le motif à travers les quatre exemples est le même. Le C# décompilé est fidèle à ce qu”a écrit l”auteur : return n;, string.Format(...), a.HasFlag(...), value.ToString(). Aucune de ces lignes ne mentionne une allocation, car le langage est conçu pour rendre les conversions implicites. Les allocations vivent une couche plus bas, dans box, dans la séquence newarr/stelem.ref/box, et dans le dispatch que constrained. résout. Un décompilateur qui ne vous montrerait que le C# cacherait exactement ce que coûte une conversion de type valeur.
C”est pourquoi lire les deux vues côte à côte est l”habitude utile. Glass.NET reconstruit la forme pour que le code soit lisible ; la vue IL garde les opcodes tels quels pour que les allocations soient dénombrables. Toutes deux sont des lectures statiques du même assembly (sans exécution, sans rien instrumenter), ce qui en fait un moyen sûr d”auditer du code compilé, le vôtre ou celui de tiers, à la recherche de boxing que vous ne vouliez pas.
À retenir
Le boxing est invisible en C# par conception et explicite en IL par nécessité. box marque chaque conversion de valeur vers référence, unbox.any marque le cast de retour, et le préfixe constrained. est le mécanisme qui permet au code générique d”esquiver une allocation par boxing quand le type concret le permet. Quand une méthode décompilée semble sans allocation mais que votre profileur n”est pas d”accord, ouvrez la vue IL dans Glass.NET et comptez les opcodes box : le code source les a cachés, mais l”IL n”a jamais pu.
Essayez Nebula.NET
Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.