WiFiServer operator bool

docs/api.md

@@ -2764,6 +2764,63 @@ void loop() {
 
 ```
 
+### `if(server)`
+
+#### Description
+Indicates whether the server is listening for new clients. You can use this to detect whether server.begin() was successful.
+
+
+#### Syntax
+
+```
+if (server)
+if (!server)
+
+```
+
+#### Parameters
+none
+
+#### Returns
+- whether the server is listening for new clients (bool).
+
+#### Example
+
+```
+#include <WiFiNINA.h>
+
+char ssid[] = "Network";          //  your network SSID (name)
+char pass[] = "myPassword";   // your network password
+
+WiFiServer server(23);
+
+void setup() {
+
+  Serial.begin(115200);
+  while (!Serial) {}
+
+  int status = WiFi.begin(ssid, pass);
+  if ( status != WL_CONNECTED) {
+    Serial.println("Couldn't get a WiFi connection");
+    while(true);
+  }
+
+  server.begin();
+  if (!server) {
+    Serial.println("Server failed to start.");
+    while(true);
+  }
+}
+
+void loop() {
+  WiFiClient client = server.available();
+  if (client) {
+    String s = client.readStringUntil('\n');
+    server.println(s);
+  }
+}
+```
+
 ### `server.status()`
 
 #### Description

src/WiFiServer.cpp

@@ -88,6 +88,9 @@ uint8_t WiFiServer::status() {
     }
 }
 
+WiFiServer::operator bool() {
+  return (_sock != NO_SOCKET_AVAIL);
+}
 
 size_t WiFiServer::write(uint8_t b)
 {

src/WiFiServer.h

@@ -42,6 +42,7 @@ class WiFiServer : public Server {
   virtual size_t write(uint8_t);
   virtual size_t write(const uint8_t *buf, size_t size);
   uint8_t status();
+  explicit operator bool();
 
   using Print::write;
 };