GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
XML::FOAF(3) User Contributed Perl Documentation XML::FOAF(3)

XML::FOAF - Parse FOAF (Friend of a Friend) data

    use XML::FOAF;
    use URI;
    my $foaf = XML::FOAF->new(URI->new('http://foo.com/my.foaf'));
    print $foaf->person->mbox, "\n";

XML::FOAF provides an object-oriented interface to FOAF (Friend of a Friend) data.

Reads in FOAF data from $data and parses it. Returns a XML::FOAF object on success, "undef" on error. If an error occurs, you can call

    XML::FOAF->errstr

to get the text of the error.

$base_uri is the base URI to be used in constructing absolute URLs from resources defined in your FOAF data, and is required unless $data is a URI object, in which case the $base_uri can be obtained from that URI.

$data can be any of the following:

  • A URI object

    An object blessed into any URI subclass. For example:

        my $uri = URI->new('http://foo.com/my.foaf');
        my $foaf = XML::FOAF->new($uri);
        

    The URI can be either for a FOAF file (for example, the above), or an HTML page containing a "<link>" tag for FOAF auto-discovery:

        <link rel="meta" type="application/rdf+xml" title="FOAF" href="http://foo.com/my.foaf" />
        

    If the URI points to an HTML page with FOAF auto-discovery enabled, XML::FOAF will parse the HTML to find the FOAF file automatically.

  • A scalar reference

    This indicates a reference to a string containing the FOAF data. For example:

        my $foaf_data = <<FOAF;
        ...
        FOAF
        my $foaf = XML::FOAF->new(\$foaf_data, 'http://foo.com');
        
  • A filehandle

    An open filehandle from which the FOAF data can be read. For example:

        open my $fh, 'my.foaf' or die $!;
        my $foaf = XML::FOAF->new($fh, 'http://foo.com');
        
  • A file name

    A simple scalar containing the name of a file containing the FOAF data. For example:

        my $foaf = XML::FOAF->new('my.foaf', 'http://foo.com');
        

Returns a XML::FOAF::Person object representing the main identity in the FOAF file.

If the FOAF file indicates a PGP signature in wot:assurance, the URL for the detatched signature file will be returned, "undef" otherwise.

Attempts to verify the FOAF file using the PGP signature returned from assurance. verify will fetch the public key associated with the signature from a keyserver. If no PGP signature is noted in the FOAF file, or if an error occurs, "undef" is returned. If the signature is invalid, 0 is returned. If the signature is valid, the PGP identity (name and email address, generally) of the signer is returned.

Requires Crypt::OpenPGP to be installed.

http://xmlns.com/foaf/0.1/

http://rdfweb.org/foaf/

XML::FOAF is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

Except where otherwise noted, XML::FOAF is Copyright 2003 Benjamin Trott, cpan@stupidfool.org. All rights reserved.
2011-06-17 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.