Hand_Number 関数

ハンドラベルに関連づけられたハンド番号を取得します。

書式
Hand_Number( ハンドラベル )

パラメーター
ハンドラベル: 設定済みのハンドラベルを指定します。(最大で半角31文字まで)

戻り値
ハンド番号(整数)

解説
ハンド設定画面で指定したハンドラベルに関連づけられたハンド番号を表示します。指定したラベルを持つハンドが見つからない場合は、 “エラー2555: 未定義のラベルが指定された 定義したラベルを指定してください”が発生します。

注意
ラベルを付与していないハンド
ハンドの設定で、ハンドラベルの付与は必須ではありません。そのため、ラベル名がないハンドを複数登録することができます。
次のように入力するとラベル名がないハンドの中で最も番号が小さいハンドの番号が返されます。

> print Hand_Number("")  

プログラム中でのハンドの識別が難しくなるため、登録したすべてのハンドにハンドラベルを付与することを推奨します。

参照
Hand_Label$ 関数

Hand_Number 関数使用例

String HandName$  
  
Print Hand_Number(Hand1)		' ハンド1の番号を表示  
Print Hand_Number("Hand1")  
  
HandName$ = "Hand1"  
Print Hand_Number(HandName$)