API:EPrints/List - Revision history

Tdb01r at 09:56, 22 January 2013

2013-01-22T09:56:18Z

Show changes

Tdb01r at 15:26, 16 December 2011

2011-12-16T15:26:03Z

Tdb01r at 10:46, 25 August 2011

2011-08-25T10:46:35Z

Pm705 at 17:25, 31 December 2010

2010-12-31T17:25:18Z

Show changes

Pm705@zepler.net at 16:34, 12 February 2010

2010-02-12T16:34:07Z

Cjg at 14:03, 24 August 2009

2009-08-24T14:03:56Z

Cjg at 13:08, 20 August 2009

2009-08-20T13:08:38Z

Cjg at 16:00, 19 August 2009

2009-08-19T16:00:59Z

Show changes

Cjg at 15:59, 19 August 2009

2009-08-19T15:59:51Z

Tdb01r: Removing all content from page

2009-08-12T15:40:48Z

Removing all content from page

@@ Line 1: / Line 1: @@
 <!-- Pod2Wiki=_preamble_
 This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
-  -->{{API}}{{Pod2Wiki}}{{API:Source|file=EPrints/List.pm|package_name=EPrints::List}}[[Category:API|LIST]][[Category:API:EPrints/List|LIST]]<div><!-- Edit below this comment -->
+  -->{{API}}{{Pod2Wiki}}{{API:Source|file=perl_lib/EPrints/List.pm|package_name=EPrints::List}}[[Category:API|LIST]][[Category:API:EPrints/List|LIST]]<div><!-- Edit below this comment -->

@@ Line 6: / Line 6: @@
 <!-- Pod2Wiki=_private_ --><!-- Pod2Wiki=head_name -->
 ==NAME==
-'''EPrints::List''' - List of data objects, usually a search result.
+'''EPrints::List''' - List of data objects, usually a [[API:EPrints/Search|EPrints::Search]] result.
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
@@ Line 17: / Line 17: @@
 <!-- Pod2Wiki=head_synopsis -->
 ==SYNOPSIS==
    $new_list = $list-&gt;reorder( "-creation_date" ); # makes a new list ordered by reverse order creation_date
@@ Line 72: / Line 74: @@
 ===new===
-  $list = EPrints::List-&gt;new( 			session =&gt; $session,			dataset =&gt; $dataset,			[desc =&gt; $desc],			[desc_order =&gt; $desc_order],			ids =&gt; $ids,			[encoded =&gt; $encoded],			[keep_cache =&gt; $keep_cache],			[order =&gt; $order] );
+  $list = EPrints::List-&gt;new( repository =&gt; $repository, dataset =&gt; $dataset,ids =&gt; $ids, [order =&gt; $order] );
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <span style='display:none'>User Comments</span>
@@ Line 111: / Line 85: @@
 ===new===
-  $list = EPrints::List-&gt;new( 			session =&gt; $session,			dataset =&gt; $dataset,			[desc =&gt; $desc],			[desc_order =&gt; $desc_order],			cache_id =&gt; $cache_id );
+  $list = EPrints::List-&gt;new( repository =&gt; $repository, dataset =&gt; $dataset,[desc =&gt; $desc],[desc_order =&gt; $desc_order],cache_id =&gt; $cache_id );
-Note the new() method will be called very rarely since lists will usually created by an EPrints::Search.
+Note the new() method will be called very rarely since lists will usually created by an [[API:EPrints/Search|EPrints::Search]].
 Creates a new list object in memory only. Lists will be cached if any method requiring order is called, or an explicit  cache() method is called.
@@ Line 369: / Line 343: @@
 Return a DOM XHTML description of this list, if available, or an empty fragment.
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <span style='display:none'>User Comments</span>

@@ Line 19: / Line 19: @@
    use EPrints::List;
-   $list = EPrints::List-&gt;new( handle =&gt; $handle, dataset =&gt; $dataset, ids =&gt; $ids); # ref to an array of ids to populate the list with
+   $list = EPrints::List-&gt;new( session =&gt; $session, dataset =&gt; $dataset, ids =&gt; $ids); # ref to an array of ids to populate the list with
    $new_list = $list-&gt;reorder( "-creation_date" ); # makes a new list ordered by reverse order creation_date
@@ Line 29: / Line 29: @@
    $n = $list-&gt;count() # returns the number of items in the list
-   @dataobjs = $list-&gt;get_records( 0, 20 );  #get the first 20 DataObjs from the list in an array
+   @dataobjs = $list-&gt;slice( 0, 20 );  #get the first 20 DataObjs from the list in an array
    $list-&gt;map( $function, $info ) # performs a function on every item in the list. This is very useful go and look at the detailed description.
@@ Line 59: / Line 59: @@
 <!-- Pod2Wiki=item_new --></div>
-===$list = EPrints::List-&gt;new( 			handle =&gt; $handle,			dataset =&gt; $dataset,			ids =&gt; $ids, # a ref to the array of ids			[order =&gt; $order] ); # the field on which to order the list===
+===$list = EPrints::List-&gt;new( 			session =&gt; $session,			dataset =&gt; $dataset,			[desc =&gt; $desc],			[desc_order =&gt; $desc_order],			ids =&gt; $ids,			[encoded =&gt; $encoded],			[keep_cache =&gt; $keep_cache],			[order =&gt; $order] );===
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
@@ Line 67: / Line 67: @@
 <!-- Pod2Wiki=item_new --></div>
-===$list = EPrints::List-&gt;new( 			handle =&gt; $handle,			dataset =&gt; $dataset,			[desc =&gt; $desc],			[desc_order =&gt; $desc_order],			cache_id =&gt; $cache_id );===
+===$list = EPrints::List-&gt;new( 			session =&gt; $session,			dataset =&gt; $dataset,			[desc =&gt; $desc],			[desc_order =&gt; $desc_order],			cache_id =&gt; $cache_id );===
 Creates a new list object in memory only. Lists will be cached if any method requiring order is called, or an explicit  cache() method is called.
@@ Line 73: / Line 95: @@
 encoded is the serialised version of the searchExpression which created this list, if there was one.
-If keep_cache is set then the cache will not be disposed of at the end of the current $handle. If cache_id is set then keep_cache is automatically true.
+If keep_cache is set then the cache will not be disposed of at the end of the current $session. If cache_id is set then keep_cache is automatically true.
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
@@ Line 130: / Line 152: @@
 $order -  the field the resulting list will be ordered on
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
@@ Line 146: / Line 198: @@
-<!-- Pod2Wiki=item_get_records --></div>
+<!-- Pod2Wiki=item_item --></div>
-===@dataobjs = $list-&gt;get_records( [$offset], [$count] )===
+===$dataobj = $list-&gt;item( $offset )===
 Returns the DataObjs in this list as an array.  $offset - what index through the list to start from. $count - the maximum to return.
@@ Line 156: / Line 220: @@
-<!-- Pod2Wiki=item_get_ids --></div>
+<!-- Pod2Wiki=item_ids --></div>
-===$ids = $list-&gt;get_ids( [$offset], [$count] )===
+===$ids = $list-&gt;ids( [$offset], [$count] )===
 Return a reference to an array containing the ids of the specified range from the list. This is more efficient if you just need the ids.
@@ Line 184: / Line 248: @@
   sub deal
+  {
-    my( $handle, $dataset, $eprint, $info ) = @_; # params passed to the function by $list-&gt;map
+    my( $session, $dataset, $eprint, $info ) = @_;
     if( $eprint-&gt;get_value( "a" ) eq $eprint-&gt;get_value( "b" ) ) {
@@ Line 203: / Line 267: @@
 $plugin_id - the ID of the Export plugin which is to be used to process the list. e.g. "BibTeX"
-$param{"fh"} = "temp_dir/my_file.txt"; - the file the results are to be out put to, useful for output too big to put into memory.
+$param{"fh"} = "temp_dir/my_file.txt"; - the file the results are to be output to, useful for output too large to fit into memory.
 <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>

@@ Line 10: / Line 10: @@
 '''EPrints::List''' - List of data objects, usually a search result.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 37: / Line 37: @@
    $dataset = $list-&gt;get_dataset(); #returns the dataset in which the containing objects belong
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 46: / Line 46: @@
 This class represents an ordered list of objects, all from the same dataset. Usually this is the results of a search.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 53: / Line 53: @@
 <!-- Pod2Wiki=head_see_also_l_eprints_search --></div>
 ==SEE ALSO	==
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 61: / Line 61: @@
 ===$list = EPrints::List-&gt;new( 			handle =&gt; $handle,			dataset =&gt; $dataset,			ids =&gt; $ids, # a ref to the array of ids			[order =&gt; $order] ); # the field on which to order the list===
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 75: / Line 75: @@
 If keep_cache is set then the cache will not be disposed of at the end of the current $handle. If cache_id is set then keep_cache is automatically true.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 87: / Line 87: @@
 $new_list = $list-&gt;reorder( "-creation_date" ); # makes a new list ordered by reverse order creation_date
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 101: / Line 101: @@
 $order - a field which the the resulting list will be ordered on. (optional)
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 117: / Line 117: @@
 $order - the field the remaining list is to be ordered by
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 131: / Line 131: @@
 $order -  the field the resulting list will be ordered on
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 141: / Line 141: @@
 Return the number of values in this list.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 151: / Line 151: @@
 Returns the DataObjs in this list as an array.  $offset - what index through the list to start from. $count - the maximum to return.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 163: / Line 163: @@
 $offset - what index through the list to start from. $count - the maximum to return.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 191: / Line 191: @@
+  }
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 205: / Line 205: @@
 $param{"fh"} = "temp_dir/my_file.txt"; - the file the results are to be out put to, useful for output too big to put into memory.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 215: / Line 215: @@
 Return the EPrints::DataSet which this list relates to.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->
@@ Line 225: / Line 225: @@
 Return a DOM XHTML description of this list, if available, or an empty fragment.
-<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 <h4><span style='display:none'>User Comments</span></h4>
 <!-- Edit below this comment -->

@@ Line 3: / Line 3: @@
   -->
 __NOTOC__
-{{Pod2Wiki}}{{API:Source|file=EPrints/List.pm|package_name=EPrints::List}}[[Category:API|List]]<div><!-- Edit below this comment -->
+{{API}}{{Pod2Wiki}}{{API:Source|file=EPrints/List.pm|package_name=EPrints::List}}[[Category:API|List]]<div><!-- Edit below this comment -->

← Older revision	Revision as of 15:59, 19 August 2009
Line 1:	Line 1:
−	+	wer

← Older revision		Revision as of 15:40, 12 August 2009
Line 1:		Line 1:
−	~~<!-- Pod2Wiki=_preamble_~~
−	~~This page has been automatically generated from the EPrints source. Any wiki changes made between the 'Pod2Wiki=*' and 'End of Pod2Wiki' comments will be lost.~~
−	~~-->{{Pod2Wiki}}{{API:Source\|file=EPrints/List.pm\|package_name=EPrints::List}}[[Category:API\|List]]<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=head_name -->=NAME=~~
−	~~'''EPrints::List''' - List of data objects, usually a search result.~~

−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=head_description -->=DESCRIPTION=~~
−	~~This class represents an ordered list of objects, all from the same dataset. Usually this is the results of a search.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_new -->==new==~~
−
−	$list = EPrints::List->new( session => $session, dataset => $dataset, [desc => $desc], [desc_order => $desc_order], ids => $ids, [encoded => $encoded], [keep_cache => $keep_cache], [order => $order] );
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_new -->==new==~~
−
−	~~$list = EPrints::List->new( session => $session, dataset => $dataset, [desc => $desc], [desc_order => $desc_order], cache_id => $cache_id );~~
−
−	~~Creates a new list object in memory only. Lists will be cached if anything method requiring order is called, or an explicit cache() method is called.~~
−
−	~~encoded is the serialised version of the searchExpression which created this list, if there was one.~~
−
−	~~If keep_cache is set then the cache will not be disposed of at the end of the current $session. If cache_id is set then keep_cache is automatically true.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_reorder -->==reorder==~~
−
−	~~$new_list = $list->reorder( $new_order );~~
−
−	~~Create a new list from this one, but sorted in a new way.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_union -->==union==~~
−
−	~~$new_list = $list->union( $list2, [$order] );~~
−
−	~~Create a new list from this one plus another one. If order is not set then this list will not be in any certain order.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_remainder -->==remainder==~~
−
−	~~$new_list = $list->remainder( $list2, [$order] );~~
−
−	~~Create a new list from this one minus another one. If order is not set then this list will not be in any certain order.~~
−
−	~~Remove all items in $list2 from $list and return the result as a new EPrints::List.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_intersect -->==intersect==~~
−
−	~~$new_list = $list->intersect( $list2, [$order] );~~
−
−	~~Create a new list containing only the items which are in both lists. If order is not set then this list will not be in any certain order.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_cache -->==cache==~~
−
−	~~$list->cache~~
−
−	~~Cause this list to be cached in the database.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_get_cache_id -->==get_cache_id==~~
−
−	~~$cache_id = $list->get_cache_id~~
−
−	~~Return the ID of the cache table for this list, or undef.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_dispose -->==dispose==~~
−
−	~~$list->dispose~~
−
−	~~Clean up the cache table if appropriate.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_count -->==count==~~
−
−	~~$n = $list->count~~
−
−	~~Return the number of values in this list.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_get_records -->==get_records==~~
−
−	~~@dataobjs = $list->get_records( [$offset], [$count] )~~
−
−	~~Return the objects described by this list. $count is the maximum to return. $offset is what index through the list to start from.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_get_ids -->==get_ids==~~
−
−	~~$ids = $list->get_ids( [$offset], [$count] )~~
−
−	~~Return a reference to an array containing the ids of the specified range from the list. This is more efficient if you just need the ids.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_map -->==map==~~
−
−	~~$list->map( $function, $info )~~
−
−	~~Map the given function pointer to all the items in the list, in order. This loads the items in batches of 100 to reduce memory requirements.~~
−
−	~~$info is a datastructure which will be passed to the function each time and is useful for holding or collecting state.~~
−
−	~~Example:~~
−
−	~~my $info = { matches => 0 };~~
−	~~$list->map( \&deal, $info );~~
−	~~print "Matches: ".$info->{matches}."\n";~~
−
−
−	~~sub deal~~
−	{
−	~~my( $session, $dataset, $eprint, $info ) = @_;~~
−
−	~~if( $eprint->get_value( "a" ) eq $eprint->get_value( "b" ) ) {~~
−	~~$info->{matches} += 1;~~
−	}
−	}
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_export -->==export==~~
−
−	~~$plugin_output = $list->export( $plugin_id, %params )~~
−
−	~~Apply an output plugin to this list of items. If the param "fh" is set it will send the results to a filehandle rather than return them as a string.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_get_dataset -->==get_dataset==~~
−
−	~~$dataset = $list->get_dataset~~
−
−	~~Return the EPrints::DataSet which this list relates to.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=item_render_description -->==render_description==~~
−
−	~~$xhtml = $list->render_description~~
−
−	~~Return a DOM XHTML description of this list, if available, or an empty fragment.~~
−
−	~~<!-- End of Pod2Wiki -->~~
−	~~<!-- Pod2Wiki=_postamble_ --><!-- End of Pod2Wiki -->~~