Developer World
Spresense Arduino Library v3.2.0-77d75a4
LTEClient Class Reference

[en] Create a client that can connect to a specific Internet IP address and port.
[ja] 特定のインターネットIPアドレスとポートに接続可能なクライアントを作成します。 More...

#include <LTEClient.h>

Inheritance diagram for LTEClient:
Collaboration diagram for LTEClient:

Public Member Functions

 LTEClient ()
 Construct LTEClient instance.
 
 ~LTEClient ()
 Destruct LTEClient instance.
 
int connect (IPAddress ip, uint16_t port)
 Connects to a specified IP address and port. More...
 
int connect (const char *host, uint16_t port)
 Connects to a specified host name and port. More...
 
size_t write (uint8_t val)
 Send one byte data to the server the client is connected to. More...
 
size_t write (const uint8_t *buf, size_t size)
 Send series of bytes data to the server the client is connected to. More...
 
int available ()
 Returns the number of bytes available for reading. More...
 
int read ()
 Read the next byte received from the server the client is connected to. More...
 
int read (uint8_t *buf, size_t size)
 Read series of bytes received from the server the client is connected to. More...
 
int peek ()
 Returns the next byte received from the server without removing it from the buffer. More...
 
void flush ()
 Discards any bytes that have been written to the client. More...
 
void stop ()
 Disconnect from the server. More...
 
uint8_t connected ()
 Whether or not the client is connected. More...
 
 operator bool ()
 Assignment operator for bool. More...
 
int setTimeout (uint32_t milliseconds)
 Set the timeout when the client send or receive. More...
 

Detailed Description

[en] Create a client that can connect to a specific Internet IP address and port.
[ja] 特定のインターネットIPアドレスとポートに接続可能なクライアントを作成します。

Member Function Documentation

◆ connect() [1/2]

int LTEClient::connect ( IPAddress  ip,
uint16_t  port 
)

Connects to a specified IP address and port.

[en] Connects to a specified IP address and port.

[ja] 指定されたIPアドレスとポートに接続します。

Parameters
[in]ip[en] Server IP address.
[ja] 接続先サーバーのIPアドレス。
[in]port[en] Server port.
[ja] 接続先サーバーのポート番号。
Returns
[en] On success, 1 is returned. On failure, 0 is returned.
[ja] 接続に成功した場合1を、失敗した場合は0を返します。

◆ connect() [2/2]

int LTEClient::connect ( const char *  host,
uint16_t  port 
)

Connects to a specified host name and port.

[en] Connects to a specified host and port.

[ja] 指定されたホスト名とポートに接続します。

Parameters
[in]host[en] Server host name.
[ja] 接続先サーバーのホスト名。
[in]port[en] Server port.
[ja] 接続先サーバーのポート番号。
Returns
[en] On success, 1 is returned. On failure, 0 is returned.
[ja] 接続に成功した場合1を、失敗した場合は0を返します。

◆ write() [1/2]

size_t LTEClient::write ( uint8_t  val)

Send one byte data to the server the client is connected to.

[en] Send one byte data to the server the client is connected to.

[ja] 接続先のサーバーに1バイトのデータを送信します。

Parameters
[in]val[en] A value to send as a single byte.
[ja] 送信する値。
Returns
[en] The number of bytes sent.
[ja] 送信されたバイト数。

◆ write() [2/2]

size_t LTEClient::write ( const uint8_t *  buf,
size_t  size 
)

Send series of bytes data to the server the client is connected to.

[en] Send series of bytes data to the server the client is connected to.

[ja] 接続先のサーバーに一連のデータを送信します。

Parameters
[in]buf[en] A buffer to send.
[ja] 送信バッファー。
[in]size[en] The length of the buffer.
[ja] 送信バッファーの長さ。
Returns
[en] The number of bytes sent.
[ja] 送信されたバイト数。

◆ available()

int LTEClient::available ( )

Returns the number of bytes available for reading.

[en] Returns the number of bytes available for reading.

[ja] 読み出し可能なバイト数を返します。

Returns
[en] The number of bytes available.
[ja] 読出し可能なバイト数。

◆ read() [1/2]

int LTEClient::read ( )

Read the next byte received from the server the client is connected to.

[en] Read the next byte received from the server the client is connected to.

[ja] 接続先のサーバーから受信したデータを読み出します。

Returns
[en] The next byte, or -1 if none is available.
[ja] 受信したデータ。受信データがない場合は-1を返します。

◆ read() [2/2]

int LTEClient::read ( uint8_t *  buf,
size_t  size 
)

Read series of bytes received from the server the client is connected to.

[en] Read series of bytes received from the server the client is connected to.

[ja] 接続先のサーバーから受信した一連のデータを読み出します。

Parameters
[out]buf[en] A buffer to read.
[ja] 受信バッファー。
[in]size[en] The length of the buffer.
[ja] 受信バッファーの長さ。
Returns
[en] The number of bytes received, or -1 if none is available.
[ja] 受信したバイト数。受信データがない場合は-1を返します。

◆ peek()

int LTEClient::peek ( )

Returns the next byte received from the server without removing it from the buffer.

[en] Returns the next byte received from the server without removing it from the buffer.

[ja] 接続先のサーバーから受信したデータを、バッファーから削除せずに読み出します。

Returns
[en] The next byte, or -1 if none is available.
[ja] 受信したデータ。受信データがない場合は-1を返します。

◆ flush()

void LTEClient::flush ( )

Discards any bytes that have been written to the client.

[en] Discards any bytes that have been written to the client.

[ja] クライアントに書き込まれたデータを破棄します。

◆ stop()

void LTEClient::stop ( )

Disconnect from the server.

[en] Disconnect from the server.

[ja] サーバーから切断します。

◆ connected()

uint8_t LTEClient::connected ( )

Whether or not the client is connected.

[en] Whether or not the client is connected. Note that a client is considered connected if the connection has been closed but there is still unread data.

[ja] クライアントが接続されているかどうかを返します。接続は閉じられているが未読データが残っている場合、クライアントは接続されていると見なされることに注意してください。

Returns
[en] Returns 1 if the client is connected, 0 if not.
[ja] クライアントが接続されている場合は1を、そうでない場合は0を返します。

◆ operator bool()

LTEClient::operator bool ( )
inline

Assignment operator for bool.

[en] Whether or not the client is connected.

[ja] クライアントが接続されているかどうかを返します。

Returns
[en] Returns 1 if the client is connected, 0 if not.
[ja] クライアントが接続されている場合は1を、そうでない場合は0を返します。

◆ setTimeout()

int LTEClient::setTimeout ( uint32_t  milliseconds)

Set the timeout when the client send or receive.

[en] Set the timeout when the client send or receive. 0 means disabled (no timeout). If this method has not been called, the timeout is 0.

[ja] クライアントが送受信をする際のタイムアウトを設定します。0は無効(タイムアウトしない)を意味します。本メソッドを呼び出さない場合のタイムアウトは0です

Returns
[en] Returns 0 if succeeded, -1 if not.
[ja] 成功した場合は0を、そうでない場合は-1を返します。

The documentation for this class was generated from the following file: