ufm::term::TerminalControl 結構 參考文件

終端機控制介面 更多...

#include <TerminalControl.h>

類別ufm::term::TerminalControl的繼承圖:

公開方法(Public Methods)
virtual void	pause (ufm::func::Predicate< ufm::term::TerminalControl > *test, ufm::util::Console::Event *consoleEvent=nullptr) override
	暫時暫停終端機控制處理，直到指定條件滿足
virtual ufm::lang::Readable &	in (void) override
	取得終端機輸入資料流
virtual ufm::io::PrintStream &	out (void) override
	取得終端機輸出列印資料流
virtual const char *	getHostName (void) const override
	取得終端機主機名稱
virtual void	setHostName (const char *hostName) override
	設定終端機主機名稱
virtual bool	isPasswd (void) const override
	檢查是否啟用密碼輸入模式
virtual void	setPasswd (bool passwd) override
	設定密碼輸入模式
virtual void	refreshLine (bool nextLine) override
	換到下一行並重新刷新主機名稱與緩衝區資料

詳細描述

終端機控制介面

此介面定義了終端機的基本控制方法，包括輸入、輸出、脈衝控制和配置管理。 用於實現終端機控制的具體類別應繼承此介面並實現其所有抽象方法。

主要功能：

• 提供輸入資料流存取介面
• 提供輸出列印資料流介面
• 支援脈衝操作與事件處理
• 管理終端機主機名稱配置
• 控制密碼模式的開啟與關閉

典型用途：

• 實現串列埠終端機控制
• 建立網路終端機服務
• 開發命令列介面系統
• 整合終端機模擬器功能

作者

ZxyKira

自

1.0.0

函式成員說明文件

getHostName()

virtual const char * ufm::term::TerminalControl::getHostName ( void ) const

pure virtual

取得終端機主機名稱

此方法用於獲取終端機的主機名稱識別字串， 通常用於終端機提示符顯示或系統識別用途。

傳回值

const char* 主機名稱字串指標，不可為空

實作於 ufm::term::Terminal.

in()

virtual ufm::lang::Readable & ufm::term::TerminalControl::in ( void )

pure virtual

取得終端機輸入資料流

此方法返回終端機的輸入資料流介面，用於從終端機讀取輸入資料。 通常用於處理使用者輸入、指令接收等操作。

傳回值

ufm::lang::Readable& 可讀取的輸入資料流參考

實作於 ufm::term::Terminal.

isPasswd()

virtual bool ufm::term::TerminalControl::isPasswd ( void ) const

pure virtual

檢查是否啟用密碼輸入模式

此方法用於檢查終端機目前是否處於密碼輸入模式。 在密碼模式下，輸入的字元通常不會在螢幕上顯示，以保護敏感資訊。

傳回值

true 目前處於密碼模式

false 目前為一般輸入模式

實作於 ufm::term::Terminal.

out()

virtual ufm::io::PrintStream & ufm::term::TerminalControl::out ( void )

pure virtual

取得終端機輸出列印資料流

此方法返回終端機的輸出列印資料流介面，用於向終端機輸出文字資料。 PrintStream 支援格式化輸出，可用於顯示訊息、提示、錯誤等資訊。

傳回值

ufm::io::PrintStream& 可寫入的輸出列印資料流參考

實作於 ufm::term::Terminal.

pause()

virtual void ufm::term::TerminalControl::pause ( ufm::func::Predicate< ufm::term::TerminalControl > * test, ufm::util::Console::Event * consoleEvent = nullptr )

pure virtual

暫時暫停終端機控制處理，直到指定條件滿足

此抽象方法會阻塞 TerminalControl 的後續執行， 直到提供的謂詞返回 true 為止。 在阻塞期間，會反覆呼叫 test->evaluate(this) 來判斷是否解除暫停，以便外部或內部邏輯控制恢復時機。

參數

test	指向封裝測試邏輯的 Predicate 物件指標。 當 test->evaluate(this) 返回 true 時， 暫停結束，繼續執行後續操作。
consoleEvent	可選的 Console::Event 物件指標， 用於處理終端機事件。

實作於 ufm::term::Terminal.

refreshLine()

virtual void ufm::term::TerminalControl::refreshLine ( bool nextLine )

pure virtual

換到下一行並重新刷新主機名稱與緩衝區資料

此方法會將終端機游標換到下一行，然後重新輸出主機名稱提示字元， 並清空輸入緩衝區資料。

參數

nextLine

是否換到下一行，預設為 true

實作於 ufm::term::Terminal.

setHostName()

virtual void ufm::term::TerminalControl::setHostName ( const char * hostName )

pure virtual

設定終端機主機名稱

此方法用於設定終端機的主機名稱識別字串， 設定後會影響終端機提示符的顯示內容。

參數

hostName

要設定的主機名稱字串，不可為空指標

實作於 ufm::term::Terminal.

setPasswd()

virtual void ufm::term::TerminalControl::setPasswd ( bool passwd )

pure virtual

設定密碼輸入模式

此方法用於開啟或關閉終端機的密碼輸入模式。 當啟用密碼模式時，使用者輸入的字元將不會顯示在螢幕上， 以保護密碼或其他敏感資訊的安全性。

參數

passwd

true 啟用密碼模式，false 關閉密碼模式

實作於 ufm::term::Terminal.

---

此結構(structure) 文件是由下列檔案中產生:

• TerminalControl.h