calc/include/libcalcbase.h

1 ファイル

1.1 calc/include/libcalcbase.h

計算ライブラリ (静的リンク用) のヘッダーファイル。

このライブラリは基本的な整数演算を提供します。
静的リンクによる機能の内部関数を模しています。

1.1.1 作者

c-modenization-kit sample team

1.1.2 バージョン

1.0.0

1.1.3 日付

2025/11/22

1.1.4 著作権

Copyright (C) CompanyName, Ltd. 2025. All rights reserved.

2 関数

2.1 add

int add ( const int a, const int b, int *result )

2 つの整数を加算します。

この関数は 2 つの整数を受け取り、その合計を result に格納します。

2.1.1 引数

• a [in] 第一オペランド。
• b [in] 第二オペランド。
• result [out] 計算結果を格納するポインタ。

2.1.2 戻り値

成功時は CALC_SUCCESS、失敗時は CALC_SUCCESS 以外の値を返します。

2.1.3 補足

オーバーフローが発生する可能性がある場合は、 呼び出し側で範囲チェックを行ってください。

2.1.4 警告

result が NULL の場合は失敗を返します。

2.1.5 使用例

int result;
if (add(10, 20, &result) == CALC_SUCCESS) {
    printf("Result: %d\n", result);  // 出力: Result: 30
}

2.2 subtract

int subtract ( const int a, const int b, int *result )

2 つの整数を減算します。

この関数は 2 つの整数を受け取り、その差を result に格納します。

2.2.1 引数

• a [in] 第一オペランド。
• b [in] 第二オペランド。
• result [out] 計算結果を格納するポインタ。

2.2.2 戻り値

成功時は CALC_SUCCESS、失敗時は CALC_SUCCESS 以外の値を返します。

2.2.3 補足

オーバーフローが発生する可能性がある場合は、 呼び出し側で範囲チェックを行ってください。

2.2.4 警告

result が NULL の場合は失敗を返します。

2.2.5 使用例

int result;
if (subtract(10, 3, &result) == CALC_SUCCESS) {
    printf("Result: %d\n", result);  // 出力: Result: 7
}

2.3 multiply

int multiply ( const int a, const int b, int *result )

2 つの整数を乗算します。

この関数は 2 つの整数を受け取り、その積を result に格納します。

2.3.1 引数

• a [in] 第一オペランド。
• b [in] 第二オペランド。
• result [out] 計算結果を格納するポインタ。

2.3.2 戻り値

成功時は CALC_SUCCESS、失敗時は CALC_SUCCESS 以外の値を返します。

2.3.3 補足

オーバーフローが発生する可能性がある場合は、 呼び出し側で範囲チェックを行ってください。

2.3.4 警告

result が NULL の場合は失敗を返します。

2.3.5 使用例

int result;
if (multiply(5, 4, &result) == CALC_SUCCESS) {
    printf("Result: %d\n", result);  // 出力: Result: 20
}

2.4 divide

int divide ( const int a, const int b, int *result )

2 つの整数を除算します。

この関数は 2 つの整数を受け取り、その商を result に格納します。 整数除算のため、小数点以下は切り捨てられます。

2.4.1 引数

• a [in] 被除数。
• b [in] 除数。
• result [out] 計算結果を格納するポインタ。

2.4.2 戻り値

成功時は CALC_SUCCESS、失敗時は CALC_SUCCESS 以外の値を返します。

2.4.3 警告

ゼロ除算の場合、または result が NULL の場合は失敗を返します。

2.4.4 使用例

int result;
if (divide(20, 4, &result) == CALC_SUCCESS) {
    printf("Result: %d\n", result);  // 出力: Result: 5
}