X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=ucw%2Fdoc%2Ffastbuf.txt;h=86ab55d923dba0b55026c31489b4e050d4e9dfc9;hb=a45646a634b71708f5bc4277868c60e80daaa84c;hp=c77642a93ae20de3760f331bf0fa3985c8e1a39c;hpb=a77e72c37fe1b2cb0eb2f704661dd296593d2078;p=libucw.git diff --git a/ucw/doc/fastbuf.txt b/ucw/doc/fastbuf.txt index c77642a9..86ab55d9 100644 --- a/ucw/doc/fastbuf.txt +++ b/ucw/doc/fastbuf.txt @@ -13,11 +13,17 @@ Once you have a fastbuf, you can access it by fuctions similar to those of formatted operations. Please keep in mind that fastbufs do not allow arbitrary mixing of reads and -writes on the same stream. If you need to mix them, you have to call bflush() -inbetween and remember that the file position reported by btell() points after +writes on the same stream. If you need to mix them, you have to call @bflush() +inbetween and remember that the file position reported by @btell() points after the flushed buffer, which is not necessarily the same as after the data you've really read. +Most fastbuf back-ends also participate in the libucw resource management system. +If you have a resource pool active, newly created fastbufs are automatically tied +to resources in the pool, so when the pool gets cleaned up, the fastbufs are +freed, too. The bclose() function is still available and it removes the tie +as needed. + .Back-ends: - <> - <> @@ -60,4 +66,4 @@ Invalid codes are replaced by `UNI_REPLACEMENT` when reading. ucw/ff-binary.h --------------- -Reading and writing of binary values. +!!ucw/ff-binary.h