関数CKatoi_allow0 マニュアル

(The documentation of function CKatoi_allow0)
Last Update: 2021/12/20


◆機能・用途(Purpose)

関数atoi(文字列から整数への変換)をエラーチェック付きで実行する。 「01」など頭に0が付く数字を許容する。
Call function atoi (conversion of a string to an integer) with error checks, allowing numbers beginning with zero (e.g., “01”).

◆形式(Format)

#include <functions_with_errcheck.h>
inline int CKatoi_allow0(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="012"であれば戻り値は12となる。
An integer indicated by ss. For example, if ss="012”, then the return value is 12.
引数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文字目が′-′の場合
In cases where the 1st character is ′-′ 		′0′, ′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_allow0("012");