mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
8331171f2c
Conflicts: .scrutinizer.yml admin/javascript/LeftAndMain.Panel.js core/startup/ParameterConfirmationToken.php dev/Debug.php dev/FixtureBlueprint.php docs/en/00_Getting_Started/05_Coding_Conventions.md docs/en/00_Getting_Started/index.md docs/en/02_Developer_Guides/01_Templates/01_Syntax.md filesystem/File.php filesystem/Folder.php forms/FieldList.php forms/LabelField.php forms/MoneyField.php forms/TextField.php forms/TreeDropdownField.php forms/Validator.php forms/gridfield/GridField.php forms/gridfield/GridFieldExportButton.php lang/de.yml lang/fi.yml model/DataObject.php model/SQLQuery.php parsers/ShortcodeParser.php security/ChangePasswordForm.php security/Security.php tests/control/DirectorTest.php tests/core/startup/ParameterConfirmationTokenTest.php tests/dev/FixtureBlueprintTest.php tests/forms/FieldListTest.php tests/forms/MoneyFieldTest.php tests/model/SQLQueryTest.php tests/security/SecurityTest.php
89 lines
1.6 KiB
PHP
89 lines
1.6 KiB
PHP
<?php
|
|
/**
|
|
* An interface that a class can implement to be treated as a list container.
|
|
*
|
|
* @package framework
|
|
* @subpackage model
|
|
*/
|
|
interface SS_List extends ArrayAccess, Countable, IteratorAggregate {
|
|
|
|
/**
|
|
* Returns all the items in the list in an array.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function toArray();
|
|
|
|
/**
|
|
* Returns the contents of the list as an array of maps.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function toNestedArray();
|
|
|
|
/**
|
|
* Adds an item to the list, making no guarantees about where it will
|
|
* appear.
|
|
*
|
|
* @param mixed $item
|
|
*/
|
|
public function add($item);
|
|
|
|
/**
|
|
* Removes an item from the list.
|
|
*
|
|
* @param mixed $item
|
|
*/
|
|
public function remove($item);
|
|
|
|
/**
|
|
* Returns the first item in the list.
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function first();
|
|
|
|
/**
|
|
* Returns the last item in the list.
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function last();
|
|
|
|
/**
|
|
* Returns a map of a key field to a value field of all the items in the
|
|
* list.
|
|
*
|
|
* @param string $keyfield
|
|
* @param string $titlefield
|
|
* @return array
|
|
*/
|
|
public function map($keyfield = 'ID', $titlefield = 'Title');
|
|
|
|
/**
|
|
* Returns the first item in the list where the key field is equal to the
|
|
* value.
|
|
*
|
|
* @param string $key
|
|
* @param mixed $value
|
|
* @return mixed
|
|
*/
|
|
public function find($key, $value);
|
|
|
|
/**
|
|
* Returns an array of a single field value for all items in the list.
|
|
*
|
|
* @param string $colName
|
|
* @return array
|
|
*/
|
|
public function column($colName = "ID");
|
|
|
|
/**
|
|
* Walks the list using the specified callback
|
|
*
|
|
* @param callable $callback
|
|
* @return mixed
|
|
*/
|
|
public function each($callback);
|
|
}
|