# General Translation Python SDKs: declare_var
URL: https://generaltranslation.com/fr/docs/python/reference/functions/declare-var.mdx
---

title: declare_var
description: Marquer une valeur dynamique comme variable non traduisible dans General Translation Python. Référence de l’API pour declare_var.

---

Marque une valeur dynamique comme une variable non traduisible afin qu’elle soit préservée d’une langue à l’autre. Utilisez-la pour les valeurs connues uniquement au Runtime, comme les noms d’utilisateur, les adresses e-mail et les décomptes, intégrées dans un appel à [`t`](/docs/python/reference/functions/t).

## Vue d’ensemble [#overview]

Appelez `declare_var` avec une valeur et un paramètre `name` facultatif, utilisable uniquement comme argument nommé. Il renvoie une construction ICU `{_gt_, select, ...}` qui incorpore la valeur comme marqueur de variable General Translation.

```python
from gt_flask import declare_var  # ou : from gt_fastapi import declare_var, ou : from gt_i18n import declare_var

t(f"Signed in as {declare_var(email, name='email')}")
```

Signature :

```python
declare_var(
    variable: str | int | float | bool | None,
    *,
    name: str | None = None,
) -> str
```

Réexporté à partir de `generaltranslation.static` par `gt_i18n` et les packages du framework.

## Fonctionnement [#how-it-works]

* **Formatage des valeurs.** `None` devient une chaîne vide, `bool` devient `"true"`/`"false"`, et les autres valeurs sont converties en chaîne ; le résultat est nettoyé.
* **Construction du marqueur.** Renvoie `{_gt_, select, other {value}}`, éventuellement avec une clause `_gt_var_name {name}` si `name` est fourni.
* **Runtime vs. build.** Utilisez-la pour les valeurs de Runtime ; pour une valeur avec un ensemble fini de résultats possibles au build, utilisez [`derive`](/docs/python/reference/functions/derive). Récupérez les valeurs incorporées avec [`decode_vars`](/docs/python/reference/functions/decode-vars).

## Paramètres [#parameters]

| Paramètre               | Description                                                                | Type                                  | Facultatif | Par défaut |
| ----------------------- | -------------------------------------------------------------------------- | ------------------------------------- | ---------- | ---------- |
| [`variable`](#variable) | La valeur à insérer comme variable non traduisible.                        | `str \| int \| float \| bool \| None` | Non        | —          |
| [`name`](#name)         | Nom de variable lisible par l’humain, utilisable uniquement comme argument nommé. | `str`                                 | Oui        | `None`     |

### `variable` [#variable]

**Type** `str | int | float | bool | None` · **Obligatoire**

La valeur à insérer. `None` est affiché comme une chaîne vide ; les booléens sont affichés en minuscules.

### `name` [#name]

**Type** `str` · **Facultatif** · **Par défaut** `None`

Libellé descriptif de la variable, lisible par l’humain et accepté uniquement comme argument nommé, ajouté sous forme de clause `_gt_var_name` lorsqu’il est fourni.

## Returns [#returns]

**Type** `str`

Une construction ICU `{_gt_, select, ...}` qui encapsule la valeur en tant que marqueur de variable.

## Exemple [#example]

```python
from gt_flask import t, declare_var

# Conserver une valeur runtime dans une f-string traduite
message = t(f"{declare_var(name, name='name')} goes home")
```