Skip to main content

Assert This!

Long ago we all went to college and learned about the assert() function in C and later, C++. At the time, assert() was a great little tool for quickly bailing out of your program when you thought it could not finish.  I used it when my calls to malloc() would fail.  Lately, though, I’ve seen commercial software vendors proclaiming their use of assert() as a way of writing safer code.  This is madness.

First of all, the assert() function is just a print and exit macro.  Your assertion message is printed to the tty, and then your application exits with an error code.  That’s it, no segmentation fault, no core dump, nothing else, just exit.

Imagine your surprise when your favorite game all of a sudden just exits back to shell right in the middle of fighting the super.  You would likely not play that game again.  When there’s a GUI, the tty is redirected to the /dev/null device, which means there is no output.  So much for that assert message getting to your users.

Now let’s imagine a more sinister scenario that is commonplace today.  You are using a library in your web application that performs something like PDF generation.  It works just great until one day all of your web sites crash for no reason.  If you’re like me, you have them programmed to send you email when they fail, and now you’ve got a thousand emails in your inbox and more waiting at the server.  Plus, your client is calling you asking why your crappy software doesn’t work.  Crap!

No logs are generated, nothing written to the web server’s error log, nada.  Only when you find the system log (or the Event Viewer in Windows), do you see a lone message from your library proclaiming “assert() at line XX in a/b/c/d.c raised.”  Wonderfully descriptive and helpful in diagnosing why the assert() was triggered.

Worst of all, you have to restart the entire web server, kick out what could be thousands of users to your site, and hope that it won’t happen again. To rub salt in your wound, your client has lost what could be thousands of dollars in business.

When this happened to me, I contacted the software vendor about their assert().  They only responded with “give us a sample program that demonstrates the problem.”  Uh, hello? Either they are completely clueless about when to use assert(), or else I am missing something.  The purpose of the assert() is to catch instances where your program can not continue.  That should be less than 0.001% of the processing time.  It would be impossible for me, or anyone for that fact, to reproduce a sample program that exemplifies the assert!  So I pressed them further and made them actually investigate the problem.  In this case, their library could not handle multiple objects with the same name in the PDF catalog.  Instead of throwing an exception, they just asserted!  Yeah, asserted an ERROR condition.

Too many times, young programmers who are fresh out of college think that what they learned can be directly translated to a commercial product. We all know that this is not the way to produce commercial software.  So, bad on me for paying for that software, but bad on them for not knowing better.  The Internet has made it far too easy for mediocre programmers to produce even more mediocre software at a price that is comparable to that paid to exceptional programmers.  The next time you are in the market for a PDF library, stay clear of ABCpdf from WebSupergoo.  They use asserts when they should be using exceptions.  That misunderstanding will cost you more than the $500 they charge for their software.

Popular posts from this blog

THE RISE OF FASCIST SOCIAL MEDIA

The Merriam-Webster dictionary defines fascism as: a tendency toward or actual exercise of strong autocratic or dictatorial control .  The phrase "dictatorial control" is important for the case that I am going to make about fascism in social media. The word "dictatorial" means "of or relating to a dictator," and a dictator is "one ruling in an absolute and often oppressive way." In 2020, social media has seen a rise in the number of autocratic events of censorship. The two social media outlets that I am going to focus on are Facebook and Twitter.  Background Facebook is a semi-private curated blogging platform where you, the user, share information at your leisure. The public part of Facebook is in Facebook Groups. With a group, outside people who are not privy to your "Facebook Wall" will join your group and establish a communal discourse. This can be private, by invitation only, or public. The Facebook is auth-walled so that you must ...

Clustered Foolishness

I had morning coffee with a well respected friend of mine recently. Aside from chatting about the usual wifery and family, we touched on the subject of clustered indices and SQL Server performance. A common misconception in the software industry is that a clustered index will make your database queries faster. In fact, most cases will demonstrate the polar opposite of this assumption. The reason for this misconception is a misunderstanding of how the clustered index works in any database server. A clustered index is a node clustering of records that share a common index value. When you decide on an index strategy for your data, you must consider the range of data to be indexed. Remember back to your data structures classes and what you were taught about hashtable optimizations. A hashtable, which is another way of saying a database index, is just a table of N values that organizes a set of M records in quickly accessible lists that are of order L, where L is significantly less than M. ...

Trademarks In The Dark

If you have a business, then you know that filing for a trademark is pretty easy in the USA. You just go to the USPTO web site ( www.uspto.gov ) and start filling out the form. The cost is significantly less now, nearly a third of what it was a couple of years ago. That's great news. What you don't know about your mark, though, is that there is a plethora of common law that dictates whether or not you can file with your specimens. The specimens are documents that clearly show your mark being used in commerce. Well, my last mark registration came back to me with the examiner asking for a better specimen that places the mark in closer proximity to evidence of commerce. Closer proximity. Yeah. Right. Apparently Lands’ End, Inc. v. Manbeck, 797 F. Supp. 511, 514, 24 USPQ2d 1314, 1316 (E.D. Va. 1992); In re Dell Inc., 71 USPQ2d 1725, 1727-1729 (TTAB 2004); In re MediaShare Corp., 43 USPQ2d 1304 (TTAB 1997); TMEP §§904.06(a) and (b), establish some common law that determines an acce...