# GetFirstFile

## Description

Returns the name of the first file found in the current folder, which is set using SetFolder. You can call GetNextFile to continue down the list of files in the current folder. Returns an empty string if there are no files in the current folder.
By default this command will combine the file lists from the read and write folders into a single list (mode=2) this can be changed to only return files in the read folder (mode=0) or only return files from the write folder (mode=1)
Note that the read folder does not exist when using broadcast or debug to run the app, as files are copied into the write folder of the AGK Player for these run modes. On the other hand the write folder starts out as empty when running the app directly from the IDE, or when running the final app executable in the project folder.

## Definition

string GetFirstFile( mode )

char* agk::GetFirstFile( int mode )

string GetFirstFile()

char* agk::GetFirstFile()

## Parameters

- mode - 0 to only return files from the read folder, 1 to only return files from the write folder, 2 for both (default)