関数CKstrncpy マニュアル

(The documentation of function CKstrncpy)
Last Update: 2023/4/6


◆機能・用途(Purpose)

関数strncpy(文字列の一部をコピー)をエラーチェック付きで実行する。
Call function strncpy (copying a part of a string) with error checks.

◆形式(Format)

#include <functions_with_errcheck.h>
inline void CKstrncpy(char ∗s1,const char ∗s2,int n)


◆引数(Arguments)

s1 コピーした文字列の代入先。
The array into which the copied string is to be inserted.
s2 元々の文字列。
The original string.
n コピーする文字数。s2の先頭のn文字がs1にコピーされる。
The number of characters to copy; the first n characters of s2 are copied to s1.


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

下表で桃色のセルがエラー処理を表す。
The pick colored cells in the table below represent error checks.
条件
Condition 		戻り値/動作
Return value or behaviour of the function
s1=NULL プログラムをエラー終了する。
The program finishes as an error.
s2=NULL プログラムをエラー終了する。
The program finishes as an error.
n\(\leq\)0 プログラムをエラー終了する。
The program finishes as an error.
nがs2の文字列長よりも大きい
The value of n is greater than the length of the string s2 		プログラムをエラー終了する。
The program finishes as an error.
n\(\geq\)strsize プログラムをエラー終了する。
The program finishes as an error.
上記以外の場合
The other cases 		s2の最初のn文字をs1にコピーする。 末尾に’\0’を付加する。
※C言語組み込み関数strncpyでは’\0’は付加されない。
Copy the first n characters of s2 to s1 and append ’\0’.
∗Note that ’\0’ is not appended in the built-in function strncpy.


◆使用例(Example)

char a[10];
char b[]="abcde";
CKstrncpy(a,b,3);

この例ではa="abc"となる。
The result of this example is a="abc".