silverstripe-framework/ORM/Limitable.php

<?php

namespace SilverStripe\ORM;

/**
 * Additional interface for {@link SS_List} classes that are limitable - able to have a subset of the list extracted.
 *
 * All methods in this interface are immutable - they should return new instances with the limit
 * applied, rather than applying the limit in place
 *
 * @see SS_List, Sortable, Filterable
 */
interface Limitable extends SS_List {

	/**
	 * Returns a new instance of this list where no more than $limit records are included.
	 * If $offset is specified, then that many records at the beginning of the list will be skipped.
	 * This matches the behaviour of the SQL LIMIT clause.
	 *
	 * @param int $limit
	 * @param int $offset
	 * @return static
	 */
	public function limit($limit, $offset = 0);

}