関数win_listStations_from_channelTable マニュアル

(The documentation of function win_listStations_from_channelTable)

Last Update: 2023/3/24

◆機能・用途(Purpose)

WINのチャンネルテーブルに含まれる観測点をリストアップする。
List the stations included in a WIN channel table.

◆形式(Format)

#include <win/channel.h>
inline int win_listStations_from_channelTable
(const struct win_channelTable channelTable, char ∗∗∗stations)

◆引数(Arguments)

channelTable

チャンネルテーブルデータ。
A channel table data.

stations

観測点リストの代入先。宣言しただけのchar ∗∗型変数に&を付けて与える。関数内で観測点数を要素数とする文字列配列として動的メモリが確保され、観測点コードが代入される。
Memory into which the station list is to be inserted. Give an empty char ∗∗-type variable with &. Within the function, a dynamic memory for an array of strings is allocated, where the number of array components equals that of stations, and the station codes are inserted into the array.

◆戻り値(Return value)

引数channelTableに含まれる観測点数。一般に1つの観測点に複数の成分が含まれるのでチャンネル数とは異なる。
The number of stations in the argument channelTable. This is generally different from the number of channels, as each station may consist of multiple components.

◆使用例(Example)

struct win_channelTable channelTable =win_readChannelTable("channels.tbl");
char ∗∗stations;
int Nstations =win_listStations_from_channelTable(channelTable,&stations);