Sample code for 30+ languages & platforms
C

Remove a Query Parameter from a REST Request

See more REST Examples

Demonstrates Rest.RemoveQueryParam, which removes all query parameters whose name matches the supplied value. Name matching is case-sensitive.

Background. Removing individual parameters is useful when reusing a Rest object for requests that share most, but not all, of their query parameters.

Chilkat C Downloads

C
#include <C_CkRest.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRest rest;
    BOOL bTls;
    BOOL bAutoReconnect;
    const char *responseText;

    success = FALSE;

    rest = CkRest_Create();

    //  Connect to the REST server.  The 3rd argument enables TLS (use TRUE for HTTPS on port 443),
    //  and the 4th enables automatic reconnection if the connection is dropped between requests.
    bTls = TRUE;
    bAutoReconnect = TRUE;
    success = CkRest_Connect(rest,"example.com",443,bTls,bAutoReconnect);
    if (success == FALSE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkRest_Dispose(rest);
        return;
    }

    CkRest_AddQueryParam(rest,"q","chilkat");
    CkRest_AddQueryParam(rest,"limit","10");

    //  Remove a query parameter by name.  Name matching is case-sensitive.
    CkRest_RemoveQueryParam(rest,"limit");

    responseText = CkRest_fullRequestNoBody(rest,"GET","/api/search");
    if (CkRest_getLastMethodSuccess(rest) == FALSE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkRest_Dispose(rest);
        return;
    }

    printf("%s\n",responseText);


    CkRest_Dispose(rest);

    }