---
method: read
summary: "Read the specified amount of characters or the whole file."
synopsis: "File.prototype.read(amount)"
arguments:
  - "**amount**: the amount of characters or -1 to read all (Optional, default: -1)."
returns: "The string."
throws: "An [Irccd.SystemError](@baseurl@/api/module/Irccd/index.html#types) on failures."
---