curl / libcurl / API / curl_easy_getinfo / CURLINFO_CONTENT_TYPE

CURLINFO_CONTENT_TYPE explained

Name

CURLINFO_CONTENT_TYPE - get Content-Type

Synopsis

#include <curl/curl.h>
 
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_TYPE, char **ct);

Description

Pass a pointer to a char pointer to receive the content-type of the downloaded object. This is the value read from the Content-Type: field. If you get NULL, it means that the server did not send a valid Content-Type header or that the protocol used does not support this.

The ct pointer is NULL or points to private memory. You must not free it. It gets freed automatically when you call curl_easy_cleanup on the corresponding curl handle.

The modern way to get this header from a response is to instead use the curl_easy_header function.

Protocols

This functionality affects http only

Example

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
 
    res = curl_easy_perform(curl);
 
    if(!res) {
      /* extract the content-type */
      char *ct = NULL;
      res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
      if(!res && ct) {
        printf("Content-Type: %s\n", ct);
      }
    }
    curl_easy_cleanup(curl);
  }
}

Availability

Added in curl 7.9.4

Return value

curl_easy_getinfo returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors.