関数coordinateString2coordinate マニュアル

(The documentation of function coordinateString2coordinate)
Last Update: 2022/10/17


◆機能・用途(Purpose)

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

◆形式(Format)

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


◆引数(Arguments)

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


◆使用例(Example)

●例1(Example 1)

double x,y;
coordinateString2coordinate("12.3,45.6",2,&x,&y);

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

●例2(Example 2)

double x,y;
coordinateString2coordinate("(12.3,45.6)",2,&x,&y);

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

●例3(Example 3)

double data[4];
coordinateString2coordinate ("1.2,3.4,5.6,7.8",4, &(data[0]),&(data[1]),&(data[2]),&(data[3]));

この例ではdata[0]=1.2, data[1]=3.4, data[2]=5.6, data[3]=7.8となる。
This example gives data[0]=1.2, data[1]=3.4, data[2]=5.6, and data[3]=7.8.

●例4(Example 4)

double x,y,z;
coordinateString2coordinate ("1.2,3.4,5.6,7.8",3,&x,&y,&z);

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

●例5(Example 5)

double x,y,z;
coordinateString2coordinate ("1.2,3.4",3,&x,&y,&z);

第1引数の文字列「1.2,3.4」が実数値を2つしか含まないにも関わらず 第2引数で実数値の個数が3個であるという指定がなされているミスである。 この場合、プログラムをエラー終了する。
A mistake such that the string “1.2,3.4” in the 1st argument consists of two real numbers while the 2nd argument indicates that the string should consist of three real numbers. 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.