# How fast can you count lines?

Inspired by earlier work by Llogiq, I decided to look at how fast I could count the number of lines in a string. By assuming that the string relies on ASCII, UTF-8 or other ASCII superset character encoding, the bulk of the work consists in counting the linefeed (‘\n’) characters.

Most programmers would proceed as follows…

```cnt = 0;
for(i = 0; i < size; i++)
if(buffer[i] == '\n') cnt ++;
return cnt;
```

It runs at about 0.66 cycles per input character on a recent x64 processor.

Your compiler achieves this speed by automatically vectorizing the problem.

Can we do better?

Let us try a vectorized approach using AVX intrinsics. The idea is simple. We use a vectorized counter made of 32 individual counters, initialized at zero. Within a loop, we load 32 bytes, we compare them (using a single instruction) with the linefeed character. We add the result to the running counter.

```__m256i cnt = _mm256_setzero_si256(); // 32 counters
// ...
__m256i newdata = // load 32 bytes
__m256i cmp = _mm256_cmpeq_epi8(newline,newdata);
```

So per blocks of 32 input bytes, we use 3 instructions (one load, one comparison and one addition), plus some overhead. Could we do better? Maybe but I suspect it would be very difficult to use far fewer than 3 instructions per 32 input bytes on current processors.

With appropriate loop unrolling, this vectorized approach runs about ten times faster than the naive approach (0.04 cycles per input byte) or about 1.3 cycles per 32 input bytes. Because x64 processors have a hard time sustaining more than 4 instructions per cycle, we can estimate that our vectorized implementation is probably within a factor of two of optimality.

How does it compare with Llogiq’s best approach? I’d be interested in knowing, but his code is written in Rust, so this makes a direct comparison with my C code somewhat more difficult.

Note: I have updated my code following a comment by Turbo.

Daniel Lemire, "How fast can you count lines?," in Daniel Lemire's blog, February 14, 2017.

### Daniel Lemire

A computer science professor at the University of Quebec (TELUQ).

## 12 thoughts on “How fast can you count lines?”

1. Although your compiler should sort this out for you – it would be preferable to use the pre-increment operator unless you explicitly want the post increment.

1. Can you demonstrate an example in C where there is any performance difference between pre-increment versus post-increment? (I do mean “C”, as in C99. Not C++.)

2. wmu says:

Daniel, did you see what decent compiler do with the scalar code? GCC 5.4 (and newer) make attempt to vectorize the code: https://godbolt.org/g/uXl6g1

The result is not the best code possible, thus the performance isn’t good. Anyway, I’m impressed.

1. wmu says:

BTW, I rewritten your basiccount method using some SWAR tricks. The procedure from gist[1] works at 0.45 cycles on Skylake.

2. It seems that icc and clang also vectorize the problem. It is not surprising considering how common such code is likely to be. What is slightly disappointing is how they all seem to get it wrong, performance wise.

3. Cristi C says:

According to https://github.com/vks/bytecounttest, llogiq’s solution runs in about 29ms against your 40ms in the `avxu` version (if I read that benchmark correctly). I’m a little worried about differences around inlining (since the bench code is written in Rust, linking with your C code), but I’d say that the perf is very much in the same ballpark.

1. Hmmm… the numbers I see reported are 29 ns vs. 40 ns. From my naive look at the Rust code, this seems to be measuring the time to process a whole string.

1. Cristi C says:

Sorry, I meant `ns`, just typo’d `ms` vs `ns`. I kept the same ratio though 😛

1. Yes, but I cannot trust these numbers. Did you manage to compile this code and run it for yourself?

1. Sorry, I was not able to run the benchmarks so far due to a build script error I don’t have sufficient time to debug at the moment.

In case it helps, I personally have met vks at multiple meetups and trust his results are accurate (on his machine, YMMV).

To help explain this, bytecount in its current version also uses AVX, and still does the intermediate reduction, which enables it to count more bytes with one 512bit counter.

1. In case it helps, I personally have met vks at multiple meetups and trust his results are accurate

It is not a matter of putting into question the integrity of the individual. Rather it is a matter of having numbers that say what you think they say.

I report processing input bytes at a rate of 0.04 cycles per byte.

What should I infer from the 29 ns vs. 40 ns number? That he tested a faster approach that can process input bytes at a rate of 0.03 cycles per byte?

That’s not an impossible number… but is that what is being claimed?

You see my problem?

When I write that I do not trust these numbers, I don’t mean that the author made up numbers or cheated in some way… I mean that I am not confident people know what they mean exactly.

Something else bothers me. He reports two orders of magnitude gains over the basic code. I report a single order of magnitude difference. What explains this difference? Possibly the inefficiency of the Rust compiler, but once we start factoring in the possibility that the Rust compiler is deficient, all sorts of considerations must enter into play.

To put it bluntly, we need a lot more analysis to understand what is going on.

At this point, we do not have an analysis (e.g., how many CPU cycles are used per input byte) and it is not straight-forward to reproduce the benchmark.

You may subscribe to this blog by email.