# python: declare_var
URL: https://generaltranslation.com/ja/docs/python/api/declare-var.mdx
---
title: declare_var
description: declare_var 関数の API リファレンス
---

## 概要

`declare_var` は動的な値を GT の変数マーカーで囲み、翻訳エンジンが翻訳後の出力でもその変数を保持できるようにします。

```python
from gt_flask import declare_var  # または from 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` — 値を GT の変数マーカーとしてラップする ICU の select 構文。

***

## 注記

* runtime 中に変化する値 (例: ユーザー名、件数) には `declare_var` を使用します。
* build time で判明している値については、[`derive`](/docs/python/api/derive) も参照してください。
* マーク済みの文字列から変数を再度抽出するには、[`decode_vars`](/docs/python/api/decode-vars) を使用します。