NAME

HTTP::Cookies::Find - Locate cookies for the current user on the local machine.

SYNOPSIS

  use HTTP::Cookies::Find;
  my $oCookies = HTTP::Cookies::Find->new('domain.com');
  my @asMsg = HTTP::Cookies::Find::errors;
  # Now $oCookies is a subclass of HTTP::Cookies
  # and @asMsg is an array of error messages

  # Call in array context to find cookies from multiple
  # browsers/versions:
  my @aoCookies = HTTP::Cookies::Find->new('domain.com');
  # Now @aoCookies is an array of HTTP::Cookies objects

DESCRIPTION

Looks in various normal places for HTTP cookie files. Returns an object (or array of objects) of type HTTP::Cookies::[vendor]. The returned object(s) are not tied to the cookie files; the returned object(s) contain read-only copies of the found cookies. If no argument is given to new(), the returned object(s) contain read-only copies of ALL cookies. If an argument is given to new(), the returned object(s) contain read-only copies of only those cookies whose hostname "matches" the argument. Here "matches" means case-insensitive pattern match; you can pass a qr{} regexp as well as a plain string for matching.

METHODS

new

errors

If anything went wrong while finding cookies, errors() will return a list of string(s) describing the error(s).

BUGS

Please notify the author if you find any.

AUTHOR

Martin Thurn <mthurn@cpan.org>

COPYRIGHT

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

SEE ALSO

HTTP::Cookies, HTTP::Cookies::Microsoft, HTTP::Cookies::Mozilla, HTTP::Cookies::Netscape