BBSRubySyntax

原文作者：@itsZero

BBSRuby 版本 v0.2, API Interface: v0.111

為什麼開發 BBSRuby?

因為人家有 BBSLua （誤），其實只是想學學看怎麼把 Ruby interpreter 嵌入程式中。剛好人家有這麼棒的點子就拿來用囉XD 以前也曾想要寫 C# 的 BBS 有一項功能就是用 C# 的 Runtime Compiler Service 弄 C# Script。

不過... 該計畫... 被放棄了（小聲）所以算是實現當時的願望吧 (?) XD

v0.2

v0.3

BBSRuby大致上與BBSLua相容，不過依然有一些變動。
如程式開頭結束皆使用###BBSRuby。至於API的部份，BBSRuby將參考 BBSLua API實做。以下將以BBSLua的API列表搭配說明/顏色指示支援狀態。
原文作者為 piaip。

支援狀況：不支援部份實做完全支援 BBSRuby專屬

TOC標籤
`##Interface:`	BBS-Ruby API 版本號碼 (可方便系統警示不相容的訊息)
`##Title:`	程式名稱
`##Notes:`	程式說明
`##Author:`	作者資訊
`##Version:`	程式自訂的版號
`##Date:`	最後修改日期

請注意 BBSRuby 的輔助函式以 "BBS." 不是 "bbs."，TOC存取方式也不同。

輸出
`bbs.addstr(str, ...)`	畫字到目前位置
	目前請使用`outs`。視情況考慮是否 alias `outs` 過來。

`bbs.outs(str, ...)`	畫字到目前位置 (同 `addstr`)
`bbs.title(str)`	移至左上角繪製標題
`bbs.print(str, ...)`	印完所印字串後再加上一個換行
`print(str, ...)`	同 `bbs.print`
	不支援STDOUT輸出。請使用`bbs.outs` / `bbs.print`。

	* 全系列畫字函式都可以接受 ANSI 指令
	* 注意: 輸出並不會立刻反應在畫面上，要等 `refresh()`
	或其它輸入函式才會作全螢幕的更新。請見 `refresh()` 說明

`bbs.vmsg(str)`	顯示訊息提示框

2D繪圖
`bbs.box(rows,cols,title)`	以目前游標位置為起點，用目前色彩屬性繪製一個高度 `rows` 寬度 `cols` 的視窗。
	若有指定 `title` (可省略) 則會置中輸出字串

更新畫面
`bbs.refresh()`	呼叫此命令時才會真的更新畫面
	(呼叫輸入等待指令如 `getch`/`getstr`/`pause`/`kbhit`/`sleep`/`vmsg`時也會自動更新)

輸入
`bbs.getch()`	輸入單鍵
	特殊按鍵為大寫名: `UP` `DOWN` `LEFT` `RIGHT`
	`ENTER` `BS` `TAB` `HOME` `END` `INS` `DEL` `PGUP` `PGDN` `F1` ... `F12`
	另外與 Ctrl 合按的複合鍵會以 `^X` 的形式出現。

`bbs.getdata(n,echo)`	畫 n 個字元的輸入框並輸入字串
	echo (可省略) = 0 時只輸入不畫字 (可作密碼輸入)
`bbs.getstr(n,echo)`	同 `getdata`
	請使用 `bbs.getdata`。

`bbs.pause(msg)`	在底部畫暫停訊息並等輸入單鍵 (傳回值同 `getch()`)

`bbs.kbhit(wait)`	傳回使用者是否有按鍵 (若無輸入則會等待最多 `wait` 秒)
`bbs.kbreset()`	清空輸入緩衝區 (吃掉所有已輸入的鍵)
	因為BBS I/O核心的關係暫時不支援。