Reference

Text

KirbyText
Markdown

Templates

Field methods
Helpers

Panel

Blueprints
Presets
Fields
Sections
Icons
Samples

Objects

$file
$files
$kirby
$language
$languages
$page
$pages
$pagination
$request
$session
$site
$user
$users

Router

Patterns
Response types

System

Options
Urls
Roots
Validators

Plugins

Extensions
Hooks
Core components
UI Kit

API

Authentication
Languages
Pages
Roles
Site
System
Translations
Users

Tools

A
Cookie
Data
Dir
Escape
F
Header
Html
Mime
Server
Str
Url
Xml

$files->add()
Adds a single file or an entire second collection to the current collection
$files->append()
Appends an element to the data array
$files->changeSort()
Sort all given files by the order in the array
$files->clone()
Returns a cloned instance of the collection
$files->count()
Counts all elements
$files->current()
Returns the current element
$files->data()
Getter and setter for the data
Files::factory()
Creates a files collection from an array of props
$files->filter()
Filters elements by a custom filter function or an array of filters
$files->filterBy()
Filters elements by one of the predefined filter methods.
$files->find()
Find one or multiple elements by id
$files->findBy()
Find a single element by an attribute and its value
$files->findById()
Tries to find a file by id/filename
$files->findByKey()
Alias for FilesFinder::findById() which is used internally in the Files collection to map the get method correctly.
$files->first()
Returns the first element
$files->flip()
Returns the elements in reverse order
$files->group()
Groups the elements by a given callback
$files->groupBy()
Groups the items by a given field
$files->has()
Checks if the given object or id is in the collection
$files->indexOf()
Correct position detection for objects.
$files->isEmpty()
Checks if the number of elements is zero
$files->isEven()
Checks if the number of elements is even
$files->isNotEmpty()
CChecks if the number of elements is more than zero
$files->isOdd()
Checks if the number of elements is odd
$files->key()
Returns the current key
$files->keyOf()
Tries to find the key for the given element
$files->keys()
Returns an array of all keys
$files->last()
Returns the last element
$files->limit()
Returns a new object with a limited number of elements
$files->map()
Map a function to each element
$files->next()
Moves the cursor to the next element and returns it
$files->not()
Returns a Collection without the given element(s)
$files->nth()
Returns the nth element from the collection
$files->offset()
Returns a new object starting from the given offset
$files->paginate()
Add pagination
$files->pagination()
Get the previously added pagination object
$files->parent()
Returns the parent model
$files->pluck()
Extracts all values for a single field into a new array
$files->prepend()
Prepends an element to the data array
$files->prev()
Moves the cursor to the previous element and returns it
$files->query()
Runs a combination of filterBy, sortBy, not offset, limit and paginate on the collection.
$files->remove()
Removes an object
$files->rewind()
Moves the cusor to the first element
$files->search()
Searches the collection
$files->set()
Adds a new element to the collection
$files->shuffle()
Shuffle all elements
$files->slice()
Returns a slice of the object
$files->sortBy()
Sorts the elements by any number of fields
$files->template()
Filter all files by the given template
$files->toArray()
Converts all objects in the collection to an array. This can also take a callback function to further modify the array result.
$files->toJson()
Converts the object into a JSON string
$files->toString()
Convertes the object to a string
$files->valid()
Checks if the current element is valid
$files->without()
Alias for $this->not()

$files->prev()

Moves the cursor to the previous element and returns it

$files->prev(): mixed

Return type

mixed

Source code

kirby/src/Toolkit/Iterator.php#L66