Dictionnaires de données

Les dictionnaires de données stockent les jetons de données par paire clé-valeur, de manière similaire aux dictionnaires en C#. La plupart des fonctions des dictionnaires de données ne sont que des enveloppes pour le dictionnaire sous-jacent en C#, il est donc également possible de consulter la documentation des dictionnaires en C# pour plus de détails spécifiques.

Les clés et les valeurs d’un dictionnaire de données sont tous deux des jetons de données. Cela signifie que vous pouvez utiliser efficacement n’importe quoi pour vos clés. Cependant, si vous avez l’intention de sérialiser en VRCJSON, seules les clés de type chaîne sont prises en charge.

Propriétés

Propriété	Résultat
Count	Obtenir le nombre d’éléments dans le dictionnaire

Fonctions

Fonction	Entrée	Sortie	Résultat
Add	Jeton de données clé, Jeton de données valeur		Ajoute la valeur à la clé spécifiée. L’objectif principal de cette fonction, qui la différencie de SetValue, est de générer une exception si la clé existe déjà. Cela peut être utile pour l’initialisation car cela provoquera une erreur de compilation, mais cela n’est pas recommandé pour une utilisation normale où cela pourrait provoquer une erreur d’exécution et interrompre votre comportement Udon.
Clear			Supprime toutes les clés et valeurs de ce dictionnaire
ContainsKey	Jeton de données clé	bool résultat	Renvoie vrai si la clé spécifiée existe dans ce dictionnaire.
ContainsValue *	Jeton de données clé	bool résultat	Renvoie vrai si la valeur spécifiée existe dans ce dictionnaire.
DeepClone *		Dictionnaire de données résultat	Clone le dictionnaire de données dans un nouveau dictionnaire de données contenant les mêmes valeurs. Contrairement à ShallowClone, le clonage en profondeur signifie qu’il explorera récursivement chaque liste de données ou chaque dictionnaire de données et copiera également leur contenu. Les éléments de type “Référence” conserveront la même référence que l’original et ne seront pas clonés en profondeur, y compris les tableaux.
GetKeys		Liste de données clés	Renvoie une liste de données de toutes les clés qui existent dans ce dictionnaire de données. Utilisez cela pour itérer sur tous les éléments dans un dictionnaire de données dans une boucle for.
GetValues *		Liste de données valeurs	Renvoie une [liste de données](/worlds/udon/conteneurs-de-donnees/listes-de