NAME

Netscape::Bookmarks::Alias - object for an Alias in a Netscape Bookmarks file

SYNOPSIS

        use Netscape::Bookmarks;
        use Netscape::Bookmarks::Alias;

        my $bookmarks = Netscape::Bookmarks->new();

        my $alias = Netscape::Bookmarks::Alias->new();

        $bookmarks->add( $alias );
        # ... and other Netscape::Bookmark::Category methods

DESCRIPTION

THIS IS AN ABANDONED MODULE. THERE IS NO SUPPORT. YOU CAN ADOPT IT IF YOU LIKE: https://pause.perl.org/pause/query?ACTION=pause_04about#takeover

This module provides an abstraction for an Alias object in a Netscape Bookmarks file. An alias is simply a reference to another link in the Bookmarks file, henceforth called the target. If you change the alias, the target link also changes.

$obj = Netscape::Bookmarks::Alias->new( ALIASID )

Creates a new Netscape::Bookmarks::Alias object with the ALIASOF attribute value of ALIASID. This object relies on a corresponding Netscape::Bookmarks::Link object with the same ALIASID, although new does not check to see if that object exists (although it probably should).

$obj->alias_of()

Returns the alias key for this Netscape::Bookmarks::Alias object.

$obj->target( ALIAS_KEY )

Returns the target Link of the given alias key. The return value is a Netscape::Bookmarks::Link object if the target exists, or undef in scalar context or the empty list in list context if the target does not exist. If you want to simply check to see if a target exists, use target_exists.

add_target( $link_obj, ALIAS_KEY )

Adds a target link for the given ALIAS_KEY. You can add target links before the Alias is created.

target_exists( TARGET_KEY )

For the given target key returns TRUE or FALSE if the target exists.

$obj->as_string()

Returns a string representation on the alias. This is almost identical from the representation of the link which is aliases except that the ALIASID attribute is changed to the ALIASOF attribute.

$obj->title()

Returns the tile of the Alias.

$obj->remove()

Performs any clean up necessary to remove this object from the Bookmarks tree. Although this method does not affect the Link object which is its target, it probably should.

AUTHOR

brian d foy <bdfoy@cpan.org>

COPYRIGHT AND LICENSE

Copyright © 2002-2019, brian d foy <bdfoy@cpan.org>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.

SEE ALSO

Netscape::Bookmarks, Netscape::Bookmarks::Link