Astro::ADS::Result - Results from an ADS Query
$result = new Astro::ADS::Result( Papers => \@papers );
Stores the results returned from an ADS search as an array of Astro::ADS::Result::Paper objects.
$Id: Result.pm,v 1.14 2001/12/03 03:41:45 aa Exp $
Create a new instance from a hash of options
returns a reference to an ADS Result object.
Return the number of papers in the Astro::ADS::Result object.
$paper = $result->sizeof();
Push a new paper onto the end of the Astro::ADS::Result object
$result->pushpaper( $paper );
returns the number of papers now in the Result object.
Pop a paper from the end of the Astro::ADS::Result object
$paper = $result->poppaper();
the method deletes the paper and returns the deleted paper object.
Return a list of all the Astro::ADS::Result::Paper objects stored in the results object.
Astro::ADS::Result::Paper
@papers = $result->papers;
Return the Astro::ADS::Result::Paper object at index $index
$paper = $result->paperbyindex( $index );
the first paper is at index 0 (not 1). Returns undef if no arguements are provided.
Configures the object, takes an options hash as argument
$result->configure( %options );
Takes a hash as argument with the following keywords:
An reference to an array of Astro::ADS::Result::Paper objects.
Does nothing if these keys are not supplied.
Return a summary of the object as either plain text table or in XML. Simply invokes the summary method of each paper in turn and combines the results as a single string.
summary
The arguments are passed through to the summary method unchanged.
Method called automatically when the object is printed in a string context. Simple invokes the summary() method with default arguments.
summary()
Copyright (C) 2001 University of Exeter. All Rights Reserved.
This program was written as part of the eSTAR project and is free software; you can redistribute it and/or modify it under the terms of the GNU Public License.
Alasdair Allan <aa@astro.ex.ac.uk>,
To install Astro::ADS, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Astro::ADS
CPAN shell
perl -MCPAN -e shell install Astro::ADS
For more information on module installation, please visit the detailed CPAN module installation guide.