diff options
author | Yann Collet <Cyan4973@users.noreply.github.com> | 2019-11-30 16:16:58 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-11-30 16:16:58 (GMT) |
commit | bed083b3c76ae3ea76a5fc2edb822220fb69f680 (patch) | |
tree | 831ce9932c308fc1a7882e3142d5b7c172952f12 | |
parent | 6e0d2be73aae5a813bd5dc094bb39b3e03358817 (diff) | |
parent | 059682fb010167afdc6f1087b3b7f4bf3488a53f (diff) | |
download | lz4-bed083b3c76ae3ea76a5fc2edb822220fb69f680.zip lz4-bed083b3c76ae3ea76a5fc2edb822220fb69f680.tar.gz lz4-bed083b3c76ae3ea76a5fc2edb822220fb69f680.tar.bz2 |
Merge pull request #815 from andrewthad/patch-1
Fix typos in streaming_api_basics.md
-rw-r--r-- | examples/streaming_api_basics.md | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/examples/streaming_api_basics.md b/examples/streaming_api_basics.md index 90065e4..1ccc6e3 100644 --- a/examples/streaming_api_basics.md +++ b/examples/streaming_api_basics.md @@ -10,7 +10,7 @@ LZ4 has the following API sets : such as LZ4 command line utility, node-lz4, etc. - "Block" API : This is recommended for simple purpose. It compress single raw memory block to LZ4 memory block and vice versa. - - "Streaming" API : This is designed for complex thing. + - "Streaming" API : This is designed for complex things. For example, compress huge stream data in restricted memory environment. Basically, you should use "Auto Framing" API. @@ -19,13 +19,13 @@ But if you want to write advanced application, it's time to use Block or Streami ## What is difference between Block and Streaming API ? -Block API (de)compresses single contiguous memory block. -In other words, LZ4 library find redundancy from single contiguous memory block. -Streaming API does same thing but (de)compress multiple adjacent contiguous memory block. +Block API (de)compresses a single contiguous memory block. +In other words, LZ4 library finds redundancy from a single contiguous memory block. +Streaming API does same thing but (de)compresses multiple adjacent contiguous memory blocks. So LZ4 library could find more redundancy than Block API. The following figure shows difference between API and block sizes. -In these figures, original data is splitted to 4KiBytes contiguous chunks. +In these figures, the original data is split into 4KiBytes contiguous chunks. ``` Original Data @@ -81,7 +81,7 @@ This dependency improves compression ratio. ## Restriction of Streaming API -For the efficiency, Streaming API doesn't keep mirror copy of dependent (de)compressed memory. +For efficiency, Streaming API doesn't keep a mirror copy of dependent (de)compressed memory. This means users should keep these dependent (de)compressed memory explicitly. Usually, "Dependent memory" is previous adjacent contiguous memory up to 64KiBytes. LZ4 will not access further memories. |