$files->filterBy($key [, $operator], $value [, $split])

• $key (string)
  A field name or a method of the file, e.g. extension
• $operator (string)
  See list of filter methods below; if not a valid filter method the second parameter will be the value
• $value (mixed)
  
• $split (string)
  Character to split by while filtering
• return ($files)
  

Example

// filter by extension
$images = $page->images()->filterBy('extension', 'jpg');

// filter by custom field value
$images = $page->images()->filterBy('gallery', 'gallery-2');

// filter by filenames containing a string
$files = $page->files()->filterBy('filename', '*=', '-document');

// filter all types except documents
$files = $page->files()->filterBy('type', '!=', 'document');

Available filter methods