Strongly Typed example of using 51Degrees device detection.The example shows how to:

Specify the name of the data file and properties the data set should be initialised with.
const char* fileName = argv[1];
fiftyoneDegreesPropertiesRequired properties =
fiftyoneDegreesPropertiesDefault;
properties.string = "IsMobile";
Instantiate the 51Degrees data set within a resource manager from the specified data file with the required properties and the specified configuration.
fiftyoneDegreesStatusCode status =
fiftyoneDegreesHashInitManagerFromFile(
&manager,
&config,
&properties,
dataFilePath,
exception);
Create a results instance ready to be populated by the data set.
fiftyoneDegreesResultsHash *results =
fiftyoneDegreesResultsHashCreate(
&manager,
1,
0);
Process a single HTTP User-Agent string to retrieve the values associated with the User-Agent for the selected properties.
fiftyoneDegreesResultsHashFromUserAgent(
results,
mobileUserAgent,
strlen(mobileUserAgent),
exception);
Check the type of values the property returns.
fiftyoneDegreesProperty *property = fiftyoneDegreesPropertyGetByName(
dataSet->properties,
dataSet->strings,
propertyName,
&item,
exception);
fiftyoneDegreesPropertyValueType type = property->valueType;

Extract the value of a property as a boolean from the results.
requiredPropertyIndex =
fiftyoneDegreesPropertiesGetRequiredPropertyIndexFromName(
dataSet->available,
propertyName);
if (requiredPropertyIndex >= 0) {
valueName = FIFTYONE_DEGREES_STRING(
fiftyoneDegreesResultsHashGetValues(
results,
requiredPropertyIndex,
exception));
bool value = strcmp(valueName, "True") == 0;
Release the memory used by the results.
fiftyoneDegreesResultsHashFree(results);
Finally release the memory used by the data set resource.
fiftyoneDegreesResourceManagerFree(&manager);

This example differs from the Getting Started example by using boolean values for the isMobile property instead of string values.

/* *********************************************************************

* This Original Work is copyright of 51 Degrees Mobile Experts Limited.

* Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.

*

* This Original Work is licensed under the European Union Public Licence

* (EUPL) v.1.2 and is subject to its terms as set out below.

*

* If a copy of the EUPL was not distributed with this file, You can obtain

* one at https://opensource.org/licenses/EUPL-1.2.

*

* The 'Compatible Licences' set out in the Appendix to the EUPL (as may be

* amended by the European Commission) shall be deemed incompatible for

* the purposes of the Work and the provisions of the compatibility

* clause in Article 5 of the EUPL shall not apply.

*

* If using the Work as, or as part of, a network application, by

* including the attribution notice(s) required under Article 5 of the EUPL

* in the end user terms of the application under an appropriate heading,

* such notice(s) shall fulfill the requirements of that article.

* ********************************************************************* */

#include <stdio.h>

// Include ExmapleBase.h before others as it includes Windows 'crtdbg.h'

// which requires to be included before 'malloc.h'.

#include "ExampleBase.h"

#include "../../../src/hash/hash.h"

#include "../../../src/hash/fiftyone.h"

static const char *dataDir = "device-detection-data";

static const char *dataFileName = "51Degrees-LiteV4.1.hash";

static bool getPropertyIsBool(

ResultsHash *results,

const char *propertyName) {

EXCEPTION_CREATE;

Item item;

DataReset(&item.data);

DataSetHash *dataSet = (DataSetHash*)results->b.b.dataSet;

Property *property = PropertyGetByName(

dataSet->properties,

dataSet->strings,

propertyName,

&item,

exception);

EXCEPTION_THROW;

bool isBool = property->valueType == FIFTYONE_DEGREES_PROPERTY_VALUE_TYPE_BOOLEAN;

COLLECTION_RELEASE(item.collection, &item);

return isBool;

}

static bool getPropertyValueAsBool(

ResultsHash *results,

const char *propertyName) {

EXCEPTION_CREATE;

bool value = false;

int requiredPropertyIndex;

const char *valueName;

DataSetBase *dataSet = (DataSetBase*)results->b.b.dataSet;

if (getPropertyIsBool(results, propertyName) == true) {

requiredPropertyIndex =

PropertiesGetRequiredPropertyIndexFromName(

dataSet->available,

propertyName);

if (requiredPropertyIndex >= 0) {

if (ResultsHashGetValues(

results,

requiredPropertyIndex,

exception) != NULL && EXCEPTION_OKAY) {

valueName = STRING(results->values.items[0].data.ptr);

if (strcmp(valueName, "True") == 0) {

value = true;

}

return value;

}

static void printBoolValues(ResultsHash *results) {

uint32_t i;

const char *propertyName;

DataSetBase *dataSet = (DataSetBase*)results->b.b.dataSet;

for (i = 0; i < dataSet->available->count; i++) {

propertyName = STRING(

dataSet->available->items[i].name.data.ptr);

printf(" %s: %d\n",

propertyName,

getPropertyValueAsBool(results, propertyName));

}

static void reportStatus(StatusCode status,

const char* fileName) {

const char *message = StatusGetMessage(status, fileName);

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

Free((void*)message);

}

void fiftyoneDegreesHashStronglyTyped(

const char *dataFilePath,

ConfigHash *config) {

EXCEPTION_CREATE;

ResourceManager manager;

// Set the properties to be returned for each User-Agent.

PropertiesRequired properties = PropertiesDefault;

properties.string = "ScreenPixelsWidth,HardwareModel,IsMobile,BrowserName";

// Initialise the manager for device detection.

StatusCode status = HashInitManagerFromFile(

&manager,

config,

&properties,

dataFilePath,

exception);

if (status != SUCCESS) {

reportStatus(status, dataFilePath);

fgetc(stdin);

return;

}

// Create a results instance to store and process User-Agents.

ResultsHash *results = ResultsHashCreate(&manager, 1, 0);

// User-Agent string of an iPhone mobile device.

const char* mobileUserAgent = (

"Mozilla/5.0 (iPhone; CPU iPhone OS 7_1 like Mac OS X) "

"AppleWebKit/537.51.2 (KHTML, like Gecko) Version/7.0 Mobile/11D167 "

"Safari/9537.53");

// User-Agent string of Firefox Web browser version 41 on desktop.

const char* desktopUserAgent = (

"Mozilla/5.0 (Windows NT 6.3; WOW64; rv:41.0) "

"Gecko/20100101 Firefox/41.0");

// User-Agent string of a MediaHub device.

const char* mediaHubUserAgent = (

"Mozilla/5.0 (Linux; Android 4.4.2; X7 Quad Core "

"Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 "

"Chrome/30.0.0.0 Safari/537.36");

printf("Starting Getting Started Example.\n");

// Carries out a match for a mobile User-Agent.

printf("\nMobile User-Agent: %s\n", mobileUserAgent);

ResultsHashFromUserAgent(

results,

mobileUserAgent,

strlen(mobileUserAgent),

exception);

EXCEPTION_THROW;

printBoolValues(results);

// Carries out a match for a desktop User-Agent.

printf("\nDesktop User-Agent: %s\n", desktopUserAgent);

ResultsHashFromUserAgent(

results,

desktopUserAgent,

strlen(desktopUserAgent),

exception);

EXCEPTION_THROW;

printBoolValues(results);

// Carries out a match for a MediaHub User-Agent.

printf("\nMedia hub User-Agent: %s\n", mediaHubUserAgent);

ResultsHashFromUserAgent(

results,

mediaHubUserAgent,

strlen(mediaHubUserAgent),

exception);

EXCEPTION_THROW;

printBoolValues(results);

// Ensure the results are freed to avoid memory leaks.

ResultsHashFree(results);

// Free the resources used by the manager.

ResourceManagerFree(&manager);

}

void fiftyoneDegreesExampleCStronglyTypedRun(ExampleParameters *params) {

// Call the actual function.

fiftyoneDegreesHashStronglyTyped(

params->dataFilePath,

params->config);

}

#ifndef TEST

int main(int argc, char* argv[]) {

StatusCode status = SUCCESS;

ConfigHash config = HashDefaultConfig;

char dataFilePath[FILE_MAX_PATH];

if (argc > 1) {

strcpy(dataFilePath, argv[1]);

}

else {

status = FileGetPath(

dataDir,

dataFileName,

dataFilePath,

sizeof(dataFilePath));

}

if (status != SUCCESS) {

reportStatus(status, dataFileName);

fgetc(stdin);

return 1;

}

if (CollectionGetIsMemoryOnly()) {

config = HashInMemoryConfig;

}

ExampleParameters params;

params.dataFilePath = dataFilePath;

params.config = &config;

// Run the example

fiftyoneDegreesExampleMemCheck(

&params,

fiftyoneDegreesExampleCStronglyTypedRun);

// Wait for a character to be pressed.

fgetc(stdin);

return 0;

}

#endif

51Degrees Device Detection C/C++ 4.4

Hash/StronglyTyped.c