# python: declare_var
URL: https://generaltranslation.com/ru/docs/python/api/declare-var.mdx
---
title: declare_var
description: Справочная документация по функции declare_var
---

## Обзор

`declare_var` оборачивает динамическое значение маркером переменной GT, чтобы системы перевода сохраняли переменную в переведённом тексте.

```python
from gt_flask import declare_var  # или из gt_fastapi import declare_var

greeting = declare_var("Alice", name="user")
```


## Справка

### Параметры

<TypeTable
  type={{
  "variable": {
    type: 'str | int | float | bool | None',
    description: 'Значение, встраиваемое как непереводимая переменная.',
  },
  "name?": {
    type: 'str',
    optional: true,
    description: 'Необязательное понятное человеку имя переменной.',
  },
}}
/>

### Возвращаемое значение

`str` — конструкция ICU select, которая помечает значение как маркер переменной GT.

***

## Примечания

* Используйте `declare_var` для значений, которые меняются во время выполнения (например, имён пользователей и количеств).
* См. также [`derive`](/docs/python/api/derive) для значений, известных на этапе сборки.
* Используйте [`decode_vars`](/docs/python/api/decode-vars), чтобы извлечь переменные из помеченной строки.