Sample code for 30+ languages & platforms
Unicode C

S3 Get Bucket Objects with CommonPrefixes

See more Amazon S3 Examples

Demonstrates how to get a list of bucket objects using the prefix and delimiter query params to get an XML result with CommonPrefixes.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkXmlW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    const wchar_t *strXml;
    HCkXmlW xml;
    const wchar_t *Prefix;
    int i;
    int count_i;

    success = FALSE;

    // This example assumes the Chilkat HTTP API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    http = CkHttpW_Create();

    // Insert your access key here:
    CkHttpW_putAwsAccessKey(http,L"AWS_ACCESS_KEY");

    // Insert your secret key here:
    CkHttpW_putAwsSecretKey(http,L"AWS_SECRET_KEY");

    // In this example, my bucket is "chilkat100".
    // It contains a number of folders, one of which is named "images".
    // I want to get a list of all sub-folders under the "images" folder
    strXml = CkHttpW_s3_ListBucketObjects(http,L"chilkat100?prefix=images/&delimiter=/");
    if (CkHttpW_getLastMethodSuccess(http) != TRUE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        return;
    }

    wprintf(L"Response status code = %d\n",CkHttpW_getLastStatus(http));

    xml = CkXmlW_Create();
    success = CkXmlW_LoadXml(xml,strXml);
    if (success != TRUE) {
        wprintf(L"%s\n",CkXmlW_lastErrorText(xml));
        CkHttpW_Dispose(http);
        CkXmlW_Dispose(xml);
        return;
    }

    // If the response status code was not 200, then the XML response is not a 
    // listing of objects, but instead contains error information.
    if (CkHttpW_getLastStatus(http) != 200) {
        wprintf(L"%s\n",CkXmlW_getXml(xml));
        wprintf(L"Failed.\n");
        CkHttpW_Dispose(http);
        CkXmlW_Dispose(xml);
        return;
    }

    // A sample response is shown below.
    wprintf(L"%s\n",CkXmlW_getXml(xml));
    wprintf(L"----\n");

    // Here is the list of sub-folders (i.e. CommonPrefixes)

    // <?xml version="1.0" encoding="UTF-8"?>
    // <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    //     <Name>chilkat100</Name>
    //     <Prefix>images/</Prefix>
    //     <Marker/>
    //     <MaxKeys>1000</MaxKeys>
    //     <Delimiter>/</Delimiter>
    //     <IsTruncated>false</IsTruncated>
    //     <CommonPrefixes>
    //         <Prefix>images/africa/</Prefix>
    //     </CommonPrefixes>
    //     <CommonPrefixes>
    //         <Prefix>images/sea_creatures/</Prefix>
    //     </CommonPrefixes>
    // </ListBucketResult>

    // The XML can be parsed like this:
    i = 0;
    count_i = CkXmlW_NumChildrenHavingTag(xml,L"CommonPrefixes");
    while (i < count_i) {
        CkXmlW_putI(xml,i);
        Prefix = CkXmlW_getChildContent(xml,L"CommonPrefixes[i]|Prefix");
        wprintf(L"Prefix = %s\n",Prefix);
        i = i + 1;
    }



    CkHttpW_Dispose(http);
    CkXmlW_Dispose(xml);

    }