関数coordinateString2coordinate_int マニュアル

(The documentation of function coordinateString2coordinate_int)

Last Update: 2022/10/17

◆機能・用途(Purpose)

整数値をカンマ(,)で区切って並べた文字列からそれらの整数値を数値として取り出す。
Extract integers as numerical values from a string that consists of these integers separated by commas (,).

◆形式(Format)

#include <mystring.h>
inline void coordinateString2coordinate_int
(const char ∗string,const int correct_number,...)

◆引数(Arguments)

string	整数値をカンマ(,)で区切って並べた文字列またはその全体を()で括った文字列。 A string composed of integers separated by commas (,), or that string bounded by parenthesis ().
correct_number	文字列中に含まれる期待される整数値の個数。 The expected number of integers in the string.
...	取り出した整数値の代入先。宣言しただけのint型変数を&を付けて与える。これを文字列中に含まれる整数値の数だけ並べる。 The memories into which the extracted integers will be inserted. Give empty int-type variables with &. Deploy them up to the number of integers.

◆使用例(Example)

●例1(Example 1)

int x,y;
coordinateString2coordinate_int("123,456",2,&x,&y);

この例ではx=123, y=456となる。
This example gives x=123 and y=456.

●例2(Example 2)

int x,y;
coordinateString2coordinate_int("(123,456)",2,&x,&y);

この例でもx=123, y=456となる。
This example also gives x=123 and y=456.

●例3(Example 3)

int data[4];
coordinateString2coordinate_int ("12,34,56,78",4, &(data[0]),&(data[1]),&(data[2]),&(data[3]));

この例ではdata[0]=12, data[1]=34, data[2]=56, data[3]=78となる。
This example gives data[0]=12, data[1]=34, data[2]=56, and data[3]=78.

●例4(Example 4)

int x,y,z;
coordinateString2coordinate_int ("12,34,56,78",3,&x,&y,&z);

第1引数の文字列「12,34,56,78」が整数値を4つ含むにも関わらず第2引数で整数値の個数が3個であるという指定がなされているミスである。この場合、プログラムをエラー終了する。
A mistake such that the string “12,34,56,78” in the 1st argument consists of four integers while the 2nd argument indicates that the string should consist of three integers. In this case, the program finishes as an error.

●例5(Example 5)

int x,y,z;
coordinateString2coordinate_int ("12,34",3,&x,&y,&z);

第1引数の文字列「12,34」が整数値を2つしか含まないにも関わらず第2引数で整数値の個数が3個であるという指定がなされているミスである。この場合、プログラムをエラー終了する。
A mistake such that the string “12,34” in the 1st argument consists of two integers while the 2nd argument indicates that the string should consist of three integers. In this case, the program finishes as an error.

◆補足(Additional notes)

この関数は座標を表す文字列を数値としての座標に変換することを目的として開発した。関数名はその名残である。
This function was developed for conversion of a string that represents a coordinate to the numerical coordinate values. The function name indicates this original purpose.