Function file-length

Syntax:

Arguments and Values:

stream—a stream associated with a file.

length—a non-negative integer or nil.

Description:

23.3.0 21file-length returns the length of stream, or nil if the length cannot be determined.

For a binary file, the length is measured in units of the element type of the stream.

Examples:

 (with-open-file (s "decimal-digits.text" 
                    :direction :output :if-exists :error)
   (princ "0123456789" s)
   (truename s))
→ #P"A:>Joe>decimal-digits.text.1"
 (with-open-file (s "decimal-digits.text")
   (file-length s))
→ 10

Side Effects:

None.

Affected By:

None.

Exceptional Situations:

Should signal an error of type type-error if stream is not a stream associated with a file. !!! Is this going to run into trouble in cases like: (with-input-from-string (s "foo") (file-length s)) which an implementation might want to support even thought it's not required? -kmp 26-Apr-91

See Also:

open

Notes:

None.