Sample code for 30+ languages & platforms
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 C Downloads

C
#include <C_CkHttp.h>
#include <C_CkXml.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttp http;
    const char *strXml;
    HCkXml xml;
    const char *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 = CkHttp_Create();

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

    // Insert your secret key here:
    CkHttp_putAwsSecretKey(http,"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 = CkHttp_s3_ListBucketObjects(http,"chilkat100?prefix=images/&delimiter=/");
    if (CkHttp_getLastMethodSuccess(http) != TRUE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        return;
    }

    printf("Response status code = %d\n",CkHttp_getLastStatus(http));

    xml = CkXml_Create();
    success = CkXml_LoadXml(xml,strXml);
    if (success != TRUE) {
        printf("%s\n",CkXml_lastErrorText(xml));
        CkHttp_Dispose(http);
        CkXml_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 (CkHttp_getLastStatus(http) != 200) {
        printf("%s\n",CkXml_getXml(xml));
        printf("Failed.\n");
        CkHttp_Dispose(http);
        CkXml_Dispose(xml);
        return;
    }

    // A sample response is shown below.
    printf("%s\n",CkXml_getXml(xml));
    printf("----\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 = CkXml_NumChildrenHavingTag(xml,"CommonPrefixes");
    while (i < count_i) {
        CkXml_putI(xml,i);
        Prefix = CkXml_getChildContent(xml,"CommonPrefixes[i]|Prefix");
        printf("Prefix = %s\n",Prefix);
        i = i + 1;
    }



    CkHttp_Dispose(http);
    CkXml_Dispose(xml);

    }