Forrest logo
back to the test tool

test:tldr:084ca

test: Test if a file exists.
$ test -f "${filename_or_directory}"
try on your machine

The command test -f "${filename_or_directory}" is used to check whether the given filename_or_directory exists and is a regular file.

Here's a breakdown of the command:

  • test is a command-line utility used to perform various tests on files and directories.
  • The option -f is used to check if the provided argument is a regular file.
  • "${filename_or_directory}" is a shell variable reference, where filename_or_directory is the name of the file or directory you want to test.

When this command is executed, it will return a status code:

  • If the file exists and is a regular file, it will return a status code of 0, indicating that the test is successful.
  • If the file does not exist or is not a regular file, it will return a non-zero status code, indicating the test has failed.

This command is commonly used in shell scripts to perform conditional operations based on the existence and type of files.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the test tool