diff --git a/reference/filesystem/functions/fseek.xml b/reference/filesystem/functions/fseek.xml index 46b5454c4a..8e002eb15a 100644 --- a/reference/filesystem/functions/fseek.xml +++ b/reference/filesystem/functions/fseek.xml @@ -21,6 +21,13 @@ offset to the position specified by whence. + + In general, it is allowed to seek past the end-of-file; if data is then + written, reads in any unwritten region between the end-of-file and the + sought position will yield bytes with value 0. However, certain streams + may not support this behavior, especially when they have an underlying + fixed size storage. + @@ -67,8 +74,7 @@ &reftitle.returnvalues; - Upon success, returns 0; otherwise, returns -1. Note that seeking - past EOF is not considered an error. + Upon success, returns 0; otherwise, returns -1. @@ -109,9 +115,9 @@ fseek($fp, 0); - May not be used on file pointers returned by fopen if - they use the http:// or ftp:// - schemes. + Not all streams support seeking. For those that do not support seeking, + forward seeking from the current position is accomplished by reading + and discarding data; other forms of seeking will fail.