Arduino:Библиотеки/Ethernet/Класс EthernetUDP/available()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.

Функция available()[1]

Получает информацию о количестве байтов (символов), доступных для считывания из буфера. То есть это данные, которые уже прибыли.

Эту функцию можно вызывать только после EthernetUDP.parsePacket(). В противном случае она работать не будет.

Функция available() наследует у класса Stream.

Синтаксис

EthernetUDP.available()

Параметры

Нет.

Что возвращает

Количество байтов, доступных для считывания.

Пример

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

// Ниже введите MAC-адрес и IP-адрес для своего контроллера.
// IP-адрес будет зависеть от локальной сети:
byte mac[] = {  
  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
IPAddress ip(192, 168, 1, 177);

unsigned int localPort = 8888;      // локальный порт, который нужно прослушивать

// экземпляр EthernetUDP, необходимый для получения и передачи пакетов через UDP:
EthernetUDP Udp;

char packetBuffer[UDP_TX_PACKET_MAX_SIZE]; // буфер, в котором будет храниться присланный пакет

void setup() {
  // запускаем Ethernet и UDP:
  Ethernet.begin(mac,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());

    // считываем пакет в packetBuffer:
    Udp.read(packetBuffer,UDP_TX_PACKET_MAX_SIZE);
    Serial.println("Contents:");  //  "Содержимое:"
    Serial.println(packetBuffer);
 }
}

См.также

  1. Stream.available()

Внешние ссылки