NAME

Mobile::Libwurfl - Perl bindings to the commercial wurfl library (from ScientiaMobile)

SYNOPSIS

use Wurfl;

$wurfl = Wurfl->new();

###
# optionally you can set the engine mode or the cache_provider
# (refer to libwurfl documentation for more details)

$err = $wurfl->set_engine(WURFL_ENGINE_TARGET_HIGH_PERFORMANCE);
if ($err != WURFL_OK) {
  die $wurfl->error_message;
}

$err = $wurfl->set_cache_provider(WURFL_CACHE_PROVIDER_DOUBLE_LRU, "10000,3000");
if ($err != WURFL_OK) {
  die $wurfl->error_message;
}
####


$wurfl->load("/usr/share/wurfl/wurfl.xml");

# you can also provide the database file directly to the constructor
# (default engine mode and cache provider will be used)
$wurfl = Wurfl->new("/usr/share/wurfl/wurfl.xml");

$device = $wurfl->lookup_useragent(USERAGENT);

# get an hashref with all known capabilities
$capabilities = $device->capabilities;

# or access a specific capability directly
$viewport_width = $device->get_capability('viewport_width');

All functions from libwurfl have been mapped, refer to the
Mobile::Libwurfl::Device documentation for a list of methods

DESCRIPTION

Perl bindings to the commercial C library to access wurfl databases

METHODS

• new ($dbfile)

  Creates a new Wurfl object. if $dbfile is provided it will be immediately loaded using the default engine mode and cache provider

• load ($dbfile)

  Load the database file at the path pointed by $dbfile

• lookup_useragent ($ua_string)

  Returns a Mobile::Libwurfl::Device object representing the best match for the provided useragent string

• get_device ($id)

  Returns a new Mobile::Libwurfl::Device object for the provided device id (if any)

• set_engine ($mode)

  Sets the engine mode. This method can be called only before loading a database file. If called once a database file has been already loaded WURFL_ERROR_ALREADY_LOAD will be returned

  Valid values for the $mode argument are : WURFL_ENGINE_TARGET_HIGH_ACCURACY and WURFL_ENGINE_TARGET_HIGH_ACCURACY

• set_cache_provider ($provider, $config)

  Sets and configure the cache provider. This method can be called only before loading a database file. If called once a database file has been already loaded WURFL_ERROR_ALREADY_LOAD will be returned

  Valid values for the $mode argument are : WURFL_CACHE_PROVIDER_NONE, WURFL_CACHE_PROVIDER_LRU and WURFL_CACHE_PROVIDER_DOUBLE_LRU

  Check libwurfl documnetation for further details on their meaning and what expected in the $config param.

• error_message ()

• has_error_message ()

• clear_error_message ()

• add_patch ($patch_file)

EXPORT

WURFL_CACHE_PROVIDER_DOUBLE_LRU
WURFL_CACHE_PROVIDER_LRU
WURFL_CACHE_PROVIDER_NONE
WURFL_ENGINE_TARGET_HIGH_ACCURACY
WURFL_ENGINE_TARGET_HIGH_PERFORMANCE
WURFL_ERROR_ALREADY_LOAD
WURFL_ERROR_CANT_LOAD_CAPABILITY_NOT_FOUND
WURFL_ERROR_CANT_LOAD_VIRTUAL_CAPABILITY_NOT_FOUND
WURFL_ERROR_CAPABILITY_GROUP_MISMATCH
WURFL_ERROR_CAPABILITY_GROUP_NOT_FOUND
WURFL_ERROR_CAPABILITY_NOT_FOUND
WURFL_ERROR_DEVICE_ALREADY_DEFINED
WURFL_ERROR_DEVICE_HIERARCHY_CIRCULAR_REFERENCE
WURFL_ERROR_DEVICE_NOT_FOUND
WURFL_ERROR_EMPTY_ID
WURFL_ERROR_FILE_NOT_FOUND
WURFL_ERROR_INPUT_OUTPUT_FAILURE
WURFL_ERROR_INVALID_CAPABILITY_VALUE
WURFL_ERROR_INVALID_HANDLE
WURFL_ERROR_INVALID_PARAMETER
WURFL_ERROR_UNEXPECTED_END_OF_FILE
WURFL_ERROR_UNKNOWN
WURFL_ERROR_USERAGENT_ALREADY_DEFINED
WURFL_ERROR_VIRTUAL_CAPABILITY_NOT_FOUND
WURFL_MATCH_TYPE_CACHED
WURFL_MATCH_TYPE_CATCHALL
WURFL_MATCH_TYPE_CONCLUSIVE
WURFL_MATCH_TYPE_EXACT
WURFL_MATCH_TYPE_HIGHPERFORMANCE
WURFL_MATCH_TYPE_NONE
WURFL_MATCH_TYPE_RECOVERY
WURFL_OK

SEE ALSO

Mobile::Libwurfl::Device

AUTHOR

Andrea Guzzo, <xant@xant.net>

COPYRIGHT AND LICENSE

Copyright (C) 2013 by Andrea Guzzo

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.