# 基本演算子と関数
:::{container} prog-cpp
## 単項演算子と二項演算子
Hi-QUBOは,式（すなわち`qbpp::Expr`オブジェクト）を構築するための以下の基本的な二項演算子をサポートしています:
- **`+`**: オペランドの和を返します.
- **`-`**: オペランドの差を返します.
- **`*`**: オペランドの積を返します.
- **`/`**: オペランドの商を返します.
除数は整数でなければならず,被除数の定数項とすべての係数は除数で割り切れる必要があります.[double フロントエンド](../basic/variables-and-expressions.md#実数double係数)（`DOUBLE_TYPE*`）では割り切れる必要はなく,係数はそのまま実数として除算されます.
- 単項**`-`**: オペランドの符号を反転した値を返します.
- 単項**`~`**: 変数の否定リテラル（`~x` = $1-x$）を返します.詳細は[変数](../basic/variables-and-expressions.md)を参照してください.
これらの演算子の優先順位は,標準的なC++の演算子優先順位規則に従います.
以下のプログラムは,これらの演算子を使用して式を構築する方法を示しています:
```{literalinclude} /../programFiles/cppPrograms/advanced/basic-operators-and-functions-program1.cpp
:language: cpp
:caption: basic-operators-and-functions-program1.cpp
```
このプログラムの出力は次のとおりです:
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
## 複合演算子
qbpp::Exprオブジェクトを更新するための以下の複合演算子もサポートされています.
- **`+=`** : 右辺のオペランドを左辺に加算します.
- **`-=`** : 右辺のオペランドを左辺から減算します.
- **`*=`** : 右辺のオペランドを左辺に乗算します.
- **`/=`** : 左辺のオペランドを右辺で除算します.右辺のオペランドは整数でなければならず,左辺の定数項の整数値とすべての係数は割り切れる必要があります.double フロントエンドでは割り切れる必要はなく,実数として除算されます.
以下のプログラムは,これらの複合演算子を使用して式を構築する方法を示しています:
```{literalinclude} /../programFiles/cppPrograms/advanced/basic-operators-and-functions-program2.cpp
:language: cpp
:caption: basic-operators-and-functions-program2.cpp
```
このプログラムの出力は次のとおりです:
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
## 二乗関数
Hi-QUBOは,式の二乗を計算するためのグローバル関数**`qbpp::sqr()`**と`qbpp::Expr`クラスのメンバ関数**`sqr()`**の両方を提供しています.
以下のプログラムでは,`qbpp::Expr`オブジェクト`f`に対して,グローバル関数**`qbpp::sqr(f)`**は`f`の二乗を表す新しい`qbpp::Expr`オブジェクトを返し,
一方メンバ関数**`f.sqr()`**は`f`をその場でその二乗に置き換えて更新します.
```{literalinclude} /../programFiles/cppPrograms/advanced/basic-operators-and-functions-program3.cpp
:language: cpp
:caption: basic-operators-and-functions-program3.cpp
```
このプログラムの出力は次のとおりです:
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
## 簡約化関数
`qbpp::Expr`オブジェクトに演算子や関数が適用された後,式は自動的に展開されます.
項をソートし,結果の式を簡約化するには,簡約化関数を明示的に呼び出す必要があります.
Hi-QUBOは以下の3つの**グローバル簡約化関数**を提供しています:
- **`qbpp::simplify()`**:
同一の項の係数をマージして簡約化された式を返します.
- **`qbpp::simplify_as_binary()`**:
すべての変数がバイナリ値$0/1$を取ることを仮定して簡約化された式を返します.
すなわち,恒等式$x^2=x$が成り立つことを利用して,式を整理します.
- **`qbpp::simplify_as_spin()`**:
すべての変数がスピン値$-1/+1$を取ることを仮定して簡約化された式を返します.
すなわち,恒等式$x^2=1$が成り立つことを利用して,式を整理します.
以下のプログラムは,これらの簡約化関数の動作を示しています:
```{literalinclude} /../programFiles/cppPrograms/advanced/basic-operators-and-functions-program4.cpp
:language: cpp
:caption: basic-operators-and-functions-program4.cpp
```
このプログラムの出力は次のとおりです:
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
これらの簡約化関数の**メンバ関数**版も`qbpp::Expr`オブジェクトに対して提供されており,オブジェクトをその場で簡約化された結果に更新します.
例えば,以下のプログラムは**`simplify()`**を適用して`f`を更新します:
```{literalinclude} /../programFiles/cppPrograms/advanced/basic-operators-and-functions-program5.cpp
:language: cpp
:caption: basic-operators-and-functions-program5.cpp
```
このプログラムの出力は次のとおりです:
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
:::
:::{container} prog-python
## 単項演算子と二項演算子
PyQBPPは,式を構築するための以下の基本的な二項演算子をサポートしています：
- **`+`**: オペランドの和を返します.
- **`-`**: オペランドの差を返します.
- **`*`**: オペランドの積を返します.
- **`/`**: オペランドの商を返します.
除数は整数でなければならず,被除数の定数項とすべての係数は除数で割り切れる必要があります.[double フロントエンド](../basic/variables-and-expressions.md#実数double係数)のモジュール（`pyqbpp.d` など）では割り切れる必要はなく,係数はそのまま実数として除算されます.
- 単項 **`-`**: オペランドの符号を反転した値を返します.
- 単項 **`~`**: 変数の否定リテラルを返します（バイナリ変数 `x` に対して,`~x` は $1-x$ を表します）.
`+`,`-`,`*`,`/` の優先順位は標準的なPythonの演算子優先順位規則に従います.
以下のプログラムは,これらの演算子を使用して式を構築する方法を示しています：
```{literalinclude} /../programFiles/pythonPrograms/advanced/basic-operators-and-functions-program1.py
:language: python
:caption: basic-operators-and-functions-program1.py
```
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
> **注釈**
> PyQBPPでは `+`,`-`,`*`,`/` のPython演算子が `Var`,`Term`,`Expr` クラス上でオーバーロードされています.
> `+`/`-` の結果は式（`Expr`）になり,`*` は `Var`・`Term` 同士では積の項（`Term`）を返します.`/`（÷整数）は `Term` と `Expr` に対してのみ使用できます.
## 複合代入演算子
式を更新するための以下の複合代入演算子もサポートされています：
- **`+=`**: 右辺のオペランドを左辺に加算します.
- **`-=`**: 右辺のオペランドを左辺から減算します.
- **`*=`**: 右辺のオペランドを左辺に乗算します.
- **`/=`**: 左辺のオペランドを右辺で除算します.右辺のオペランドは整数でなければならず,左辺の定数項とすべての係数は割り切れる必要があります.double フロントエンドでは割り切れる必要はなく,実数として除算されます.
以下のプログラムは,これらの複合代入演算子を使用して式を更新する方法を示しています：
```{literalinclude} /../programFiles/pythonPrograms/advanced/basic-operators-and-functions-program2.py
:language: python
:caption: basic-operators-and-functions-program2.py
```
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
## 二乗関数
PyQBPPは,式の二乗を計算するためのグローバル関数 **`qbpp.sqr()`** と `Expr` クラスのメンバ関数 **`sqr()`** の両方を提供しています.
以下のプログラムでは,式 `f` に対して,グローバル関数 **`qbpp.sqr(f)`** は `f` を変更せずに `f` の二乗を表す新しい式を返します.
一方,メンバ関数 **`f.sqr()`** は `f` をその場でその二乗に置き換えて更新します.
```{literalinclude} /../programFiles/pythonPrograms/advanced/basic-operators-and-functions-program3.py
:language: python
:caption: basic-operators-and-functions-program3.py
```
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
## 簡約化関数
式に演算子や関数が適用された後,式は自動的に展開されます.
項をソートし,結果の式を簡約化するには,簡約化関数を明示的に呼び出す必要があります.
PyQBPPは以下の3つの**グローバル簡約化関数**を提供しています：
- **`qbpp.simplify()`**:
同一の項の係数をマージして簡約化された式を返します.
- **`qbpp.simplify_as_binary()`**:
すべての変数がバイナリ値 $0/1$ を取ることを仮定して簡約化された式を返します.
すなわち,恒等式 $x^2=x$ が成り立つことを利用して,式を整理します.
- **`qbpp.simplify_as_spin()`**:
すべての変数がスピン値 $-1/+1$ を取ることを仮定して簡約化された式を返します.
すなわち,恒等式 $x^2=1$ が成り立つことを利用して,式を整理します.
以下のプログラムは,これらの簡約化関数の動作を示しています：
```{literalinclude} /../programFiles/pythonPrograms/advanced/basic-operators-and-functions-program4.py
:language: python
:caption: basic-operators-and-functions-program4.py
```
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
これらの簡約化関数の**メンバ関数**版も式に対して提供されており,式をその場で簡約化された結果に更新します.
例えば,以下のプログラムは **`simplify()`** を適用して `f` を更新します：
```{literalinclude} /../programFiles/pythonPrograms/advanced/basic-operators-and-functions-program5.py
:language: python
:caption: basic-operators-and-functions-program5.py
```
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/advanced/basic-operators-and-functions.md
:start-after:
:end-before:
```
> **注釈**
> PyQBPPでは,式（`Expr`）の**メンバ関数**（例: `f.simplify()`,`f.sqr()`）はオブジェクトをその場で更新しますが,**グローバル関数**（例: `qbpp.simplify(f)`,`qbpp.sqr(f)`）は元のオブジェクトを変更せずに新しいオブジェクトを返します（式の配列のメンバ関数も同様にその場で更新します）.
:::