NAME

Netscape::HistoryURL - subclass of URI::URL which provides visit time

SYNOPSIS

use Netscape::HistoryURL;

$url = new Netscape::HistoryURL('http://foobar.com/', $time);

DESCRIPTION

The Netscape::HistoryURL module subclasses URI::URL to provide a URL class with a method for accessing visit time.

CONSTRUCTOR

$object = new Netscape::HistoryURL( URL, TIME );

This creates a new instance of the Netscape::HistoryURL object class. This supports all the methods supported by the URI::URL class. Please see the documentation for that module.

The first argument passed is a string which contains a valid URL. The second argument is the time of visit, in seconds since the last epoch.

METHODS

The Netscape::HistoryURL class implements the following methods:

• visit_time returns the time you last visited the URL.

• URI::URL methods

  All the methods of the URI::URL class are supported. See the documentation for that module.

The methods specific to this class are further described below.

visit_time - return the time of last visit

$time = $url->visit_time();

This method returns the time you last visited the URL, in seconds since the last epoch. This can then be used with any of the standard routines for formatting as a string. The following example uses ctime(), from the Date::Format module:

print "Time of last visit for $url : ", ctime($url->visit_time);

SEE ALSO

Netscape::History

An object class for accessing the Netscape history database.

URI::URL

Base-class, which provides heaps of functionality.

AUTHOR

Neil Bowers <neilb@cre.canon.co.uk>

COPYRIGHT

Copyright (c) 1997 Canon Research Centre Europe. All rights reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.