51Degrees Device Detection C/C++  4.4

Getting started example of using 51Degrees device detection.The example shows how to:

1. Specify the name of the data file, properties the data set should be initialised with, and the configuration.
   using namespace FiftyoneDegrees;

   string fileName = "51Degrees-V4.1.hash";

   string propertiesString = "ScreenPixelsWidth,HardwareModel,IsMobile,BrowserName";

   Common::RequiredPropertiesConfig *properties =

   new Common::RequiredPropertiesConfig(&propertiesString);

   DeviceDetection::Hash DeviceDetection::Hash::ConfigHash *config =

   new DeviceDetection::Hash::DeviceDetection::Hash::ConfigHash();
2. Construct a new engine from the specified data file with the required properties and the specified configuration.
   using namespace FiftyoneDegrees;

   DeviceDetection::Hash::EngineHash *engine =

   new DeviceDetection::Hash::EngineHash(

   dataFilePath,

   config,

   properties);
3. Create a evidence instance and add a single HTTP User-Agent string to be processed.
   using namespace FiftyoneDegrees;

   DeviceDetection::EvidenceDeviceDetection *evidence =

   new DeviceDetection::EvidenceDeviceDetection();

   evidence->operator[]("header.user-agent") = userAgent;
4. Process the evidence using the engine to retrieve the values associated with the User-Agent for the selected properties.
   using namespace FiftyoneDegrees;

   DeviceDetection::Hash::DeviceDetection::Hash::ResultsHash *results = engine->process(evidence);
5. Obtain drift: The maximum drift for a matched substring from the character position where it was expected to be found. The maximum drift to allow when finding a match can be set through the configuration structure.
   int drift = results->getDrift();
6. Obtain difference: The total difference in hash code values between the matched substrings and the actual substrings. The maximum difference to allow when finding a match can be set through the configuration structure.
   int difference = results->getDifference();
7. Obtain iteration count: The number of iterations required to get the device offset in the devices collection in the graph of nodes. This is indicative of the time taken to fetch the result.
   int iterations = results->getIterations();
8. Obtain match method: provides information about the algorithm that was used to perform detection for a particular User-Agent. For more information on what each method means please see: How device detection works.
   fiftyoneDegreesHashMatchMethod method = results->getMethod();
9. Obtain the matched User-Agent: the matched substrings in the User-Agent separated with underscored.
   string matchedUserAgent = results->getUserAgent(0);
10. Release the memory used by the results and the evidence.
    delete results;

    delete evidence;
11. Finally release the memory used by the engine.
    delete engine;