On 23 Jul 2018, at 09:38, Pavel Krivanek <pavel.krivanek@gmail.com> wrote:
Hello,
I've prepared a draft of a short document that should help you with the transition to the "new" file streams API in Pharo 7.
https://github.com/pavel-krivanek/pharoMaterials/blob/master/Filestreams.MD
Pull requests are welcome.
Cheers, -- Pavel
Great contribution, thanks ! I see no factual errors, everything is clear, cookbook style. The last two sections might be more confusing than helpful. I would go more for 'all streams are buffered, don't worry' and 'beware positioning is byte based'. Regarding positioning, some additional points that might no be so well known. - Positioning in a variable length encoded stream is plain hard (and basically comes down to linear searching) - All ZnCharacterEncoders understand #backOnStream: that does the right thing - There is also ZnPositionableReadStream that can help (read the class comment) Sven