関数CKatoi マニュアル

(The documentation of function CKatoi)

Last Update: 2021/12/20


◆機能・用途(Purpose)

関数atoi(文字列から整数への変換)をエラーチェック付きで実行する。
Call function atoi (conversion of a string to an integer) with error checks.


◆形式(Format)

#include <functions_with_errcheck.h>
inline int CKatoi(const char ∗ss)


◆引数(Arguments)

ss 変換したい文字列。
The string to be converted.


◆戻り値とエラーチェック (Return value and error checks)

下表で桃色のセルがエラー処理を表す。
The pick colored cells in the table below represent error checks.

条件
Condition
戻り値/動作
Return value or behaviour of the function
引数ssが下記の「引数ssの許容される条件」を満たしている場合
The argument ss meets the requirements below.
ssが表す整数。 例えばss="123"であれば戻り値は123となる。
An integer indicated by ss. For example, if ss="123”, then the return value is 123.
引数ssが下記の「引数ssの許容される条件」を満たしていない場合
The argument ss does not meet the requirements below.
プログラムをエラー終了する。
The program finishes as an error.


引数ssの許容される条件 (Requirements for argument ss)
1文字目として許される文字
Allowed characters for the 1st character
  ′0′, ′1′, ′2′, ′3′, ′4′, ′5′, ′6′, ′7′, ′8′, ′9′, ′-′
2文字目として許される文字
Allowed characters for the 2nd character
1文字目が′0′の場合
In cases where the 1st character is ′0′
′\0′
1文字目が′-′の場合
In cases where the 1st character is ′-′
′1′, ′2′, ′3′, ′4′, ′5′, ′6′, ′7′, ′8′, ′9′
上記以外の場合
In the other cases
′0′, ′1′, ′2′, ′3′, ′4′, ′5′, ′6′, ′7′, ′8′, ′9′, ′\0′
3文字目以降に許される文字
Allowed characters for the 3rd and later characters
  ′0′, ′1′, ′2′, ′3′, ′4′, ′5′, ′6′, ′7′, ′8′, ′9′, ′\0′


◆使用例(Example)

int value=CKatoi("123");