Zane C. Bowers-Hadley

NAME

Icon::Theme::List - Lists installed icon themes.

VERSION

Version 0.0.0

SYNOPSIS

    use Icon::Theme::List;

    my $iconlist = Icon::Theme::List->new();

FUNCTIONS

new

This initiates it.

One object is accepted and it is a hash reference.

args hash

dir

This dir to use instead of trying to find it automatically.

If this is not specified, the locations below will be checked.

    /usr/local/share/icons/
    /usr/share/icons/

check

This checks if the specified theme is present.

One arguement is required and that is the name of the theme to check to see if it is present.

A return value of true means it is present.

    my $returned=$iconlist->check('hicolor');
    if( $iconlist->{error} ){
        print "Error!\n";
    }else{
        if( $returned ){
            print "It is present.\n";
        }
    }

list

This lists the available icon themes.

The returned value is a array.

    my @themes=$iconlist->list;
    if($iconlist->{error}){
        print "Error!\n";
    }

errorblank

This is a internal that blanks any previous errors.

ERROR CODES

The current error code can be found by checking $iconlist->{error}. If it is true, a error is present. A more verbose description can be found by checking $iconlist->{errorString}.

If $iconlist->{perror} is true, then it means that a permanent error is set.

1

No dir specified and one could not be located.

This means that the locations listed below don't exist.

    /usr/local/share/icons/
    /usr/share/icons/

2

The specified icon directory is actually not a directory.

3

No theme specified.

AUTHOR

Zane C. Bowers, <vvelox at vvelox.net>

BUGS

Please report any bugs or feature requests to bug-icon-theme-list at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Icon-Theme-List. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Icon::Theme::List

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2009 Zane C. Bowers, all rights reserved.

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