C and C++


LANG.FUNCS.APM : Array Parameter Mismatch

Summary

A function parameter is declared to have array type with specified size S, but the function is called with an array argument that has fewer than S elements.

Properties

Class Name Array Parameter Mismatch
Significance reliability
Mnemonic LANG.FUNCS.APM
Categories
MisraC2023 MisraC2023:17.5 The function argument corresponding to a parameter declared to have an array type shall have an appropriate number of elements
Misra2012 Misra2012:17.5 The function argument corresponding to a parameter declared to have an array type shall have an appropriate number of elements
AUTOSARC++14 AUTOSARC++14:A18-1-1 C-style arrays shall not be used.
CWE CWE:686 Function Call With Incorrect Argument Type
  CWE:687 Function Call With Incorrectly Specified Argument Value
  CWE:688 Function Call With Incorrect Variable or Reference as Argument
TS17961 TS17961:5.6-argcomp 5.6. Calling functions with incorrect arguments
CERT-C CERT-C:EXP37-C Call functions with the correct number and type of arguments
Availability Available for C and C++.
Enabling Checks for this warning class are disabled by default, and require the unnormalized C ASTs for the project. To enable them, add the following WARNING_FILTER rule and RETAIN_UNNORMALIZED_C_AST specification to the project configuration file.
RETAIN_UNNORMALIZED_C_AST = Yes
WARNING_FILTER += allow class="Array Parameter Mismatch"
Note that retaining the unnormalized ASTs will increase the disk space used to store the project representation, and may make the analysis take longer.

Example

#include <stdlib.h>

void fnarr4 ( int a4[ 4 ] );
void fnarr2 ( int a2[ 2 ] );
void fnarr ( int a[ ] );

void apm( void )
{
    int arr3[ 3 ] = { 1, 2, 3 };
    int arr4[ 4 ] = { 0, 1, 2, 3 };

    fnarr4(arr3);  /* 'Array Parameter Mismatch' warning issued here */
    fnarr2(arr3);           /* length of arr3 ≥ 2  */
    fnarr(arr3);            /* fnarr() declaration does not specify size for array parameter */
}

Relevant Configuration File Parameters

The following configuration file parameters affect checks for this warning class.