EthernetUDP.available()

描述

回傳目前收到的封包所包含的資料量，這些資料都是目前可以讀取的。要使用 available() 前必須先呼叫 UDP.parsePacket() ，否則 available() 的呼叫會失敗。

available() 是從 Stream 繼承而來。

語法


Udp.available()


參數

無參數

回傳

int：目前可以讀取的資料量，以位元組為單位

範例

#include <Ethernet.h>
#include <EthernetUdp.h>

// 輸入本地端的 IP 位址
IPAddress ip(192, 168, 1, 177);

// 要監聽的本地端埠編號
unsigned int localPort = 8888;

// 創建一個 EthernetUDP 物件，我們可以藉由這個物件收發 UDP 的封包
EthernetUDP Udp;

// 要拿來存放資料的陣列
char packetBuffer[UDP_TX_PACKET_MAX_SIZE];

void setup() {
  // 開始 Ethernet 和 EthernetUDP
  Ethernet.begin(NULL,ip);
  Udp.begin(localPort);
}

void loop() {
  int packetSize = Udp.parsePacket();

  if(Udp.available())
  {
    Serial.print("Received packet of size ");
    Serial.println(packetSize);
    Serial.print("From ");
    IPAddress remote = Udp.remoteIP();
    for (int i =0; i < 4; i++)
    {
      Serial.print(remote[i], DEC);
      if (i < 3)
      {
        Serial.print(".");
      }
    }
    Serial.print(", port ");
    Serial.println(Udp.remotePort());

    //  讀取透過 UDP 接收到的資料並且放到 packetBuffer
    Udp.read(packetBuffer,UDP_TX_PACKET_MAX_SIZE);
    Serial.println("Contents:");
    Serial.println(packetBuffer);
 }
}

See Also

－ Stream.available()

函式庫參考主頁面

The text of the 86Duino reference is a modification of the Arduino reference, and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.