WiFiClient

Last revision:2024/09/11

WiFiClientクラス

WiFiClientクラスは、サーバに接続し、データを送受信するのに利用される。

関数

WiFiClient

説明

WiFiClientは、クライアントのためのベースクラスである。直接呼ばれることはないが、継承した関数を利用する際に実行される。

WIFiClient()

説明

clieent.connect()で定義した、指定したIPアドレスIPアドレスとポートに接続可能なクライアントを作成する。

書式

WIFiClient client;

引数

なし。

戻り値

なし。

コード例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


#include <SPI.h>
#include <WiFi.h>

char ssid[] = "myNetwork";          //  your network SSID (name)
char pass[] = "myPassword";   // your network password

int status = WL_IDLE_STATUS;
IPAddress server(74,125,115,105);  // Google

// Initialize the client library
WiFiClient client;

void setup() {
  Serial.begin(9600);
  Serial.println("Attempting to connect to WPA network...");
  Serial.print("SSID: ");
  Serial.println(ssid);

  status = WiFi.begin(ssid, pass);
  if ( status != WL_CONNECTED) {
    Serial.println("Couldn't get a wifi connection");
    // don't do anything else:
    while(true);
  }
  else {
    Serial.println("Connected to wifi");
    Serial.println("\nStarting connection...");
    // if you get a connection, report back via serial:
    if (client.connect(server, 80)) {
      Serial.println("connected");
      // Make a HTTP request:
      client.println("GET /search?q=arduino HTTP/1.0");
      client.println();
    }
  }
}

void loop() {

}

client.connected()

説明

クライアントが接続しているかどうかを返す。接続は終了しているが未読のデータが存在する場合は、クライアントは接続しているとみなされる。

書式

client.connected();

引数

なし。

戻り値

クライアントが接続している場合はtrue、そうでなければfalse。

コード例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51


#include <SPI.h>
#include <WiFi.h>

char ssid[] = "myNetwork";          //  your network SSID (name)
char pass[] = "myPassword";   // your network password

int status = WL_IDLE_STATUS;
IPAddress server(74,125,115,105);  // Google

// Initialize the client library
WiFiClient client;

void setup() {
  Serial.begin(9600);
  Serial.println("Attempting to connect to WPA network...");
  Serial.print("SSID: ");
  Serial.println(ssid);

  status = WiFi.begin(ssid, pass);
  if ( status != WL_CONNECTED) {
    Serial.println("Couldn't get a wifi connection");
    // don't do anything else:
    while(true);
  }
  else {
    Serial.println("Connected to wifi");
    Serial.println("\nStarting connection...");
    // if you get a connection, report back via serial:
    if (client.connect(server, 80)) {
      Serial.println("connected");
      // Make a HTTP request:
      client.println("GET /search?q=arduino HTTP/1.0");
      client.println();
    }
  }
}

void loop() {
   if (client.available()) {
    char c = client.read();
    Serial.print(c);
  }

  if (!client.connected()) {
    Serial.println();
    Serial.println("disconnecting.");
    client.stop();
    for(;;)
      ;
  }
}

client.connect()

説明

コンストラクタで指定したIPアドレスとポートに接続する。戻り値は成功か失敗かを示す。connect()は、ドメイン名(例: google.com)を利用した際のDNS検索もサポートしている。

書式

client.connect(ip, port);

client.connect(URL, port);

引数

`ip`	クライアントが接続しようとするIPアドレス(4バイトの配列)
`URL`	クライアントが接続しようとするホスト名(文字列。例: “arduino.cc”)
`port`	クライアントが接続しようとするポート(int)

戻り値

接続に成功したらtrue、そうでなければfalse。

コード例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39


#include <SPI.h>
#include <WiFi.h>

char ssid[] = "myNetwork";          //  your network SSID (name)
char pass[] = "myPassword";   // your network password

int status = WL_IDLE_STATUS;
char servername[]="google.com";  // remote server we will connect to

WiFiClient client;

void setup() {
  Serial.begin(9600);
  Serial.println("Attempting to connect to WPA network...");
  Serial.print("SSID: ");
  Serial.println(ssid);

  status = WiFi.begin(ssid, pass);
  if ( status != WL_CONNECTED) {
    Serial.println("Couldn't get a wifi connection");
    // don't do anything else:
    while(true);
  }
  else {
    Serial.println("Connected to wifi");
    Serial.println("\nStarting connection...");
    // if you get a connection, report back via serial:
    if (client.connect(servername, 80)) {
      Serial.println("connected");
      // Make a HTTP request:
      client.println("GET /search?q=arduino HTTP/1.0");
      client.println();
    }
  }
}

void loop() {

}

client.write()

説明

クライアントが接続しているサーバにデータを送信する。

書式

client.write(data);

引数

data

送信するbyteもしくはchar

戻り値

送信した文字数(byte)。この値を読む必要はない。

client.print()

説明

クライアントが接続しているサーバにデータを送信する。数字は、それぞれASCII文字(例えば数字の123は、‘1’、‘2’、‘3’の3文字としえ送信される)の数値列として送信する。

書式

client.print(data);

client.print(data, BASE);

引数

`data`	送信するデータ(char、byte、int、long、文字列)
`BASE`	数値を送信する際の基数。10進数の場合DEC、8進数の場合OCT、16進数の場合HEX。

戻り値

byte

送信したバイト数。この値を読む必要はない。

client.println()

説明

クライアントが接続しているサーバにデータを送信し、その後に、キャリッジリターンと改行文字を送信する。数字は、それぞれASCII文字(例えば数字の123は、‘1’、‘2’、‘3’の3文字としえ送信される)の数値列として送信する。

書式

client.println();

client.print(data);

client.print(data, BASE);

引数

`data`	送信するデータ(char、byte、int、long、文字列)
`BASE`	数値を送信する際の基数。10進数の場合DEC、8進数の場合OCT、16進数の場合HEX。

戻り値

byte

送信したバイト数。この値を読む必要はない。

client.available()

説明

読み込み可能なバイト数を返す。すなわち、接続しているサーバからクライアントに送信されたデータの総量を返す。

available()はStreamクラスを継承している。

書式

client.available();

引数

なし。

戻り値

読み込み可能なバイト数。

コード例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55


#include <SPI.h>
#include <WiFi.h>

char ssid[] = "myNetwork";          //  your network SSID (name)
char pass[] = "myPassword";   // your network password

int status = WL_IDLE_STATUS;
char servername[]="google.com";  // Google

WiFiClient client;

void setup() {
  Serial.begin(9600);
  Serial.println("Attempting to connect to WPA network...");
  Serial.print("SSID: ");
  Serial.println(ssid);

  status = WiFi.begin(ssid, pass);
  if ( status != WL_CONNECTED) {
    Serial.println("Couldn't get a wifi connection");
    // don't do anything else:
    while(true);
  }
  else {
    Serial.println("Connected to wifi");
    Serial.println("\nStarting connection...");
    // if you get a connection, report back via serial:
    if (client.connect(servername, 80)) {
      Serial.println("connected");
      // Make a HTTP request:
      client.println("GET /search?q=arduino HTTP/1.0");
      client.println();
    }
  }
}

void loop() {
  // if there are incoming bytes available
  // from the server, read them and print them:
  if (client.available()) {
    char c = client.read();
    Serial.print(c);
  }

  // if the server's disconnected, stop the client:
  if (!client.connected()) {
    Serial.println();
    Serial.println("disconnecting.");
    client.stop();

    // do nothing forevermore:
    for(;;)
      ;
  }
}

client.read()

説明

クライアントが接続しているサーバから受信したデータ(最後のread()呼び出し後)を読む。

read()はStreamクラスを継承している。

書式

client.read();

引数

なし。

戻り値

読み込んだデータ(byteかchar)。データがない場合は-1。

client.flush()

説明

クライアントに書き込まれたが、まだ読んでいないデータを破棄する。

flush()はStreamクラスを継承している。

書式

client.flush();

引数

なし。

戻り値

なし。

client.stop()

説明

サーバから切断する。

書式

client.stop();

引数

なし。

戻り値

なし。

オリジナルのページ

https://docs.arduino.cc/language-reference/en/functions/wifi/client/