GH-44923: [MATLAB] Add IPC RecordBatchStreamReader MATLAB class

[kevingurney]

Rationale for this change

To enable support for the IPC Streaming format in the MATLAB interface, we should add a RecordBatchStreamReader class.

This is a followup to #44922

What changes are included in this PR?

1. Added a new arrow.io.ipc.RecordBatchStreamReader MATLAB class.

Are these changes tested?

Yes.

1. Added new MATLAB test suite arrow/matlab/test/arrow/io/ipc/tRecordBatchStreamReader.m.

Are there any user-facing changes?

Yes.

1. Users can now create arrow.io.ipc.RecordBatchStreamReader objects to read RecordBatch objects incrementally from an Arrow IPC Stream file.

Notes

1. Thank you @sgilmore10 for your help with this pull request!

• GitHub Issue: [MATLAB] Add IPC RecordBatchStreamReader MATLAB class #44923

[sgilmore10]

Looks good! Thanks for working on this :)

[kevingurney]

Thanks for the review @sgilmore10! Sorry for all of the typos!

[kou]

I'm not familiar with MATLAB but does MATLAB require those APIs for iterator (or something)?

If we don't require this, it may be better that we don't provide them... If we don't have them, we can simplify our implementation.

[kevingurney]

That's a good question.

There is no specific API for iteration in MATLAB (i.e. there is no for each style iteration). So, we were trying to emulate this behavior using a "while has more data"-style loop. There is precedent for this pattern of iteration being used elsewhere in MATLAB.

Does that answer your question?

[kou]

Thanks. Yes.

One more question. Is while record_batch = reader.read()-style loop used in MATLAB too? If the style is also used in MATLAB, we may want to recommend the style for the MATLAB bindings.

[kevingurney]

Unfortunately, no - MATLAB does not support variable assignment like while record_batch = reader.read() inside of a while loop expression, either. If that syntax was supported, I agree it would be preferable.

[kou]

I see!

[kou]

+1