関数win_channelTableContents_fill_failed マニュアル

(The documentation of function win_channelTableContents_fill_failed)
Last Update: 2026/1/8


◆機能・用途(Purpose)

WINシステムのチャンネルテーブルファイルの読み込み時に 省略された情報を同一観測点の他成分の情報からコピーしようとしたが 複数候補があり複製できなかった旨のエラーメッセージを表示する。 関数win_readChannelTable からの内部呼び出し用である。
Display an error message to inform that omitted information in a channel table file of the WIN system was tried to be copied from the information for other components of the same station when reading, but failed to do it because of the presence of multiple candidates. This function is for internal call from function win_readChannelTable.

◆形式(Format)

#include <win/channel.h>
inline void win_channelTableContents_fill_failed
(const char ∗channelTableFile, const struct win_channelTableContents data,
 const char ∗quantity)


◆引数(Arguments)

channelTableFile 読み込んだチャンネルテーブルファイル名。
The file name of the channel table read.
data 省略された情報の設定に失敗したチャンネルのデータ。
Data of the channel for which setting omitted information failed.
quantity 設定に失敗した情報の種類。以下のいずれかとする。
Type of the information that was failed to set. Choose from the following candidates.
  • "latitude"
    観測点の緯度。
    The latitude of the station.

  • "longitude"
    観測点の経度。
    The longitude of the station.

  • "altitude"
    観測点の標高。
    The altitude of the station.

  • "P_correction"
    P波の観測点補正値。
    The station correction of P-wave.

  • "S_correction"
    S波の観測点補正値。
    The station correction of S-wave.



◆動作(Behaviour)

第2引数で与えたチャンネルにおいて 省略された第3引数の値を他チャンネルを参照して設定できなかった旨のエラーメッセージを出力し、 プログラムを終了する。
Display an error message to inform that the omitted value of the quantity specified by the 3rd argument for the channel specified by the 2nd argument was failed to copy from other channels, and finish the program.

◆使用例(Example)

struct win_channelTableContents data;
win_channelTableContents_fill_failed ("channels.tbl",data,"latitude");