関数win_selectChannelTable_time マニュアル

(The documentation of function win_selectChannelTable_time)
Last Update: 2022/3/18


◆機能・用途(Purpose)

チャンネルテーブルのデータから 指定された日時において有効な部分を抜き出す。
Extract a partial channel table data that are effective at a specified date and time.

◆形式(Format)

#include <win/channel.h>
inline struct win_channelTable win_selectChannelTable_time
(const struct win_channelTable original,
 const struct humanTime dateTime_st, const struct humanTime dateTime_en)


◆引数(Arguments)

original チャンネルテーブルのデータ。
Data of a channel table.
dateTime_st 対象とする日時範囲の先頭。
Start of the target date-time range.
dateTime_en 対象とする日時範囲の末尾。
End of the target date-time range.


◆戻り値(Return value)

引数originalに格納されているチャンネルテーブルのデータから、 引数dateTime_st, dateTime_enで指定した日時範囲において有効な チャンネルのデータのみを抜き出した構造体。
A structure composed of data of channel tables that are effective during the date-time range specified by arguments dateTime_st and dateTime_en, extracted from the original data included in argument original.
※dateTime_stからdateTime_enまでの 全期間にわたって有効なチャンネルのみを抜き出す。
∗ Only the channels that are effective for all period from dateTime_st to dateTime_en.

◆使用例(Example)

struct humanTime dateTime_st ={2022,3,18,9,0,0.0};

struct humanTime dateTime_en ={2022,3,18,10,0,0.0};

struct win_channelTable original
  =win_readChannelTable("channels.tbl");

struct win_channelTable extracted
  =win_selectChannelTable (original, dateTime_st, dateTime_en);