このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

readline

TCP/IP を介したリモート ホストからの ASCII 文字列データ行の読み取り

ページ内をすべて折りたたむ

構文

data = readline(t)

説明

data = readline(t) は、TCP/IP クライアント t で指定されたリモート ホストからの終端文字の最初の出現まで ASCII データを読み取り、data を終端文字なしで string として返します。関数が t の Timeout プロパティで指定された期間内にデータを返せない場合は、0 行 0 列の double の [] として data を返します。この関数は、終端文字に到達するかタイムアウトが発生するまで、MATLAB® の実行を一時停止します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

t という TCP/IP クライアント接続を作成します。TCP/IP エコー サーバーにポート 4000 で接続します。そのためには、echotcpip サーバーをポート 4000 で実行していなければなりません。

echotcpip("on",4000)
t = tcpclient("localhost",4000)
t = 
  tcpclient with properties:

              Address: 'localhost'
                 Port: 4000
    NumBytesAvailable: 0

  Show all properties, functions

既定の ASCII 終端文字をチェックします。

t.Terminator
ans = 
"LF"

終端文字を "CR" に設定し、ASCII データの文字列を書き込みます。関数 writeline は、終端文字をデータに自動的に追加します。

configureTerminator(t,"CR")
writeline(t,"hello")

終端文字が自動的に追加された別の ASCII データの文字列を書き込みます。

writeline(t,"world")

クライアントはエコー サーバーに接続しているため、サーバーに書き込むデータはクライアントに返されます。ASCII データ文字列を読み取ります。関数 readline は、終端文字に到達するまでデータを返します。

readline(t)
ans = 
"hello"

ASCII データ文字列をもう一度読み取り、書き込んだ 2 つ目の文字列を返します。

readline(t)
ans = 
"world"

エコー サーバーを閉じ、TCP/IP クライアント接続をクリアします。

echotcpip("off")
clear t

入力引数

すべて折りたたむ

TCP/IP クライアント。tcpclient オブジェクトとして指定します。

例: readline(t) は、TCP/IP クライアント t で指定されたリモート ホストから ASCII データを読み取ります。

バージョン履歴

R2020b で導入

参考

関数