https://github.com/ws-garcia/ECPTextStream

ECPTextStream is a VBA text buffered reader designed to manage text streams in Microsoft Office applications, from VBA.
https://github.com/ws-garcia/ECPTextStream

buffered-reader bufferedreader stream textfiles textstream vba vbastream

Last synced: 2 months ago
JSON representation

ECPTextStream is a VBA text buffered reader designed to manage text streams in Microsoft Office applications, from VBA.

• Host: GitHub
• URL: https://github.com/ws-garcia/ECPTextStream
• Owner: ws-garcia
• License: gpl-3.0
• Created: 2020-12-26T21:53:29.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2023-02-07T04:08:20.000Z (almost 2 years ago)
• Last Synced: 2024-08-13T07:18:17.791Z (6 months ago)
• Topics: buffered-reader, bufferedreader, stream, textfiles, textstream, vba, vbastream
• Language: VBA
• Homepage: https://ws-garcia.github.io/ECPTextStream/
• Size: 19.8 MB
• Stars: 11
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - ws-garcia/ECPTextStream - ECPTextStream is a VBA text buffered reader designed to manage text streams in Microsoft Office applications, from VBA. (VBA)

README

        
# ![ECPTextStream](/docs/assets/img/ECPTextStream.png)

[![GitHub](https://img.shields.io/github/license/ws-garcia/ECPTextStream?style=plastic)](https://github.com/ws-garcia/ECPTextStream/blob/main/LICENSE) [![GitHub release (latest by date)](https://img.shields.io/github/v/release/ws-garcia/ECPTextStream?style=plastic)](https://github.com/ws-garcia/ECPTextStream/releases/latest)

## Introductory words

ECPTextStream is an easy-to-use class module developed to enable buffered text stream on VBA. In other words, ECPTextStream is a VBA text buffered reader designed to manage text streams in Microsoft Office applications.

## Advantages

* The fastest way for I/O operations over "big" text files from VBA (up to 600 MB/sec.).

* Supports files up to 2 GB of size.

* Supports streams delimited by CRLF, LF and CR characters. This is useful when working with structured files like CSVs.

* No memory overloads. Text files being read using a buffer, small enough to hold a single data line. 

* Minimal CPU overheat.

* Configurable buffer size.

* Coded in pure VBA. The module hasn’t reference to any external API library.

## Getting started

If you don't know how to get started with ECPTextStream class, visit the [documentation repo](https://ws-garcia.github.io/ECPTextStream/). If you don't know if this tool can help you, take a look to the popular [CSV Interface repo](https://github.com/ws-garcia/VBA-CSV-interface) or to this [sample project](https://ws-garcia.github.io/ECPTextStream/project_sample/).

## Contributing

In order to contribute with in this project, please see the [guidance for contributing](https://ws-garcia.github.io/ECPTextStream/contributing.html).

## Benchmark

The benchmark results for ECPTextStream are available at [this site](https://ws-garcia.github.io/ECPTextStream/home/getting_started.html#benchmark).

## Limitations

Visit [this site](https://ws-garcia.github.io/ECPTextStream/limitations/index.html) in order to known around file size considerations.

## License

Copyright (C) 2021-2023  [W. García](https://github.com/ws-garcia/).

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program.  If not, see .