関数correct_DegMinSec マニュアル

(The documentation of function correct_DegMinSec)

Last Update: 2021/12/27

◆機能・用途(Purpose)

struct DegMinSec型構造体の値を正しいものに修正する。
Correct the value of a struct DegMinSec-type structure.

◆形式(Format)

#include <coordinate.h>
inline struct DegMinSec correct_DegMinSec(const struct DegMinSec original)

◆引数(Arguments)

original

修正したい座標。
The coordinate to be corrected.

◆戻り値(Return value)

修正後の座標。引数originalで与えた座標を「分」「秒」が0以上60未満となるように修正した値を返す。メンバdegの値が非負になるように符号についても修正する。
The coordinate corrected from argument original, such that the minute and second are greater than or equal to 0 and less than 60. Also, the sign is corrected such that the sign of member deg is non-negative.

例(Example):

\(35^{\circ}09’60{’}{’}\) → \(35^{\circ}10’00{’}{’}\)
\(35^{\circ}-1’10{’}{’}\) → \(34^{\circ}59’10{’}{’}\)
\(-2^{\circ}34’46{’}{’}\) (sign\(=1\), deg\(=-2\)) → \(-2^{\circ}34’46{’}{’}\) (sign\(=-1\), deg\(=2\))

◆使用例(Example)

struct DegMinSec original;
original.sign=1;
original.deg=-23;
original.min=-45;
original.sec=67;
struct DegMinSec corrected=correct_DegMinSec(original);

この例では \(-23^{\circ}-45’67{’}{’}\) → \(-23^{\circ}-44’07{’}{’}\) → \(-24^{\circ}16’07{’}{’}\) と修正されて
corrected.sign=-1
corrected.deg=24
corrected.min=16
corrected.sec=7.0
となる。
In this example, the correction is made as \(-23^{\circ}-45’67{’}{’}\) → \(-23^{\circ}-44’07{’}{’}\) → \(-24^{\circ}16’07{’}{’}\), resulting in the following values:
corrected.sign=-1,
corrected.deg=24,
corrected.min=16, and
corrected.sec=7.0.