:sig
function file_get_contents(path : string) string

:params
path : path of the file to read

:returns
The file content, or `""` when Capy cannot read the file.

:content
`file_get_contents` reads a complete file into a string. Use it for a small file that fits in one value. Use `file_open` and `file_read` for incremental reads.

:note
An empty file and an unreadable file both return `""`. Use `file_exists` when you must distinguish them.

:example capy render
file_put_contents("/tmp/doc-get.txt", "hello")
print(file_get_contents("/tmp/doc-get.txt"), "\n")

:see-group
files

:see
file_open
