NAME

RDF::Query::Functions::Buzzword::GB - plugin for buzzword.org.uk British locale-specific functions

SYNOPSIS

  use RDF::Query;
  use RDF::TrineX::Functions -shortcuts;

  my $data = rdf_parse(<<'TURTLE', type=>'turtle', base=>$baseuri);
  @prefix foaf: <http://xmlns.com/foaf/0.1/> .
  @prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .

  <http://tobyinkster.co.uk/#i>
    foaf:name "Toby Inkster" ;
    foaf:phone "01234567890x1234";
    foaf:postcode "bn71rs" .
  TURTLE

  my $query = RDF::Query->new(<<'SPARQL');
  PREFIX foaf: <http://xmlns.com/foaf/0.1/>
  PREFIX sparql: <sparql:>
  PREFIX gb: <http://buzzword.org.uk/2011/functions/gb#>
  PREFIX util: <http://buzzword.org.uk/2011/functions/util#>
  SELECT
    ?name
    ?phone
    ?postcode
    (gb:postcode_format(?postcode) AS ?pcfmt)
    (gb:telephone_std(?phone) AS ?phonestd)
    (gb:telephone_local(?phone) AS ?phonelocal)
    (gb:telephone_extension(?phone) AS ?phoneext)
    (gb:telephone_uri(?phone) AS ?phoneuri)
  WHERE
  {
    ?person foaf:name ?name ; foaf:phone ?phone ; foaf:postcode ?postcode .
  }
  SPARQL

  print $query->execute($data)->as_xml;

DESCRIPTION

This is a plugin for RDF::Query providing a number of extension functions.

• http://buzzword.org.uk/2011/functions/gb#postcode_valid

  Given a literal, returns a boolean indicating whether it seems to be a syntactically valid UK postcode.

• http://buzzword.org.uk/2011/functions/gb#postcode_format

  Given a literal, if it seems to be a valid UK postcode, canonicalises the formatting; otherwise returns the literal unscathed.

• http://buzzword.org.uk/2011/functions/gb#telephone_valid

  Given a literal, returns a boolean indicating whether it seems to be a number that could be dialed from a UK phone.

  Only the digits '0' to '9', letter 'x' (extension) and '+' (international dialing code) are expected. Other characters are stripped out before any checks.

• http://buzzword.org.uk/2011/functions/gb#telephone_format

  Canonicalises the formatting of a phone number that is valid. Should return invalid phone numbers unscathed.

• http://buzzword.org.uk/2011/functions/gb#telephone_std

  Returns the STD code for a phone number, if it could be extracted; the empty string otherwise.

• http://buzzword.org.uk/2011/functions/gb#telephone_local

  Returns the local part of a phone number, if it could be extracted; the empty string otherwise.

• http://buzzword.org.uk/2011/functions/gb#telephone_extension

  Returns the extension from a phone number, if it could be extracted; the empty string otherwise.

• http://buzzword.org.uk/2011/functions/gb#telephone_uri

  Returns a phone number as a <tel:> URI.

  An existing <tel:> URI should pass through unscathed.

SEE ALSO

RDF::Query.

http://www.perlrdf.org/.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

Copyright 2004-2012 Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.