Table of Contents

findfirst

WMPRO, WMMINI FW >= 1.0 WMMEGA FW >= 2.0

Start searching the current folder for files matching a pattern and attributes

Description

array findfirst ( string $pattern, int $attributes )

Begin a search to iterate through a list of files

Parameters

$pattern: Partial or full pattern such as *.* or *.cgi

$attributes: Matching mask, leave at 255 to include all. See FAT file attributes for more information.

Return Values

Array of the first matching file containing the following keys and values:

KEYTYPEVALUE
filenamestringName of the file
attributesintFAT file attributes
filesizeintFile size in bytes
timestampintFAT timestamp of last save

Example

List all files in the root directory

<pre><?
  chdir("/"); // change to the root folder
  $arr=findfirst("*.*",255-16); // get the first entry matching any file, excluding directories
  while ($arr) {
    print($arr['filename']."\r\n");
    $arr=findnext(); // get another matching file
  }
?></pre>

Also See

findnext() - Return next matching file information (after a findfirst)

timefromfat() - Convert a FAT filetime to a Linux Timestamp

strftime() - Format a Linux Timestamp using a format string

chdir() - Change the current directory

file_exists() - Check if a file exists

filesize() - Return the size of a file, or the number of unread bytes in a stream or socket