User Tools

A PCRE internal error occured. This might be caused by a faulty plugin

====== Function FILE-LENGTH ====== ====Syntax==== * **file-length** //stream// → //length// ====Arguments and Values==== * //stream// - a //[[CL:Glossary:stream associated with a file]]//. * //length// - a non-negative //[[CL:Glossary:integer]]// or **[[CL:Constant Variables:nil]]**. ====Description==== **file-length** returns the length of //stream//, or **[[CL:Constant Variables:nil]]** if the length cannot be determined. For a binary file, the length is measured in units of the //[[CL:Glossary:element type]]// of the //stream//. ====Examples==== <blockquote> ([[CL:Macros:with-open-file]] (s "decimal-digits.text" :direction :output :if-exists :error) ([[CL:Functions:princ]] "0123456789" s) ([[CL:Functions:truename]] s)) → #P"A:>Joe>decimal-digits.text.1" ([[CL:Macros:with-open-file]] (s "decimal-digits.text") (file-length s)) → 10 </blockquote> ====Side Effects==== None. ====Affected By==== None. ====Exceptional Situations==== Should signal an error of type type-error if //stream// is not a //[[CL:Glossary:stream associated with a file]]//. ====See Also==== 8 **[[CL:Functions:open|Function OPEN]]** ====Notes==== None.