CERT C++: STR37-C

Arguments to character-handling functions must be representable as an unsigned char

expand all in page

Description

Rule Definition

Arguments to character-handling functions must be representable as an unsigned char.¹

Polyspace Implementation

The rule checker checks for Invalid arguments to character-handling functions.

Examples

expand all

Invalid arguments to character-handling functions

Issue

Invalid arguments to character-handling functions occurs when you use a signed or plain char variable with a negative value as argument to a character-handling function declared in <cctype>, for instance, isalpha() or isdigit().

Risk

You cannot use plain char variables as arguments to these character-handling functions. On certain platforms, plain char variables can have negative values that cannot be represented as unsigned char or EOF, resulting in undefined behavior.

Fix

To avoid unexpected results, explicitly cast plain char variables to unsigned char before passing to character-handling functions.

Check Information

Group: 05. Characters and Strings (STR)

Version History

Introduced in R2019a

¹ This software has been created by MathWorks incorporating portions of: the “SEI CERT-C Website,” © 2017 Carnegie Mellon University, the SEI CERT-C++ Web site © 2017 Carnegie Mellon University, ”SEI CERT C Coding Standard – Rules for Developing safe, Reliable and Secure systems – 2016 Edition,” © 2016 Carnegie Mellon University, and “SEI CERT C++ Coding Standard – Rules for Developing safe, Reliable and Secure systems in C++ – 2016 Edition” © 2016 Carnegie Mellon University, with special permission from its Software Engineering Institute.

ANY MATERIAL OF CARNEGIE MELLON UNIVERSITY AND/OR ITS SOFTWARE ENGINEERING INSTITUTE CONTAINED HEREIN IS FURNISHED ON AN "AS-IS" BASIS. CARNEGIE MELLON UNIVERSITY MAKES NO WARRANTIES OF ANY KIND, EITHER EXPRESSED OR IMPLIED, AS TO ANY MATTER INCLUDING, BUT NOT LIMITED TO, WARRANTY OF FITNESS FOR PURPOSE OR MERCHANTABILITY, EXCLUSIVITY, OR RESULTS OBTAINED FROM USE OF THE MATERIAL. CARNEGIE MELLON UNIVERSITY DOES NOT MAKE ANY WARRANTY OF ANY KIND WITH RESPECT TO FREEDOM FROM PATENT, TRADEMARK, OR COPYRIGHT INFRINGEMENT.

This software and associated documentation has not been reviewed nor is it endorsed by Carnegie Mellon University or its Software Engineering Institute.