Python’s Match-Case Is Too Slow (If You Don’t Understand It) | by Nicholas Obert | Apr, 2022

Find out how structural sample matching works, the place to make use of it, and what it is best to use as an alternative

Photograph by Michal Matlon on Unsplash

Python’s 3.10 model has introduced, amongst many adjustments, a brand new syntax function: structural sample matching. This function permits for easy declarative situation dealing with that’s supposed to exchange if-else assertion sequences with a way more concise syntax.

Now, if you happen to come from a compiled language like C, you may see Python’s match-case assertion like a switch-case, just below a unique identify. Nevertheless, whereas the C compiler often generates a sensible lookup table-like construction to effectively deal with the varied instances, Python’s structural sample matching is as an alternative fairly inefficient, particularly if you happen to use it improperly. Let’s see why.

Python match-case assertion instance

I’m positive all of you might be accustomed to utilizing a collection of if-else statements to test situations and alter this system conduct accordingly:

Utilizing Python 3.10’s structural sample matching you’ll write as an alternative one thing like this:

These two code snippets obtain precisely the identical factor: they do stuff based mostly on which identify you cross in. So, how are they completely different?

Match-case vs if-else efficiency benchmark

I’m now going to match the efficiency of two Python features, one applied utilizing structural sample matching and the opposite as a sequence of if-else statements.

If-else assertion sequence
Structural sample matching

And right here’s the code answerable for the benchmark:

Code for the benchmark

Let’s check out the outcomes:

Common time for match_case:  0.004244441888295114 seconds
Common time for if_else: 0.004139213310554624 seconds

As you’ll be able to clearly see, each features took the identical time to execute. And what if I instructed you they work the identical beneath the hood?

How does match-case work?

Now we’re going to check out what Python’s structural sample matching actually is and the way it compares with if-else statements. For this evaluation, we’re going to use Compiler Explorer, a robust web site that permits you to simply have a look at the meeting directions generated by compiling a given piece of code.

Initially, here’s a simplified if-else sequence and the relative disassembled Python byte code. Don’t fear if you happen to’re not accustomed to meeting languages, as I will likely be explaining the directions as wanted.

Easy if-else sequence
Commented generated meeting code for the if-else sequence

As you may need guessed, a sequence of if-else statements compiles to a collection of comparisons. Now, let’s check out the match-case model:

Easy match-case assertion
Commented meeting code for the match-case assertion

As you’ll be able to see, Python’s match-case assertion is only a collection of comparisons beneath the hood, precisely just like the if-else technique. For this reason after we benchmarked the 2 approaches they carried out equally.

Nevertheless, it is best to observe that Python’s structural sample matching doesn’t carry out a plain object comparability, however somewhat a sample comparability. For that reason, the __eq__() technique (which is answerable for dealing with the == operations) doesn’t get known as when dealing with the instances of the match-case assertion. To show this, let’s run this easy code snippet with a customized object:

Match-case unwanted effects

Now, if the __eq__() technique was successfully known as, we must always get one thing printed to the console for every case that will get examined, however we don’t, as you’ll be able to see from the console output:

$ python3 match_side_effects.py5

Nevertheless, if we carried out the identical sort of comparability with an if-else sequence, we’d get the next output, which means that the __eq__() technique known as for each comparability:

If-else unwanted effects

And the corresponding console output:

$ python3 

5 == 1
5 == 2
5 == 3
5 == 4
5 == 5

From what we’ve got seen up to now, Python’s structural sample matching is mostly a sequence of if-else statements beneath a unique identify and a nicer syntax. Whereas match-case absolutely has its place in your toolbox (we’ll talk about this later), if you’re in search of runtime efficiency, you may want one thing completely different: right here’s a quicker method.

Lookup tables and hash tables

Merely put, lookup tables and hash tables are information buildings used to retailer pre-computed values so as to not must calculate them at runtime. Say you might have a listing of uniquely-named individuals which can be allowed to enter a sure room. You may test if somebody is allowed to enter via an if-else sequence:

Whereas this method is ok for just some instances, it turns into fairly inefficient to test for each potential identify because the allowed individuals checklist grows.

Right here’s how you’ll do it with a hash desk, also referred to as a dictionary:

To raised perceive what’s occurring, let’s check out the generated meeting directions with Compiler Explorer:

As you’ll be able to see, the condition-checking half is far less complicated, in comparison with what we’ve got seen earlier than with the if-else sequence and the match-case assertion. Let’s now see how briskly hash tables are, in comparison with sequential checks.

For the benchmark, we’ll be utilizing the earlier code snippets (if_names() and match_names()) to be in contrast in opposition to the identical logic applied via a hash desk:

And the benchmark code, which is identical as earlier than, save we’ve got added the take a look at for dict_names():

Let’s now check out the outcomes:

Common time for match_case:  0.004383811901789159 seconds
Common time for if_else: 0.00433244610321708 seconds
Common time for dict_lookup: 0.0008352182921953499 seconds

We’ve got a transparent winner: hash tables are manner quicker than a sequence of comparisons, round 5.3 instances extra performant.

When to make use of structural sample matching

Up till now, I’ve solely talked negatively about structural sample matching, saying that it’s sluggish and nothing greater than a sequence of if-else statements. Nevertheless, it nonetheless deserves its place in your toolbox as what it was really meant to be: a sample matching assertion.

In case you have a considerably advanced sample you wish to test for, you wouldn’t have many possibilities of getting away with a hash desk or a lookup desk due to their intrinsic inflexibility which makes them so quick. If-else statements might do the job, however the code would rapidly get tousled. That is the place try to be utilizing structural sample matching. Right here’s an instance from the PEP-636:

When you’re introduced with a few easy situations, it is best to as an alternative use a plain sequence of if-else statements.

Lastly, you probably have numerous potential instances that may be handled as easy situations otherwise you want runtime efficiency, you’ll be higher off utilizing a hash desk or a lookup desk:

Observe additionally that lookup tables and hash tables aren’t simply restricted to storing easy values, however they’ll additionally comprise complete features or advanced objects.

Now, if you’re coding in Python, likelihood is your major objective is just not runtime efficiency, for which it is best to go for a compiled language. Nevertheless, a major velocity enhance — keep in mind the 5.3-times efficiency enhance within the benchmark — by no means hurts. Furthermore, it’s all the time good to know your instruments, their strengths, and weaknesses, and, generally, pay attention to what you might be doing.


To wrap it up, structural sample matching is a robust syntax function that permits for easy declarative situation branching. Whereas it turns out to be useful for sample matching — its unique objective — some builders mistake it for a performant lookup table-like instrument just like how the C compiler optimizes switch-case statements.

The important thing takeaway is that it is best to know your instruments to resolve which is essentially the most acceptable in every particular state of affairs.

There isn’t a one-size-fits-all method in life. All of it boils right down to utilizing the suitable instrument for the suitable job.

I hope you loved this text. In case you have something so as to add, please share your ideas in a remark. Thanks for studying!

In case you are fascinated with studying extra about lookup tables and hash tables, I recommend you checked out this story beneath:

More Posts