> On 23 Jul 2018, at 09:38, Pavel Krivanek <pavel.kriva...@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
