Make skipResponseHeaders() optional, if contentLength() is called first

HttpClient.cpp

@@ -384,6 +384,17 @@ int HttpClient::skipResponseHeaders()
     }
 }
 
+int HttpClient::contentLength()
+{
+    // skip the response headers, if they haven't been read already 
+    if (!endOfHeadersReached())
+    {
+        skipResponseHeaders();
+    }
+
+    return iContentLength;
+}
+
 bool HttpClient::endOfBodyReached()
 {
     if (endOfHeadersReached() && (contentLength() != kNoContentLengthHeader))

HttpClient.h

@@ -159,6 +159,7 @@ public:
     /** Check if a header is available to be read.
       Use readHeaderName() to read header name, and readHeaderValue() to
       read the header value
+      MUST be called after responseStatusCode() and before contentLength()
     */
     bool headerAvailable();
 
@@ -177,6 +178,7 @@ public:
       through the headers.  Check whether or not the end of the headers has
       been reached by calling endOfHeadersReached(), although after that point
       this will still return data as read() would, but slightly less efficiently
+      MUST be called after responseStatusCode() and before contentLength()
       @return The next character of the response headers
     */
     int readHeader();
@@ -186,6 +188,7 @@ public:
       returned in the response.  You can also use it after you've found all of
       the headers you're interested in, and just want to get on with processing
       the body.
+      MUST be called after responseStatusCode()
       @return HTTP_SUCCESS if successful, else an error code
     */
     int skipResponseHeaders();
@@ -204,10 +207,12 @@ public:
     virtual bool completed() { return endOfBodyReached(); };
 
     /** Return the length of the body.
+      Also skips response headers if they have not been read already
+      MUST be called after responseStatusCode()
       @return Length of the body, in bytes, or kNoContentLengthHeader if no
       Content-Length header was returned by the server
     */
-    int contentLength() { return iContentLength; };
+    int contentLength();
 
     // Inherited from Print
     // Note: 1st call to these indicates the user is sending the body, so if need

examples/SimpleHttpExample/SimpleHttpExample.ino

@@ -68,45 +68,44 @@ void loop()
       // similar "success" code (200-299) before carrying on,
       // but we'll print out whatever response we get
 
-      err = http.skipResponseHeaders();
+      // If you are interesting in the response headers, you
-      if (err >= 0)
+      // can read them here:
-      {
+      //while(http.headerAvailable())
-        int bodyLen = http.contentLength();
+      //{
-        Serial.print("Content length is: ");
+      //  String headerName = http.readHeaderName();
-        Serial.println(bodyLen);
+      //  String headerValue = http.readHeaderValue();
-        Serial.println();
+      //}
-        Serial.println("Body returned follows:");
 
-        // Now we've got to the body, so we can print it out
+      int bodyLen = http.contentLength();
-        unsigned long timeoutStart = millis();
+      Serial.print("Content length is: ");
-        char c;
+      Serial.println(bodyLen);
-        // Whilst we haven't timed out & haven't reached the end of the body
+      Serial.println();
-        while ( (http.connected() || http.available()) &&
+      Serial.println("Body returned follows:");
-               (bodyLen > 0 || bodyLen != HttpClient::kNoContentLengthHeader) &&
-               ((millis() - timeoutStart) < kNetworkTimeout) )
-        {
-            if (http.available())
-            {
-                c = http.read();
-                // Print out this character
-                Serial.print(c);
     
-                bodyLen--;
+      // Now we've got to the body, so we can print it out
-                // We read something, reset the timeout counter
+      unsigned long timeoutStart = millis();
-                timeoutStart = millis();
+      char c;
-            }
+      // Whilst we haven't timed out & haven't reached the end of the body
-            else
+      while ( (http.connected() || http.available()) &&
-            {
+             (bodyLen > 0 || bodyLen != HttpClient::kNoContentLengthHeader) &&
-                // We haven't got any data, so let's pause to allow some to
+             ((millis() - timeoutStart) < kNetworkTimeout) )
-                // arrive
-                delay(kNetworkDelay);
-            }
-        }
-      }
-      else
       {
-        Serial.print("Failed to skip response headers: ");
+          if (http.available())
-        Serial.println(err);
+          {
+              c = http.read();
+              // Print out this character
+              Serial.print(c);
+             
+              bodyLen--;
+              // We read something, reset the timeout counter
+              timeoutStart = millis();
+          }
+          else
+          {
+              // We haven't got any data, so let's pause to allow some to
+              // arrive
+              delay(kNetworkDelay);
+          }
       }
     }
     else