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

title: declare_var
description: Contrassegna un valore dinamico come variabile non traducibile in General Translation Python. Riferimento API per declare_var.

---

Contrassegna un valore dinamico come variabile non traducibile, in modo che venga mantenuto in tutte le lingue. Usalo per valori noti solo a Runtime, come nomi utente, email e conteggi, incorporati in una chiamata a [`t`](/docs/python/reference/functions/t).

## Panoramica [#overview]

Chiama `declare_var` con un valore e un parametro `name` facoltativo, utilizzabile solo come keyword. Restituisce un costrutto ICU `{_gt_, select, ...}` che incorpora il valore come marcatore di variabile di General Translation.

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

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

Firma:

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

Riesportato da `gt_i18n` e dai pacchetti del framework a partire da `generaltranslation.static`.

## Come funziona [#how-it-works]

* **Formattazione del valore.** `None` diventa una stringa vuota, `bool` diventa `"true"`/`"false"` e gli altri valori vengono convertiti in stringa; il risultato viene sanitizzato.
* **Costruzione del marcatore.** Restituisce `{_gt_, select, other {value}}`, facoltativamente con una clausola `_gt_var_name {name}` se viene fornito `name`.
* **Runtime vs. build time.** Usalo per i valori di runtime; per un valore con un insieme finito di esiti in fase di build, usa [`derive`](/docs/python/reference/functions/derive). Recupera i valori incorporati con [`decode_vars`](/docs/python/reference/functions/decode-vars).

## Parametri [#parameters]

| Parametro               | Descrizione                                           | Type                                  | Facoltativo | Predefinito |
| ----------------------- | ----------------------------------------------------- | ------------------------------------- | ----------- | ----------- |
| [`variable`](#variable) | Il valore da inserire come variabile non traducibile. | `str \| int \| float \| bool \| None` | No          | —           |
| [`name`](#name)         | Nome leggibile della variabile, solo keyword.         | `str`                                 | Sì          | `None`      |

### `variable` [#variable]

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

Il valore da inserire. `None` viene reso come una stringa vuota; i valori booleani vengono resi in minuscolo.

### `name` [#name]

**Type** `str` · **Facoltativo** · **Predefinito** `None`

Un'etichetta descrittiva leggibile per la variabile, accettata solo come argomento solo keyword e aggiunta come clausola `_gt_var_name` se fornita.

## Returns [#returns]

**Type** `str`

Un costrutto ICU `{_gt_, select, ...}` che racchiude il valore e lo contrassegna come variabile.

## Esempio [#example]

```python
from gt_flask import t, declare_var

# Preserva un valore runtime all'interno di una f-string tradotta
message = t(f"{declare_var(name, name='name')} goes home")
```