関数win_str2channelCode マニュアル

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


◆機能・用途(Purpose)

チャンネルコードを表す文字列を数値(unsigned short型)に変換する。
Convert a string that represents a channel code to the corresponding numerical value of unsigned short-type.

◆形式(Format)

#include <win/channel.h>
inline unsigned short win_str2channelCode
(const char ∗original,const char ∗mode)


◆引数(Arguments)

original チャンネルコードを表す文字列(4桁の16進数)。 A-Fは大文字でも小文字でも良い。
A string that represents a channel code (a hexadecimal number of 4-digits). A-F can be either capital or small letters.
mode 以下のいずれかの文字列とする。
Use one of the following strings.
  • "strict" :
    きっかり4文字の文字列のみを処理対象にする。 5文字以上の文字列が与えられた場合はプログラムをエラー終了する。
    Only a string with exactly four characters is processed; a string with more than four characters results in an error.
  • "tolerant" :
    4文字以上の文字列の最初の4文字を処理対象にする。
    The first four characters of a string composed of ≥ 4 characters are processed.


◆戻り値(Return value)

引数originalで与えた文字列が表す16進数。
A hexadecimal number represented by the argument original.

◆使用例(Example)

unsigned short ex1=win_str2channelCode ("999A", "strict");

unsigned short ex2=win_str2channelCode ("999A 1 0 NGY2 U 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0", "tolerant");

1つ目の例はチャンネルコードそのものを与えた場合、 2つ目の例はチャンネルテーブルの1行分の中身をそのまま与えた場合の例である。
A channel code is directly given in the 1st example, while a line from a channel table is given in the 2nd example.