WiFiServer - deprecate available(), use accept() everywhere (espressif#8860)

esp8266 and esp32 server.available() is not implemented as documented it is implemented like server.accept() is documented by Arduino Co-authored-by: Rodrigo Garcia <rodrigo.garcia@espressif.com>

Author: JAndrassy

libraries/ESPmDNS/examples/mDNS_Web_Server/mDNS_Web_Server.ino

@@ -69,7 +69,7 @@ void setup(void)
 void loop(void)
 {
  // Check if a client has connected
- WiFiClient client = server.available();
+ WiFiClient client = server.accept();
  if (!client) {
  return;
  }

libraries/WebServer/src/WebServer.cpp

@@ -274,7 +274,7 @@ void WebServer::serveStatic(const char* uri, FS& fs, const char* path, const cha
 
 void WebServer::handleClient() {
  if (_currentStatus == HC_NONE) {
- _currentClient = _server.available();
+ _currentClient = _server.accept();
  if (!_currentClient) {
  if (_nullDelay) {
  delay(1);

libraries/WiFi/examples/SimpleWiFiServer/SimpleWiFiServer.ino

@@ -63,7 +63,7 @@ void setup()
 }
 
 void loop(){
- WiFiClient client = server.available(); // listen for incoming clients
+ WiFiClient client = server.accept(); // listen for incoming clients
 
  if (client) { // if you get a client,
  Serial.println("New Client."); // print a message out the serial port

libraries/WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino

@@ -48,7 +48,7 @@ void setup() {
 }
 
 void loop() {
- WiFiClient client = server.available(); // listen for incoming clients
+ WiFiClient client = server.accept(); // listen for incoming clients
 
  if (client) { // if you get a client,
  Serial.println("New Client."); // print a message out the serial port

libraries/WiFi/examples/WiFiTelnetToSerial/WiFiTelnetToSerial.ino

@@ -78,7 +78,7 @@ void loop() {
  //find free/disconnected spot
  if (!serverClients[i] || !serverClients[i].connected()){
  if(serverClients[i]) serverClients[i].stop();
- serverClients[i] = server.available();
+ serverClients[i] = server.accept();
  if (!serverClients[i]) Serial.println("available broken");
  Serial.print("New client: ");
  Serial.print(i); Serial.print(' ');
@@ -88,7 +88,7 @@ void loop() {
  }
  if (i >= MAX_SRV_CLIENTS) {
  //no free/disconnected spot so reject
- server.available().stop();
+ server.accept().stop();
  }
  }
  //check clients for data

libraries/WiFi/src/WiFiServer.cpp

@@ -39,6 +39,10 @@ size_t WiFiServer::write(const uint8_t *data, size_t len){
 void WiFiServer::stopAll(){}
 
 WiFiClient WiFiServer::available(){
+ return accept();
+}
+
+WiFiClient WiFiServer::accept(){
  if(!_listening)
  return WiFiClient();
  int client_sock;

libraries/WiFi/src/WiFiServer.h

@@ -45,8 +45,8 @@ class WiFiServer : public Server {
  log_v("WiFiServer::WiFiServer(addr=%s, port=%d, ...)", addr.toString().c_str(), port);
  }
  ~WiFiServer(){ end();}
- WiFiClient available();
- WiFiClient accept(){return available();}
+ WiFiClient available() __attribute__((deprecated("Renamed to accept().")));
+ WiFiClient accept();
  void begin(uint16_t port=0);
  void begin(uint16_t port, int reuse_enable);
  void setNoDelay(bool nodelay);