diff avio.h @ 5580:07ce73fed19f libavformat

Make url_read_complete retry on EAGAIN and return how much data it read if it reached EOF, making it useful in more cases.
author reimar
date Sat, 23 Jan 2010 10:23:47 +0000
parents db1e4c61789a
children d205fac9f807
line wrap: on
line diff
--- a/avio.h	Sat Jan 23 09:42:52 2010 +0000
+++ b/avio.h	Sat Jan 23 10:23:47 2010 +0000
@@ -69,6 +69,14 @@
                        const char *filename, int flags);
 int url_open(URLContext **h, const char *filename, int flags);
 int url_read(URLContext *h, unsigned char *buf, int size);
+/**
+ * Read as many bytes as possible (up to size), calling the
+ * read function multiple times if necessary.
+ * Will also retry if the read function returns AVERROR(EAGAIN).
+ * This makes special short-read handling in applications
+ * unnecessary, if the return value is < size then it is
+ * certain there was either an error or the end of file was reached.
+ */
 int url_read_complete(URLContext *h, unsigned char *buf, int size);
 int url_write(URLContext *h, unsigned char *buf, int size);
 int64_t url_seek(URLContext *h, int64_t pos, int whence);