ForHosting KIT · Texte et IA

Énumérer une liste avec des index à partir de zéro ou un

Transformez rouge, vert et bleu en 0: rouge, 1: vert et 2: bleu, ou commencez à 1 pour des lecteurs. L'ordre, les éléments répétés et les éléments vides restent tels quels ; seuls le numéro et le séparateur s'ajoutent. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Éléments: red, green, blue
Base de l'indice: 0
Séparateur: :

Vous obtenez

Énuméré: 0: red, 1: green, 2: blue
Texte: 0: red 1: green 2: blue
Quantité: 3

Énumérer une liste avec des index transforme un tableau ordonné de chaînes en libellés clairs et faciles à citer. Vous choisissez si le comptage commence à zéro ou un, fournissez un séparateur court et recevez à la fois un tableau d’entrées formatées et une version textuelle jointe par des sauts de ligne. L’ordre et le texte d’origine sont conservés exactement ; seuls l’index et le séparateur sont ajoutés. Cette opération convient au code, à la documentation, aux notes de révision, aux prompts et aux données exportées qui exigent des références stables et sans ambiguïté.

Choisissez la convention d’index adaptée à votre public

Décidez d’abord si le premier libellé doit être zéro ou un. Une indexation à partir de zéro est naturelle lorsque le résultat est comparé aux positions de tableaux en JavaScript, Python ou dans d’autres environnements de programmation : le libellé affiché correspond alors directement à la position utilisée dans le code. Une indexation à partir de un est généralement plus intuitive dans des instructions, des ordres du jour, des listes de contrôle, des questionnaires ou des révisions éditoriales.

La capacité ne trie, ne filtre, ne raccourcit et ne déduplique pas les valeurs. Elle parcourt le tableau dans son ordre actuel : les chaînes répétées restent distinctes et les chaînes vides reçoivent aussi un index. Nettoyez ou réordonnez donc les données en amont si nécessaire.

Employez un séparateur qui rend chaque libellé lisible

Le séparateur est inséré littéralement entre l’index calculé et chaque élément d’origine. Par défaut, il s’agit de deux-points suivis d’une espace, ce qui produit des libellés comme <code>0: rouge</code>. Vous pouvez choisir un point et une espace pour une liste numérotée classique, une parenthèse fermante pour des réponses compactes, une tabulation pour un tableau ultérieur ou une flèche visible dans des journaux.

La chaîne étant reprise exactement, les espaces comptent : deux-points sans espace donnent <code>0:rouge</code>, tandis qu’une espace donne <code>0: rouge</code>. Un séparateur vide est admis pour créer des identifiants compacts, même si une frontière visible est souvent plus claire. La limite est de 32 caractères.

Les éléments ne sont jamais analysés pour repérer des nombres ou signes existants. Si un élément commence déjà par un nombre, retirez d’abord l’ancien libellé lorsque votre objectif est de le remplacer plutôt que de les combiner.

Intégrez sûrement les résultats structurés et textuels

La réponse contient <code>enumerated</code>, un tableau avec une chaîne formatée par élément, et <code>text</code>, les mêmes chaînes reliées par des sauts de ligne. Utilisez le tableau lorsqu’un programme doit transformer, filtrer, sérialiser ou afficher les entrées séparément. Employez le texte pour rédiger un bloc brut, préparer un message, créer une section de prompt ou copier le résultat dans une documentation.

La réponse indique aussi le nombre d’éléments, la base choisie et le séparateur, ce qui rend le format explicite pour l’audit et le débogage. La validation refuse les tableaux absents ou vides, les membres non textuels, les bases non prises en charge et les tailles excessives.

Cas d’usage

Préparer des instructions lisibles

Créez des étapes à partir de un avec un point, une parenthèse, deux-points ou un autre séparateur.

Créer des listes de révision citables

Attribuez à chaque constat ou proposition un libellé positionnel stable que les réviseurs peuvent citer.

Questions fréquentes

Quel est le séparateur par défaut ?

Il s’agit de deux-points suivis d’une espace, ce qui produit des entrées comme 0: exemple.

L’opération modifie-t-elle le texte ou l’ordre ?

Non. Elle conserve chaque chaîne et sa position, puis ajoute seulement le préfixe d’index et le séparateur.

Quel format de sortie faut-il utiliser ?

Utilisez enumerated pour un tableau structuré ou text pour les mêmes entrées reliées par des sauts de ligne.

Combien coûte une requête ?

La base d’index et le séparateur ne changent pas le prix.

Faut-il commencer à compter à 0 ou à 1 ?

Choisissez 0 quand les étiquettes doivent correspondre à des positions dans un programme, car la plupart des langages de programmation comptent à partir de zéro. Choisissez 1 pour des consignes, des ordres du jour, des listes de contrôle ou des choix de réponse, où le premier élément porte le numéro un.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/str/enumerate-with-index

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/str/enumerate-with-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":["red","green","blue"]}'

const res = await fetch("https://api.kit.forhosting.com/str/enumerate-with-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "red",
      "green",
      "blue"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/enumerate-with-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "items": [
        "red",
        "green",
        "blue"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/enumerate-with-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"items":["red","green","blue"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["red","green","blue"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/enumerate-with-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "items": [
    "red",
    "green",
    "blue"
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.enumerate_with_index",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_items`	10000
`max_item_chars`	10000
`max_separator_chars`	32

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Elle est déterministe, sans accès réseau, et coûte $0.002 par requête API.

Choisissez la convention d’index adaptée à votre public

Définissez <code>index_base</code> sur 0 ou 1 ; toute autre valeur est refusée afin qu’un décalage accidentel ne crée pas de références trompeuses.

Intégrez sûrement les résultats structurés et textuels

Des entrées JSON identiques donnent toujours des sorties JSON identiques, sans horodatage, hasard, appel distant ni format numérique régional. Dans une automatisation, traitez <code>invalid_input</code> comme une demande de correction, rectifiez le champ nommé puis recommencez. Chaque exécution API coûte $0.002, quelle que soit la base retenue.

Cas d'intégration

Libeller des choix pour le code et les API

Créez des libellés à partir de zéro qui correspondent directement aux positions utilisées par l’application.

Questions techniques

L’indexation peut-elle commencer à zéro ou à un ?

Oui. Définissez index_base sur 0 pour partir de zéro ou sur 1 pour partir de un.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Choisissez la convention d’index adaptée à votre public

Employez un séparateur qui rend chaque libellé lisible

Intégrez sûrement les résultats structurés et textuels

Cas d’usage

Préparer des instructions lisibles

Créer des listes de révision citables

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Limites

Erreurs

Notes techniques

Choisissez la convention d’index adaptée à votre public

Intégrez sûrement les résultats structurés et textuels

Cas d'intégration

Libeller des choix pour le code et les API

Questions techniques

merci