Cette bibliothèque fournit des fonctions génériques pour la manipulation des tables/tableaux,
mettant toutes ses fonctions dans la variable globale `Library.table`. La plupart
des fonctions de la bibliothèque `Library.table` supposent que la table représente un
tableau ou une liste. Pour ces fonctions, la "longueur" d'une table signifie le résultat
de l'opérateur de longueur.

Met la valeur de toutes les clés dans la table donnée à `nil`. Cela fait
que l'opérateur `#` retourne `0` pour la table donnée. La capacité allouée
à la portion tableau de la table est maintenue, ce qui permet une réutilisation efficace
de l'espace.

```lua
local grades = {95, 82, 71, 92, 100, 60}
print(grades[4], #grades) --> 92, 6
table.clear(grades)
print(grades[4], #grades) --> nil, 0
-- Si les notes sont remplies à nouveau avec le même nombre d'entrées,
-- aucune redimensionnement coûteux ne se produira
-- car la capacité a été maintenue par table.clear.
```
Cette fonction ne supprime/détruit pas la table qui lui est fournie. Cette
fonction est spécifiquement destinée aux tables devant être
réutilisées.

table.clear

table

La table dont les clés seront effacées.

Met tous les clés dans la table donnée à `nil`.

Retourne une copie peu profonde non gelée de la table fournie.

```lua
local original = {
	key = "value",
	engine = "Roblox",
	playerID = 505306092
}

local clone = table.clone(original)
```

table.clone

Retourne une copie superficielle de la table fournie.

Étant donné un tableau où tous les éléments sont des chaînes ou des nombres, retourne la
chaîne `t[i] ... sep ... t[i+1] ... sep ... t[j]`. La valeur par défaut pour
sep est une chaîne vide, la valeur par défaut pour `i` est 1, et la valeur par défaut pour `j`
est #t. Si i est supérieur à `j`, retourne une chaîne vide.

table.concat

La chaîne qui sera concaténée entre chaque entrée de la table.

L'index de départ de la concaténation de la table.

L'index de fin de la concaténation de la table.

Retourne la plage donnée d'éléments de la table sous forme de chaîne où chaque élément
est séparé par le séparateur donné.

Crée une table avec la portion de tableau allouée au nombre donné `number`
d'éléments, éventuellement remplie avec la valeur donnée `value`.

```lua
local t = table.create(3, "Roblox")
print(table.concat(t)) --> RobloxRobloxRoblox
```
Si vous insérez dans de grandes tables en forme de tableau et que vous êtes certain d'une
limite raisonnable au nombre d'éléments, il est recommandé d'utiliser
cette fonction pour initialiser la table. Cela garantit que la portion de tableau
de sa mémoire est suffisamment dimensionnée, car le redimensionnement peut être
coûteux. Pour de petites quantités, cela n'est généralement pas perceptible.

table.create

count

value

Retourne une nouvelle table peuplée de nombreuses instances de la valeur spécifiée.

Dans la table de type tableau donnée `haystack`, trouve la première occurrence de
la valeur `needle`, à partir de l'index `init` ou du début si non
donné. Si la valeur n'est pas trouvée, `nil` est retourné.

Un algorithme [de recherche linéaire](https://en.wikipedia.org/wiki/Linear_search)
est exécuté.

```lua
local t = {"a", "b", "c", "d", "e"}
print(table.find(t, "d")) --> 4
print(table.find(t, "z")) --> nil, parce que z n'est pas dans la table
print(table.find(t, "b", 3)) --> nil, parce que b apparaît avant l'index 3
```

table.find

haystack

needle

init

Retourne l'index de la première occurrence de `needle` dans `haystack`
à partir de `init`.

Itère sur la table fournie, passant la clé et la valeur de chaque
itération à la fonction fournie. Cette fonction a été dépréciée
et n'est pas recommandée pour une utilisation dans un nouveau code ; utilisez plutôt une
boucle `for`.

table.foreach

La fonction qui sera utilisée pour l'itération. Cette fonction recevra 2 arguments pour chaque itération,
dont le 1er argument est la clé, et le 2ème argument est la valeur.

Itère sur la table fournie, passant la clé et la valeur de chaque
itération à la fonction fournie.

Ceci est similaire à `Library.table.foreach()` sauf que des paires index-valeur
sont passées, pas des paires clé-valeur. Cette fonction a été dépréciée et n'est
pas recommandée pour une utilisation dans un nouveau code ; utilisez plutôt une
boucle `for`.

table.foreachi

La fonction qui sera utilisée pour l'itération. Cette fonction recevra 2 arguments pour chaque itération,
dont le 1er argument est l'index, et le 2ème argument est la valeur.

Semblable à `Library.table.foreach()` sauf que des paires index-valeur sont passées
au lieu de paires clé-valeur.

Cette fonction rend la table donnée en lecture seule, "gelant" efficacement
son état actuel. Tenter de modifier une table gelée provoque une erreur.

Cet effet de gel est superficiel, ce qui signifie que vous pouvez écrire dans une table
à l'intérieur d'une table gelée. Pour geler en profondeur une table, appelez cette fonction
récursivement sur toutes les tables descendantes.

table.freeze

Retourne le nombre d'éléments dans la table passée. Cette fonction a été
dépréciée et n'est pas recommandée pour une utilisation dans un nouveau code ; utilisez `#t` à la place.

table.getn

Retourne le nombre d'éléments dans la table passée.

Insère la valeur fournie à la position cible du tableau.

table.insert

La position à laquelle la valeur sera insérée.

Ajoute la valeur fournie à la fin du tableau.

Cette fonction retourne `true` si la table donnée est gelée et `false` si
elle n'est pas gelée. Vous pouvez geler des tables en utilisant `Library.table.freeze()`.

table.isfrozen

Si la table est gelée par `Library.table.freeze()`.

Retourne `true` si la table donnée est gelée et `false` si elle n'est pas
gelée.

Retourne la clé numérique maximale de la table fournie, ou zéro si la
table n'a pas de clés numériques. Les lacunes dans la table sont ignorées.

table.maxn

Retourne la clé numérique maximale de la table fournie, ou zéro si la
 table n'a pas de clés numériques.

Copie les éléments dans la table `src` de `src[a]` jusqu'à `src[b]` dans la table
`dst` en commençant à l'index `t`. Équivalent à l'instruction d'assignation
`dst[t], ..., dst[t + (b - a)] = src[a], ..., src[b]`.

La valeur par défaut pour `dst` est `src`. La plage de destination peut se chevaucher avec la
plage source. Renvoie `dst` pour plus de commodité.

```lua
local sourceTable = {4, 5} -- Table de données à copier
local destTable = {1, 2, 3} -- Table pour ajouter les données copiées

table.move(
	sourceTable, -- Table source
	1, -- Index de départ dans la table source
	#sourceTable, -- Index jusqu'à (et y compris) à partir de la table source
	#destTable + 1, -- Index dans la table de destination pour déplacer les données
	destTable -- Table de destination
)
print(destTable) --> {1, 2, 3, 4, 5}
```


table.move

Copie la plage d'éléments spécifiée d'une table à une autre.

Retourne une nouvelle table avec tous les arguments stockés dans les clés 1, 2, etc. et
avec un champ "n" contenant le nombre total d'arguments. Notez que la
table résultante peut ne pas être une séquence.

```lua
local t = table.pack(1, 2, 3)
print(table.concat(t, ", ")) --> 1, 2, 3
```

table.pack

values...

Retourne une nouvelle table contenant les valeurs fournies.

Supprime de la table t l'élément à la position pos, retournant la valeur de
l'élément supprimé. Lorsque pos est un entier entre `1` et `#t`, il
descend les éléments `t[pos+1], t[pos+2], ..., t[#t]` et efface
l'élément `t[#t]`. Si le paramètre pos n'est pas fourni, pos par défaut est la
longueur de la table supprimant le dernier élément.

table.remove

La table dont un élément est supprimé.

Supprime l'élément spécifié du tableau, décalant les éléments suivants vers le bas
pour remplir l'espace vide si possible.

Trie les éléments du tableau t dans un ordre donné, de `t[1]` à `t[#t]`. Si
`comp` est donné, alors cela doit être une fonction qui reçoit deux éléments et
retourne vrai lorsque le premier élément doit venir avant le second dans l'ordre
final.

L'erreur `invalid order function for sorting` est levée si `comp(a, b)` et `comp(b, a)`
retournent tous deux `true`.

Si `comp` n'est pas donné, l'opérateur standard Luau `<` est utilisé
à la place.

table.sort

comp

Une fonction de comparaison optionnelle à utiliser lors de la comparaison des éléments dans
la table. Cette fonction reçoit deux éléments et doit retourner vrai
si le premier élément doit être trié avant le second dans l'ordre final.

Trie les éléments de la table en utilisant la fonction de comparaison fournie ou l'opérateur `<`.

Retourne les éléments de la liste donnée. Par défaut, `i` est 1 et `j` est
la longueur de `list`.

Notez que cette même fonctionnalité est également fournie par la fonction globale
`Global.LuaGlobals.unpack()`.

table.unpack

list

L'index du premier élément à décompacter.

L'index du dernier élément à décompacter.

Retourne tous les éléments de la liste donnée sous forme de tuple.

Luau

{any}

Un objet qui exécute des fonctions connectées lors d'une occurrence spécifique.

Data Type

RBXScriptSignal

Tuple

Variant

Type de données ayant une valeur de vrai ou faux.

boolean

Les fonctions sont des blocs de code qui peuvent s'exécuter plusieurs fois sur commande.

function

Un nombre à virgule flottante double précision.

number

Une séquence de caractères, tels que des lettres, des chiffres et des symboles.

string

Type de données qui peut stocker plusieurs valeurs de tout type non nil, y compris des booléens, des nombres, des chaînes de caractères, des fonctions et d'autres tables.

Expériences

Avatar

Contenus

Exemples et projets

API du moteur

Ouvrir Cloud API

Studio

Analyses

Plateforme

Tutoriels

Programmes Créateurs

Éducation

Cours

Apprendre

Cette méthode est asynchrone et retourne une `Operation`, qui représente l'état courant de l'opération. Il contient un chemin de terminaison que vous pouvez interroger pour obtenir la vraie réponse et les métadonnées applicables. Voir la [documentation]({longRunningOperationsLink}) sur les opérations à long terme pour plus d’informations.
            
Les sections suivantes décrivent la réponse et les objets de métadonnées qui sont fournis lorsqu'une opération se termine.

Les points de terminaison bêta sont prêts à être utilisés publiquement. Des modifications sont possibles mais rares.

Ces pages de documentation Open Cloud seront supprimées le 31 mars 2026. À compte de cette date, vous serez automatiquement redirigé vers la nouvelle documentation Open Cloud. {linkStart}En savoir plus{linkEnd}

Ces anciennes pages Open Cloud seront supprimées et redirigées le 31 mars 2026. {linkStart}En savoir plus{linkEnd}

Les points de terminaison expérimentaux sont accessibles au public, mais peuvent parfois faire l'objet de modifications majeures lors de la finalisation du contrat de l'API.

Ce point de terminaison peut être appelé au sein de l'expérience via {httpServiceLinkStart}HttpService{httpServiceLinkEnd} avec une clé API.

Ce champ peut être défini lors de la création d'une ressource, mais ne peut pas être modifié par des requêtes ultérieures.

Ces champs peuvent être définis lors de la création d'une ressource, mais ne peuvent pas être modifiés par des requêtes ultérieures.

Ce champ peut être fourni dans les demandes, mais ne sera jamais inclus dans les réponses.

Méthode d'authentification obsolète. Privilégiez l'utilisation d'une clé API ou d'OAuth 2.0 lorsque cela est possible.

Par clé API : {maxInPeriod} demande toutes les {periodInSeconds} secondes par adresse IP

Ne requiert pas d'authentification pour l'appel. Présente généralement des limites de débit bien plus faibles. Il est toujours préférable d'utiliser une clé API ou OAuth 2.0 lorsque cela est possible.

Pour chaque regroupement, un seul des champs suivants du schéma doit être fourni. Les autres peuvent être exclus.

Vous pouvez réactiver cette fonctionnalité à tout moment. {linkStart}Faites-nous part de vos commentaires.{linkEnd}

Vous consultez l'ancienne documentation. {linkStart}Faites-nous part de vos commentaires.{linkEnd}

Vous pouvez désactiver cette fonctionnalité à tout moment et revenir aux anciennes pages de référence. {linkStart}Rédiger un commentaire{linkEnd}.

Vous consultez la documentation remaniée. {linkStart}Faites-nous part de vos commentaires.{linkEnd}

Ce champ peut être défini sur les réponses, mais sera ignoré dans les demandes.

Remarque : les limites de débit peuvent être plus basses pendant les périodes de fort trafic. Certains points d'extrémité ont des limites de débit supplémentaires. [En savoir plus sur les limites de taux]({link}).

{limit} requêtes par jour sur toutes les clés API d'un utilisateur ou d'un groupe

{limit} requêtes par heure pour toutes les clés API pour un utilisateur ou un groupe

{limit} requêtes par minute pour toutes les clés API pour un utilisateur ou un groupe

{limit} requêtes par seconde pour toutes les clés API pour un utilisateur ou un groupe

{limit} requêtes par minutes par propriétaire de clé API

{limit} requêtes par jour par utilisateur de l'application

{limit} requêtes par heure par utilisateur de l'application

{limit} requêtes par minute par utilisateur de l'application

{limit} requêtes par seconde par utilisateur de l'application

{limit} requête.s par seconde par propriétaire de clé API

Les périmètres d'application définissent les autorisations de vos identifiants. Ceux-ci ne peuvent accéder qu'aux points de terminaison correspondant aux périmètres d'application sélectionnés.

Les points de terminaison stables sont prêts pour la production et ne connaîtront pratiquement jamais de modifications importantes au cours de leur existence.

Cette cible vous permet de limiter l'accès de votre clé aux {requiredParts}sélectionnées

Cette cible vous permet de limiter l'accès de votre clé aux {requiredParts} et {optionalParts} sélectionnées.

Les types de cibles permettent de restreindre les ressources sur lesquelles vos identifiants disposent de droits. Seules les ressources sélectionnées seront accessibles, même si votre compte possède des permissions sur d'autres ressources. Certains périmètres d'application ne comportent pas de cibles ; dans ce cas, toutes vos ressources concernées restent accessibles.

La partie de niveau supérieur de l'univers n'a pas à être sélectionnée pour les clés API dont vous disposez. Ainsi, votre clé API pourra accéder à toutes vos expériences personnelles ainsi qu'à celles des groupes pour lesquels vous avez les droits requis.

La fonctionnalité Essayer n'est pas encore prise en charge pour les points de terminaison nécessitant une clé API ou une authentification OAuth 2.0

L'authentification par cookie est désactivée pour les actions à haut risque afin de garantir la sécurité.

Les points de terminaison à risque critique sont extrêmement sensibles et la fonctionnalité Essayer est désactivée pour des raisons de sécurité

Remarque : les en-têtes d'authentification ne figurent pas dans cet exemple de code. Il se peut que vous deviez en ajouter un pour que la commande fonctionne.

Il s'agit d'un point de terminaison à haut risque qui peut modifier ou supprimer des données essentielles. Faites preuve de la plus grande vigilance lors des tests.

Ce point de terminaison API est classé À HAUT RISQUE et peut affecter les données en ligne ou les comptes d'utilisateurs.

Les demandes authentifiées aux API à haut risque peuvent provoquer des modifications irréversibles. Vérifiez soigneusement les paramètres de votre demande avant de continuer.

Connectez-vous pour utiliser l'authentification par cookie

Il s'agit d'un point de terminaison à faible risque qui récupère les données. Il est généralement sûr à tester.

Il s'agit d'un point de terminaison à risque moyen qui modifie les données. Testez-le soigneusement avec des comptes non essentiels, car les changements peuvent être irréversibles.

Pour sécuriser votre compte, ne collez jamais ici de texte provenant d'autres sources et ne divulguez pas les informations de cette page.

Vous vous apprêtez à tester en direct des points de terminaison d'API avec les vrais identifiants de votre compte.

Ne continuez que si vous comprenez bien les conséquences des appels d'API que vous vous apprêtez à réaliser. Consultez attentivement la documentation avant toute expérimentation.

Les appels d'API utiliseront votre session authentifiée.

Ce sont de véritables appels d'API susceptibles d'affecter votre compte ou vos données.

Des limites de débit et d'autres restrictions d'API s'appliquent.

Certaines opérations peuvent modifier ou supprimer des données.

Ce point de terminaison a été remplacé par ces autres points de terminaison recommandés :

Les périmètres d'application suivants sont requis pour appeler ce point de terminaison. Pour plus
d'informations sur la génération de clés appropriées, voir [Gestion des clés API]({apiKeyReferenceDocLink}).

Pour plus d'informations sur la génération de clés, voir [Gestion des clés API]({apiKeyReferenceDocLink}).

Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.

Cette chaîne est formatée comme un [FieldMask](/cloud/reference/types#fieldmask).

Une valeur JSON peut être `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Les champs d'application suivants sont nécessaires pour que votre application OAuth 2.0 puisse utiliser ce point de terminaison. Pour plus d'informations sur l'enregistrement d'une application OAuth 2.0, voir [Enregistrement et révision d'une application]. ({oauth2ReferenceDocLink}).

Pour plus d'informations sur l'enregistrement d'une application OAuth 2.0, voir [Enregistrement et examen d'une application]({oauth2ReferenceDocLink}).

Les objets suivants décrivent les charges utiles qui sont acceptées ou renvoyées. Voir chaque point de terminaison individuel pour plus d'informations sur l'utilisation de ces objets.

Les périmètres d'application suivants sont requis pour appeler ce point de terminaison.

Routes de ressources

Ce string est formatée en tant que [Timestamp](/cloud/reference/types#timestamp).

Non recommandé

Vous consultez la référence Open Cloud remaniée.

Vous avez désactivé la nouvelle référence Open Cloud.

Consultez vos comptes de facturation publicitaire.

Consultez vos campagnes publicitaires et leurs performances.

Créez, modifiez et gérez vos campagnes publicitaires.

Cela permet de consulter des informations sur vos contenus.

Il permet d'importer et de mettre à jour des éléments sur Roblox.

Cela permet d'afficher les autorisations de contenu pour les sujets (y compris les groupes et les expériences) et les contenus auxquels votre compte a accès.

Cela permet d'accorder des autorisations de contenu à tous les sujets (y compris les groupes et les expériences) et contenus auxquels votre compte a accès.

Cela vous permet d'afficher le statut et les résultats des tâches de configuration automatique de l'avatar en votre nom.

Cela vous permet de créer et de gérer des tâches de configuration automatique de l'avatar en votre nom.

Permet de mettre à jour les badges appartenant à l'utilisateur.

Cela permet de visualiser des informations sur vos articles commerciaux.

Cela permet d'apporter des modifications à vos articles de commerce synchronisés.

Cela permet de visualiser des informations sur vos connexions marchandes.

Cela permet de modifier vos connexions commerciales.

Cela vous permet d'afficher des informations sur vos produits de la Boutique du créateur.

Cela permet de consulter les informations liées à vos enregistrements dans la boutique du créateur.

Cela permet de modifier les informations liées à vos enregistrements dans la boutique du créateur.

Donne accès à la création de data stores en votre nom.

Permet de supprimer des stockages de données en votre nom.

Permet d'accéder à une liste de magasins de données.

Donne l'accès pour prendre un instantané de tes magasins de données.

Donne l'accès à la création d'entrées dans tes magasins de données.

Permet de marquer les entrées spécifiées en vue de leur suppression.

Donne accès à la liste des entrées de votre data store.

Donne l'accès à la lecture des entrées spécifiées dans tes magasins de données.

Permet de mettre à jour la valeur, les attributs et les utilisateurs d'une entrée.

Donne accès à la suppression des révisions des entrées de votre data store.

Donne accès à la liste des révisions des entrées de votre data store.

Donne accès aux révisions en lecture des entrées de votre data store.

Permet d'afficher les détails de configuration des produits développeur de l'utilisateur autorisé.

Permet de modifier les produits développeur de l'utilisateur autorisé.

Cela permet de visualiser des informations sur les environnements de votre univers.

Cela permet de modifier les environnements de votre univers.

Permet d'afficher les détails de configuration des passes de jeu de l'utilisateur autorisé.

Permet de modifier les passes de jeu de l'utilisateur autorisé.

Permet d'afficher les informations des forums de la communauté pour votre compte.

Permet d'afficher les informations des forums de la communauté pour le compte.

Cela permet d'afficher des informations sur vos communautés.

Cela te permet de gérer les demandes d'adhésion à la communauté et les mises à jour de rôle des membres de la communauté de rang inférieur pour ton compte.

Permet d'afficher les données de propriétés d'une instance.

Vous permet de modifier les données des propriétés des instances (actuellement ne supporte que les scripts).

Accorde l'accès à la gestion des contenus de l'utilisateur.

Donne accès à la gestion de tes badges.

Donne accès à la gestion de vos badges et à l'utilisation de Robux.

Donne l'accès à la mise à jour des badges de l'utilisateur autorisé.

Donne accès à la gestion de vos produits développeurs.

Accorde l'accès aux informations sur les expériences pour lesquelles vous avez activé les notifications.

Accorde l'activation ou la désactivation des notifications pour des expériences en votre nom.

Donne accès à la gestion de tes passes.

Donne accès à la gestion de tes communautés.

Donne la permission de lire les informations de la communauté.

Donne des autorisations de gestion de la communauté.

Donne accès à la lecture et à l'écriture de vos tables de localisation

Donne accès à la gestion de la collaboration en équipe pour toutes tes expériences.

Donne accès à la gestion de vos expériences et de certaines informations associées à vos expériences (par exemple des informations de localisation).

Permet de lire les informations de localisation de vos expériences.

Permet de modifier les préférences de localisation de vos expériences.

Donne accès à la gestion de votre compte utilisateur.

Permet l'accès pour modifier les préférences de localisation de l'utilisateur.

Vous permet de visualiser le statut, les journaux et les résultats des tâches d'exécution de Luau pour le lieu associé.

Vous permet de créer de nouvelles tâches d'exécution de Luau pour le lieu associé.

Donne accès à la purge asynchrone de toutes les structures de données de l'univers.

Permet de créer de nouveaux items dans la file d'attente.

Permet d'accéder à des éléments lus depuis le devant de la file d'attente.

Accorde l'accès à la lecture des items situés à l'avant de la file d'attente.

Permet de lire les items de votre mémoire.

Permet d'accéder à la lecture des éléments de la carte.

Donne accès à la création, la mise à jour et la suppression des éléments de la carte.

Cela permet de publier des messages au nom des utilisateurs.

Cela permet d'envoyer des notifications de votre expérience aux utilisateurs.

(Obsolète) Donne accès à la lecture d'une liste d'entrées dans un magasin de données ordonné.

(Obsolète) Donne l'accès à la création d'une nouvelle entrée dans un magasin de données ordonné.

Permet d'accéder aux entrées d'une liste à partir d'un magasin de données ordonné.

Donne l'accès à la création d'entrées dans un magasin de données ordonné.

Cela permet d'énumérer les secrets liés à ton expérience.

Cela permet de créer et de mettre à jour des secrets liés à ton expérience.

Cette autorisation vous permet de soumettre un job d'évaluation et de visualiser le résultat de l'emploi.

Permet d'accéder aux informations sur les produits de votre abonnement.

Cela permet de lire les informations des miniatures en votre nom.

Permet la lecture des analyses de l'expérience.

Donne la capacité de lire les informations sur les lieux.

Donne la possibilité d'éditer les informations du lieu.

Donne accès à la publication de nouvelles versions d'expériences à Roblox.

Donne la possibilité de lire des informations sur l'expérience.

Donne l'accès à la modification des expériences de l'utilisateur autorisé.

Permet de voir les restrictions de l'utilisateur dans l'expérience.

Vous permet de modifier les restrictions d'utilisateur dans l'expérience.

Cela permet la consultation des notifications envoyées à votre compte.

Accorde la possibilité de lire la prime et le statut vérifié de l'utilisateur autorisé.

Cela te permet de voir les comptes sociaux de l'utilisateur autorisé.

Cela active la fonctionnalité Single Sign-On.

Cela vous donne accès à la lecture des informations de votre profil.