[Home]

Issue of the Standard # S0251

Brief

No information about return value in the description of toupper() function.

Detailed Description

The ‘RETURN VALUE’ section of the toupper() function’s description describes the return value upon successful completion, but does not describe it upon unsuccessful completion. The same section for the tolower() function, which description is similar to toupper(), describes the return value for both cases.

Problem location(s) in the standard

The Open Group Base Specifications Issue 6 IEEE Std 1003.1, 2004 Edition (SUS 3.0), System Interfaces, description of function <nobr>toupper()</nobr>.

Possible solutions

Change the RETURN VALUE from:
“Upon successful completion, toupper() shall return the uppercase letter corresponding to the argument passed.”
to:
“Upon successful completion, toupper() shall return the uppercase letter corresponding to the argument passed; otherwise, it shall return the argument unchanged.”

Accepted

POSIX aardvark,
Request Number 181

[Home]