----------------------------------------------------------------------
This is the API documentation for the gdtest_i18n_japanese library.
----------------------------------------------------------------------


## クラス

主要クラス


Calculator(precision: int = 2)

メモリ機能付きの電卓。

基本的な四則演算をサポートし、累計値を
保持します。リセットも可能です。

Parameters
----------
precision : int
    結果の小数点以下の桁数。

See Also
--------
add
    二つの数値を加算する。
multiply
    二つの数値を乗算する。

Examples
--------
>>> calc = Calculator(precision=2)
>>> calc.add_to_total(3.14159)
3.14

.. versionadded:: 0.1.0


## 関数

公開関数


add(a: float, b: float) -> float

二つの数値を加算する。

Parameters
----------
a : float
    第一オペランド。
b : float
    第二オペランド。

Returns
-------
float
    a と b の和。

See Also
--------
multiply
    二つの数値を乗算する。
divide
    二つの数値を除算する。
Calculator
    メモリ機能付きの電卓。

.. versionchanged:: 0.1.0 戻り値の型が int から float に変更されました。

multiply(a: float, b: float) -> float

二つの数値を乗算する。

Parameters
----------
a : float
    第一オペランド。
b : float
    第二オペランド。

Returns
-------
float
    a と b の積。

See Also
--------
add
    二つの数値を加算する。
divide
    二つの数値を除算する。

divide(a: float, b: float) -> float

二つの数値を除算する。

Parameters
----------
a : float
    被除数。
b : float
    除数。ゼロは不可。

Returns
-------
float
    a を b で割った商。

Raises
------
ZeroDivisionError
    b がゼロの場合。

.. deprecated:: 0.1.0
    Calculator.divide() メソッドを使用してください。


----------------------------------------------------------------------
This is the User Guide documentation for the package.
----------------------------------------------------------------------


## はじめに

# クイックスタート

電卓パッケージの基本的な使い方を紹介します。

## インストール

pip でインストールします：

```bash
pip install gdtest-i18n-japanese
```

## 基本的な使い方

```python
from gdtest_i18n_japanese import Calculator

calc = Calculator(precision=3)
calc.add_to_total(10.5)
calc.add_to_total(20.3)
print(calc.get_total())  # 30.8
```


# 関数リファレンス

個別の算術関数を使った簡単な計算方法を紹介します。

```python
from gdtest_i18n_japanese import add, multiply, divide

result = add(10, 20)
product = multiply(3, 7)
quotient = divide(100, 4)
```

## 利用可能な関数

| 関数       | 説明               |
|------------|------------------------|
| `add`      | 二つの数値を加算   |
| `multiply` | 二つの数値を乗算   |
| `divide`   | 二つの数値を除算   |


# テーブルエクスプローラー

`tbl_explorer()` を使ってデータをインタラクティブに探索できます。

```{python}
#| echo: false
import tempfile
from great_docs import tbl_explorer
rows = "名前,年齢,都市,得点\n太郎,28,東京,92.5\n花子,35,大阪,87.3\n次郎,22,京都,95.1\n美月,41,横浜,78.6\n健,30,福岡,88.9\nさくら,27,名古屋,91.2\n誠,33,札幌,84.7"
tf = tempfile.NamedTemporaryFile(mode="w", suffix=".csv", delete=False)
tf.write(rows)
tf.close()
tbl_explorer(tf.name)
```