~~NOTOC~~
---json
{
    "title":"timeleft()",
    "description":"タイムアウトまでの残り時間を取得します"
}
---
\\
====== timeleft() ======

<blockquote>
==== 説明 ====
タイムアウトまでの残り時間を取得します。\\

==== 構文 ====
<code perl>
r = timeleft();
</code>

==== 引数 ====
ありません\\

==== 返り値 ====
<code perl>
 r =
    残り時間 : gsettimeofday形式
               (タイムアウト時: [ 0, 0 ])
       undef : timeout値が未定義
</code>

==== 備考 ====
<note type="info">
gettimeofday形式はTime::HiResの関数gettimeofday()の返り値と同じ形式で
<code perl>
[ sec, msec ]

 sec: 秒(整数)
msec: マイクロ秒(整数: 範囲: 0～999999 )
</code>
で表します。
</note>

<note type="tip">
安全性は不明ですが、返り値に
<code perl>
sprintf("%d.%06d")
</code>
通すと数値表記の文字列として得られます。\\
</note>

</blockquote>

~~DISCUSSION~~