forked from OSchip/llvm-project
2074 lines
56 KiB
HTML
2074 lines
56 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
|
|
"http://www.w3.org/TR/html4/strict.dtd">
|
|
<html>
|
|
<head>
|
|
<title>List of potential checkers</title>
|
|
<link type="text/css" rel="stylesheet" href="content.css">
|
|
<link type="text/css" rel="stylesheet" href="menu.css">
|
|
<script type="text/javascript" src="scripts/expandcollapse.js"></script>
|
|
<script type="text/javascript" src="scripts/menu.js"></script>
|
|
</head>
|
|
<body onload="initExpandCollapse()">
|
|
|
|
<div id="page">
|
|
|
|
<!-- menu -->
|
|
<!--#include virtual="menu.html.incl"-->
|
|
<!-- page content -->
|
|
<div id="content">
|
|
<h1>List of potential checkers</h1>
|
|
|
|
<p>This page contains a list of potential checkers to implement in the static analyzer. If you are interested in contributing to the analyzer's development, this is a good resource to help you get started. The specific names of the checkers are subject to review, and are provided here as suggestions.</p>
|
|
|
|
<!-- ========================= allocation/deallocation ======================= -->
|
|
<h3>memory</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
memory.LeakEvalOrder</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Potential memory leaks caused by an undefined argument evaluation order.
|
|
<p>Source: <a href="http://www.boost.org/doc/libs/1_49_0/libs/smart_ptr/shared_ptr.htm#BestPractices">
|
|
boost docs: shared_ptr</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void f(int, int);
|
|
int g(void *);
|
|
int h() __attribute__((noreturn));
|
|
|
|
void test() {
|
|
// It is possible that 'malloc(1)' is called first,
|
|
// then 'h()', that is (or calls) noreturn and eventually
|
|
// 'g()' is never called.
|
|
f(g(malloc(1)), h()); // warn: 'g()' may never be called.
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void f(int, int);
|
|
int g(int *);
|
|
int h() { throw 1; };
|
|
|
|
void test() {
|
|
// It is possible that 'new int' is called first,
|
|
// then 'h()', that throws an exception and eventually
|
|
// 'g()' is never called.
|
|
f(g(new int), h()); // warn: 'g()' may never be called.
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
memory.DstBufferTooSmall</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Destination buffer passed to memory function is too small.
|
|
<br>Note: <span class="name">security.insecureAPI.strcpy</span> currently warns
|
|
on usage of <code>strcpy</code> and suggests to replace it.
|
|
<br>Note: <span class="name">alpha.unix.CStringChecker</span> contains some similar checks.
|
|
<p>Source: <a href="https://cwe.mitre.org/data/definitions/120.html">CWE-120</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
const char* s1 = "abc";
|
|
char *s2 = new char;
|
|
strcpy(s2, s1); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int* p1 = new int[3];
|
|
int* p2 = new int;
|
|
memcpy(p2, p1, 3); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
memory.NegativeArraySize</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
'n' is used to specify the buffer size may be negative.
|
|
<br>Note: possibly an enhancement to <span class="name">
|
|
alpha.security.MallocOverflow</span>.
|
|
<p>Source: <a href="http://cwe.mitre.org/data/definitions/20.html">CWE-20,
|
|
Example 2</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int *p;
|
|
int n1 = -1;
|
|
p = new int[n1]; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
memory.ZeroAlloc</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Allocation of zero bytes.
|
|
<br>Note: an enhancement to <span class="name">unix.Malloc</span>.
|
|
<br>Note: <span class="name">unix.API</span> perform C-checks for zero
|
|
allocation. This should be moved to <span class="name">unix.Malloc</span>.
|
|
<p>Source: C++03 3.7.3.1p2; C++11 3.7.4.1p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <stdlib.h>
|
|
|
|
void test() {
|
|
int *p = malloc(0); // warn
|
|
free(p);
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int *p = new int[0]; // warn
|
|
delete[] p;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"><a href="http://reviews.llvm.org/D6178">
|
|
D6178</a></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ======================= constructors/destructors ====================== -->
|
|
<h3>constructors/destructors</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
ctordtor.ExptInsideDtor</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
It is dangerous to let an exception leave a destructor.
|
|
Using <code>try..catch</code> solves the problem.
|
|
<p>Source: Scott Meyers "More Effective C++", item 11: Prevent exceptions from
|
|
leaving destructors.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {
|
|
A() {}
|
|
~A() { throw 1; } // warn
|
|
};
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void f() throw(int);
|
|
|
|
class A {
|
|
A() {}
|
|
~A() { f(); } // warn
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
ctordtor.PlacementSelfCopy</span><span class="lang">
|
|
(C++11)</span><div class="descr">
|
|
For a placement copy or move, it is almost certainly an error if the
|
|
constructed object is also the object being copied from.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {};
|
|
|
|
void test(A *dst, A *src) {
|
|
::new (dst) A(*dst); // warn (should be 'src')
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"><!--rdar://problem/13688366--></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- =============================== va_list =============================== -->
|
|
<h3>va_list</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
valist.Uninitialized</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Calls to the <code>va_arg</code>, <code>va_copy</code>, or
|
|
<code>va_end</code> macro must happen after calling <code>va_start</code> and
|
|
before calling <code>va_end</code>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <stdarg.h>
|
|
|
|
void test(int x, ...) {
|
|
va_list args;
|
|
int y = va_arg(args, int); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <stdarg.h>
|
|
|
|
void test(int x, ...) {
|
|
va_list args;
|
|
va_start(args, x);
|
|
va_end(args);
|
|
int z = va_arg(args, int); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"><a href="http://llvm.org/bugs/show_bug.cgi?id=16812">
|
|
PR16811</a></td></tr>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
valist.Unterminated</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Every <code>va_start</code> must be matched by a <code>va_end</code>. A va_list
|
|
can only be ended once.
|
|
|
|
<i>This should be folded into the generalized "ownership checker"
|
|
described on the <a href="open_projects.html">
|
|
Open Projects</a> page.</i></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <stdarg.h>
|
|
|
|
void test(int x, ...) {
|
|
va_list args;
|
|
va_start(args, x);
|
|
int y = x + va_arg(args, int);
|
|
} // warn: missing va_end
|
|
</pre></div></div></td>
|
|
<td class="aligned"><a href="http://llvm.org/bugs/show_bug.cgi?id=16812">
|
|
PR16812</a></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ============================== exceptions ============================= -->
|
|
<h3>exceptions</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
exceptions.ThrowSpecButNotThrow</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Function declaration has a <code>throw(<i>type</i>)</code> specifier but the
|
|
function do not throw exceptions.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() throw(int) {
|
|
} // warn
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
exceptions.NoThrowSpecButThrows</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
An exception is throw from a function having a <code>throw()</code>
|
|
specifier.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() throw() {
|
|
throw(1); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
exceptions.ThrownTypeDiffersSpec</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
The type of a thrown exception differs from those specified in
|
|
a <code>throw(<i>type</i>)</code> specifier.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
struct S{};
|
|
|
|
void test() throw(int) {
|
|
S s;
|
|
throw (s); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ========================= smart pointers ============================== -->
|
|
<h3>smart pointers</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
smartptr.SmartPtrInit</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
C++03: <code>auto_ptr</code> should store a pointer to an object obtained via
|
|
new as allocated memory will be cleaned using <code>delete</code>.<br>
|
|
C++11: one should use <code>unique_ptr<<i>type</i>[]></code> to keep a
|
|
pointer to memory allocated by <code>new[]</code>.<br>
|
|
C++11: to keep a pointer to memory allocated by <code>new[]</code> in
|
|
a <code>shared_ptr</code> one should use a custom deleter that calls <code>
|
|
delete[].</code>.
|
|
<p>Source: C++03 20.4.5p1; C++11 <code>auto_ptr</code> is deprecated (D.10).</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <stdlib.h>
|
|
#include <memory>
|
|
|
|
void test() {
|
|
std::auto_ptr<int> p1(new int); // Ok
|
|
std::auto_ptr<int> p2(new int[3]); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <stdlib.h>
|
|
#include <memory>
|
|
|
|
void test() {
|
|
std::auto_ptr<int> p((int *)malloc(sizeof(int))); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ============================== dead code ============================== -->
|
|
<h3>dead code</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
deadcode.UnmodifiedVariable</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
A variable is never modified but was not declared const and is not a
|
|
reference.<br><br><i>(opt-in checker)</i></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
extern int computeDelta();
|
|
|
|
int test(bool cond) {
|
|
int i = 0;
|
|
if (cond) {
|
|
const int delta = computeDelta();
|
|
// warn: forgot to modify 'i'
|
|
}
|
|
return i;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"><a href="http://llvm.org/bugs/show_bug.cgi?id=16890">PR16890</a></td></tr>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
deadcode.IdempotentOperations</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Warn about idempotent operations.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int x = 7;
|
|
x = x; // warn: value is always the same
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int x = 7;
|
|
x /= x; // warn: value is always 1
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int x = 7, one = 1;
|
|
x *= one; // warn: right op is always 1
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int x = 7, zero = 0;
|
|
x = x - zero;
|
|
// warn: the right operand to '-' is always 0
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned">removed from alpha.deadcode.* at r198476</td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ================================ POSIX ================================ -->
|
|
<h3>POSIX</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
posix.Errno</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Record that <code>errno</code> is non-zero when certain functions
|
|
fail.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <stdlib.h>
|
|
|
|
int readWrapper(int fd, int *count) {
|
|
int lcount = read(fd, globalBuf, sizeof(globalBuf));
|
|
if (lcount < 0)
|
|
return errno;
|
|
*count = lcount;
|
|
return 0;
|
|
}
|
|
|
|
void use(int fd) {
|
|
int count;
|
|
if (!readWrapper(fd, &count))
|
|
print("%d", count); // should not warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"><a href="http://llvm.org/bugs/show_bug.cgi?id=18701">PR18701</a></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ========================= undefined behavior ========================== -->
|
|
<h3>undefined behavior</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ExitInDtor</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: <code>std::exit()</code> is called to end the program during
|
|
the destruction of an object with static storage duration.
|
|
<p>Source: C++11 3.6.1p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <cstdlib>
|
|
|
|
class A {
|
|
public:
|
|
~A() {
|
|
std::exit(1); // warn
|
|
}
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.LocalStaticDestroyed</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: function containing a definition of static local object is
|
|
called during the destruction of an object with static storage duration so that
|
|
flow of control passes through the definition of the previously destroyed
|
|
static local object.
|
|
<p>Source: C++11 3.6.3p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void f();
|
|
|
|
class A {
|
|
public:
|
|
~A() {
|
|
f(); // warn
|
|
}
|
|
};
|
|
|
|
class B {};
|
|
|
|
A a;
|
|
|
|
void f() {
|
|
static B b;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ZeroAllocDereference</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
The effect of dereferencing a pointer returned as a request for zero size is
|
|
undefined.<br>
|
|
Note: possibly an enhancement to <span class="name">
|
|
unix.Malloc</span>.
|
|
<p>Source: C++03 3.7.3.1p2; C++11 3.7.4.1p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <stdlib.h>
|
|
|
|
void test() {
|
|
int *p = (int *)malloc(0);
|
|
*p = 1; // warn
|
|
free(p);
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void f(int);
|
|
|
|
void test() {
|
|
int *p = new int[0];
|
|
f(*p); // warn
|
|
delete[] p;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"><a href="http://reviews.llvm.org/D8273">D8273</a></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.DeadReferenced</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the following usage of the pointer to the object whose
|
|
lifetime has ended can result in undefined behavior:<br>
|
|
The object will be or was of a class type with a non-trivial destructor and
|
|
<ul><li>the pointer is used as the operand of a delete-expression</li></ul>
|
|
The object will be or was of a non-POD class type (C++11: any class type) and
|
|
<ul><li>the pointer is used to access a non-static data member or call a
|
|
non-static member function of the object</li>
|
|
<li>the pointer is implicitly converted to a pointer to a base class
|
|
type</li>
|
|
<li>the pointer is used as the operand of a <code>static_cast</code> (except
|
|
when the conversion is to <code>void*</code>, or to <code>void*</code> and
|
|
subsequently to <code>char*</code>, or <code>unsigned char*</code>)</li>
|
|
<li>the pointer is used as the operand of a <code>dynamic_cast</code></li></ul>
|
|
<p>Source: C++03 3.8p5, p7; C++11 3.8p5, p7.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {
|
|
public:
|
|
~A();
|
|
};
|
|
|
|
class B : public A {};
|
|
|
|
void test() {
|
|
A *a = new A;
|
|
new(a) B;
|
|
delete a; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {
|
|
public:
|
|
~A();
|
|
};
|
|
|
|
class B {};
|
|
|
|
void test() {
|
|
A *a = new A;
|
|
new(a) B;
|
|
a->~A();
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {
|
|
public:
|
|
~A();
|
|
};
|
|
|
|
class B : public A {};
|
|
|
|
class C {};
|
|
|
|
void f(A*);
|
|
|
|
void test() {
|
|
B *b = new B;
|
|
new(b) C;
|
|
f(b); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {
|
|
public:
|
|
~A();
|
|
};
|
|
|
|
class B : public A {};
|
|
|
|
class C {};
|
|
|
|
A* test() {
|
|
B *b = new B;
|
|
new(b) C;
|
|
return static_cast<A*>(b); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {
|
|
public:
|
|
~A();
|
|
};
|
|
|
|
class B : public A {};
|
|
|
|
class C {};
|
|
|
|
A* test() {
|
|
B *b = new B;
|
|
new(b) C;
|
|
return dynamic_cast<A*>(b); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ObjLocChanges</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the program must ensure that an object occupies the same
|
|
storage location when the implicit or explicit destructor call takes place.
|
|
<p>Source: C++11 3.8p8.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {};
|
|
|
|
class B {
|
|
public:
|
|
~B();
|
|
};
|
|
|
|
void test() {
|
|
B b;
|
|
new (&b) A;
|
|
} // warn
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <new>
|
|
|
|
class A {};
|
|
|
|
class B {
|
|
public:
|
|
~B();
|
|
};
|
|
|
|
void test() {
|
|
B *b = new B;
|
|
new (b) A;
|
|
delete b; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ExprEvalOrderUndef</span><span class="lang">
|
|
(C, C++03)</span><div class="descr">
|
|
Undefined behavior: a scalar object shall have its stored value modified at
|
|
most once by the evaluation of an expression.<br>
|
|
Note: most cases are currently handled by the Clang core (search for 'multiple
|
|
unsequenced modifications' warning in Clang tests).
|
|
<p>Source: C++03 5p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
int test () {
|
|
int i = 0;
|
|
i = ++i + 1; // warn
|
|
return i;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.StaticInitReentered</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: static declaration is re-entered while the object is being
|
|
initialized.
|
|
<p>Source: C++11 6.7p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
int test(int i) {
|
|
static int s = test(2 * i); // warn
|
|
return i + 1;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ConstModified</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Undefined behavior: const object is being modified.
|
|
<p>Source: C++03 7.1.5.1p4, C++11 7.1.6.1p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
const int *cp = new const int (0);
|
|
int *p = const_cast<int *>(cp);
|
|
*p = 1; // warn
|
|
delete p;
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
class C {
|
|
public :
|
|
int i;
|
|
C();
|
|
};
|
|
|
|
void test() {
|
|
const C cb;
|
|
|
|
C* cp = const_cast<C *>(&cb);
|
|
cp->i = 1; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.DeadDestructed</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the destructor is invoked for an object whose lifetime
|
|
has ended.
|
|
<p>Source: C++11 12.4p14.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {
|
|
public:
|
|
void f();
|
|
A();
|
|
~A();
|
|
};
|
|
|
|
void test() {
|
|
A a;
|
|
a.~A();
|
|
} // warn
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.MethodCallBeforeBaseInit</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: calls member function but base not yet initialized.
|
|
<p>Source: C++03 12.6.2p8; C++11 12.6.2p13.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {
|
|
public :
|
|
A(int);
|
|
};
|
|
|
|
class B : public A {
|
|
public :
|
|
int f();
|
|
B() : A(f()) {} // warn
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.MemberOrBaseRefBeforeCtor</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
C++ Undefined behavior: non-static member or base class of non-POD class type
|
|
is referred before constructor begins execution.<br>
|
|
C++11 Undefined behavior: non-static member or base class of a class with a
|
|
non-trivial constructor is referred before constructor begins execution.
|
|
<p>Source: C++03 12.7p1; C++11 12.7p1.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
struct non_POD {
|
|
int i;
|
|
non_POD();
|
|
};
|
|
|
|
extern non_POD non_pod;
|
|
|
|
int *p = &non_pod.i; // warn
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
struct POD {
|
|
int i;
|
|
};
|
|
|
|
struct non_POD : public POD {
|
|
POD pod;
|
|
};
|
|
|
|
extern non_POD non_pod;
|
|
|
|
int *p = &non_pod.pod.i; // warn
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
struct POD {
|
|
int i;
|
|
};
|
|
|
|
struct non_POD : public POD {};
|
|
|
|
extern non_POD non_pod;
|
|
|
|
POD *p = &non_pod; // warn
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
struct non_POD {
|
|
int i;
|
|
non_POD();
|
|
};
|
|
|
|
struct S {
|
|
int *k;
|
|
non_POD non_pod;
|
|
S() : k(&non_pod.i) {} // warn
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.MemberRefAfterDtor</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
C++03: Undefined behavior: non-static member of non-POD class type is referred
|
|
after destructor ends execution.<br>
|
|
C++11: Undefined behavior: non-static member of a class with a non-trivial
|
|
destructor is referred after destructor ends execution.
|
|
<p>Source: C++03 12.7p1; C++11 12.7p1.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class C {
|
|
public:
|
|
C();
|
|
void f();
|
|
};
|
|
|
|
void test() {
|
|
C *c = new C();
|
|
c->~C();
|
|
c->f(); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.CtorForeignCall</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: call to virtual function of an object under construction
|
|
whose type is neither the constructors own class or one of its bases.
|
|
<p>Source: C++11 12.7p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {
|
|
public:
|
|
virtual void f() {};
|
|
};
|
|
|
|
class B {
|
|
public:
|
|
B(A* a) { a->f(); } // warn
|
|
};
|
|
|
|
class C : public A, B {
|
|
public:
|
|
C() : B((A*)this) {}
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.CtorForeignTypeid</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the operand of <code>typeid</code> is an object under
|
|
construction whose type is neither the constructors own class or one of its
|
|
bases.
|
|
<p>Source: C++11 12.7p5.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <typeinfo>
|
|
|
|
class A {};
|
|
|
|
class B {
|
|
public:
|
|
B(A* a) {
|
|
(void)typeid(*a); // warn
|
|
}
|
|
};
|
|
|
|
class C : public A, B {
|
|
public:
|
|
C() : B((A*)this) {}
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.CtorForeignCast</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the operand of <code>dynamic_cast</code> is an object under
|
|
construction whose type is neither the constructors own class or one of its
|
|
bases.
|
|
<p>Source: C++11 12.7p6.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <typeinfo>
|
|
|
|
class A {
|
|
public:
|
|
virtual void f() {};
|
|
};
|
|
|
|
class B {
|
|
public:
|
|
B(A* a) {
|
|
(void)dynamic_cast<B*>(a); //warn
|
|
}
|
|
};
|
|
|
|
class C : public A, B {
|
|
public:
|
|
C() : B((A*)this) {}
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.MemberOrBaseRefInCatch</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: referring to any non-static member or base class of an
|
|
object in the handler for a function-try-block of a constructor or destructor
|
|
for that object results in undefined behavior.
|
|
<p>Source: C++11 15.3p10.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void f() { throw 1; }
|
|
|
|
class C {
|
|
int i;
|
|
public :
|
|
C()
|
|
try {
|
|
f();
|
|
}
|
|
catch (...) {
|
|
i=2; // warn
|
|
}
|
|
};
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void f() { throw 1; }
|
|
|
|
class Base {
|
|
public:
|
|
int i;
|
|
};
|
|
|
|
class C: public Base {
|
|
public :
|
|
~C() try {
|
|
f();
|
|
}
|
|
catch (...) {
|
|
i=2; // warn
|
|
}
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ReturnAtCatchEnd</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: a function returns when control reaches the end of a
|
|
handler. This results in undefined behavior in a value-returning function.
|
|
<p>Source: C++11 15.3p10.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void f() { throw 1; }
|
|
|
|
int test() try {
|
|
f();
|
|
return 1;
|
|
}
|
|
catch(int) {
|
|
} // warn
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.AutoptrsOwnSameObj</span><span class="lang">
|
|
(C++03)</span><div class="descr">
|
|
Undefined behavior: if more than one <code>auto_ptr</code> owns the same object
|
|
at the same time the behavior of the program is undefined.
|
|
<p>Source: C++03 20.4.5p3; C++11 <code>auto_ptr</code> is deprecated
|
|
(D.10).</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <memory>
|
|
|
|
void test() {
|
|
int *data = new int;
|
|
std::auto_ptr<int> p(data);
|
|
std::auto_ptr<int> q(data); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.BasicStringOutOfBound</span><span class="lang">
|
|
(C++03)</span><div class="descr">
|
|
Undefined behavior: out-of-bound <code>basic_string</code> access/modification.
|
|
<br>Note: possibly an enhancement to <span class="name">
|
|
alpha.security.ArrayBoundV2</span>.
|
|
<p>Source: C++03 21.3.4p1; C++11 behavior is defined
|
|
(21.4.5p2).</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <string>
|
|
|
|
void test() {
|
|
std::basic_string<char> s;
|
|
char c = s[10]; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <string>
|
|
|
|
void test() {
|
|
std::basic_string<char> s;
|
|
s[10] = 0; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.EosDereference</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the result of <code>operator*()</code> on an end of a
|
|
stream is undefined.
|
|
<p>Source: C++03 24.5.3p2; C++11 24.6.3p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <vector>
|
|
|
|
int test() {
|
|
std::vector<int> v;
|
|
return *v.end(); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.QsortNonPODNonTrivial</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
C++03: Undefined behavior: the objects in the array passed to qsort are of
|
|
non-POD type.<br>
|
|
C++11: Undefined behavior: the objects in the array passed to qsort are of
|
|
non-trivial type.
|
|
<p>Source: C++03 25.4p4; C++11 25.5p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
// C++03
|
|
#include <cstdlib>
|
|
|
|
|
|
struct non_POD {
|
|
non_POD();
|
|
};
|
|
|
|
non_POD values[] = { non_POD(), non_POD() };
|
|
|
|
int compare(const void *a, const void *b);
|
|
|
|
void test() {
|
|
qsort(values, 2, sizeof(non_POD), compare); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
// C++11
|
|
#include <cstdlib>
|
|
|
|
struct S {};
|
|
|
|
struct trivial_non_POD : public S {
|
|
int i;
|
|
};
|
|
|
|
struct non_trivial {
|
|
int i;
|
|
non_trivial();
|
|
};
|
|
|
|
trivial_non_POD tnp[2];
|
|
non_trivial nt[2];
|
|
|
|
int compare1(const void *a, const void *b);
|
|
|
|
int compare2(const void *a, const void *b);
|
|
|
|
void test() {
|
|
qsort(tnp, 2, sizeof(trivial_non_POD), compare1); // ok
|
|
qsort(nt, 2, sizeof(non_trivial), compare2); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ThrowWhileCopy</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: copy constructor/assignment operator can throw an exception.
|
|
The effects are undefined if an exception is thrown.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class C {
|
|
public:
|
|
int i, j;
|
|
C (const C &c) {
|
|
i = c.i;
|
|
throw 1; // warn
|
|
j = c.j;
|
|
};
|
|
};
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
class C {
|
|
public:
|
|
int i, j;
|
|
C &operator=(const C &c) {
|
|
i = c.i;
|
|
throw 1; // warn
|
|
j = c.j;
|
|
};
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ValarrayArgBound</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: the value of the <code><i>n</i></code> argument passed
|
|
to <code>valarray</code> constructor is greater than the number of values
|
|
pointed to by the first argument (source).
|
|
<p>Source: C++03 26.3.2.1p4; C++11 26.6.2.2p4.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <valarray>
|
|
|
|
struct S {
|
|
int i;
|
|
S(int ii) : i(ii) {};
|
|
};
|
|
|
|
void test(void) {
|
|
S s[] = { S(1), S(2) };
|
|
std::valarray<S> v(s,3); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ValarrayLengthDiffer</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: <code>valarray</code> operands are of different length.
|
|
<p>Source: C++03 26.3.2.2p1, 26.3.2.6p3, 26.3.3.1p3, 26.3.3.2p3;
|
|
C++11 defined (26.6.2.3p1), 26.6.2.7p3, 26.6.3.1p3,
|
|
26.6.3.2p3.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
// C++03
|
|
#include <valarray>
|
|
|
|
void test(void) {
|
|
std::valarray<int> a(0, 1), b(0, 2);
|
|
a = b; // warn
|
|
b.resize(1);
|
|
a = b; // ok
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
// C++03, C++11
|
|
#include <valarray>
|
|
|
|
void test(void) {
|
|
std::valarray<int> a(0, 1), b(0, 2);
|
|
a *= b; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
// C++03, C++11
|
|
#include <valarray>
|
|
|
|
void test(void) {
|
|
std::valarray<int> a(0, 1), b(0, 2);
|
|
a = a + b; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
// C++03, C++11
|
|
#include <valarray>
|
|
|
|
void test(void) {
|
|
std::valarray<int> a(0, 1), b(0, 2);
|
|
std::valarray<bool> c(false, 1);
|
|
c = a == b; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ValarrayZeroLength</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: calling <code>sum()</code>/<code>min()</code>/<code>
|
|
max()</code> methods of a zero length <code>valarray<code> the behavior is
|
|
undefined.
|
|
<p>Source: C++03 26.3.2.7p2, p3, p4; C++11 26.6.2.8p5, p6,
|
|
p7.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <valarray>
|
|
|
|
void test(void) {
|
|
std::valarray<int> v(0, 0);
|
|
v.sum(); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.ValarrayBadIndirection</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: element is specified more than once in an indirection.
|
|
<p>Source: C++03 26.3.9.2p2, 26.3.9.3p2; C++11 26.6.9.2p2,
|
|
26.6.9.3p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <valarray>
|
|
|
|
void test() {
|
|
// '1' is specified more then once
|
|
size_t addr[] = {0, 1, 1};
|
|
std::valarray<size_t>indirect(addr, 3);
|
|
std::valarray<int> a(0, 5), b(1, 3);
|
|
a[indirect] = b; //warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <valarray>
|
|
|
|
void test() {
|
|
// '1' is specified more then once
|
|
size_t addr[] = {0, 1, 1};
|
|
std::valarray<size_t>indirect(addr, 3);
|
|
std::valarray<int> a(0, 5), b(1, 3);
|
|
a[indirect] *= b; //warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.IosBaseDestroyedBeforeInit</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: <code>ios_base</code> object is destroyed before
|
|
initialization have taken place. <code>basic_ios::init</code> should be call to
|
|
initialize <code>ios_base</code> members.
|
|
<p>Source: C++03 27.4.2.7p1, 27.4.4.1p2; C++11 27.5.3.7p1,
|
|
27.5.5.2p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <ios>
|
|
|
|
using namespace std;
|
|
template <class T, class Traits = std::char_traits<T> >
|
|
class my_stream1 : public std::basic_ios<T, Traits> {
|
|
};
|
|
|
|
template <class T, class Traits = std::char_traits<T> >
|
|
class my_stream2 : public std::basic_ios<T, Traits> {
|
|
class my_streambuf
|
|
: public std::basic_streambuf<T, Traits> {
|
|
};
|
|
public:
|
|
my_stream2() {
|
|
this->init(new my_streambuf);
|
|
}
|
|
};
|
|
|
|
void test() {
|
|
my_stream1<char> *p1 = new my_stream1<char>;
|
|
my_stream2<char> *p2 = new my_stream2<char>;
|
|
delete p1; // warn
|
|
delete p2; // ok
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.IosBaseUsedBeforeInit</span><span class="lang">
|
|
(C++11)</span><div class="descr">
|
|
Undefined behavior: <code>ios_base</code> object is used before initialization
|
|
have taken place. <code>basic_ios::init</code> should be call to
|
|
initialize <code>ios_base</code> members.
|
|
<p>Source: C++11 27.5.3.7p1, 27.5.5.2p2.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <ios>
|
|
|
|
using namespace std;
|
|
template <class T, class Traits = std::char_traits<T> >
|
|
class my_stream1 : public std::basic_ios<T, Traits> {
|
|
};
|
|
|
|
template <class T, class Traits = std::char_traits<T> >
|
|
class my_stream2 : public std::basic_ios<T, Traits> {
|
|
class my_streambuf
|
|
: public std::basic_streambuf<T, Traits> {
|
|
};
|
|
public:
|
|
my_stream2() {
|
|
this->init(new my_streambuf);
|
|
}
|
|
};
|
|
|
|
void test() {
|
|
my_stream1<char> *p1 = new my_stream1<char>;
|
|
my_stream2<char> *p2 = new my_stream2<char>;
|
|
p1->narrow('a', 'b'); // warn
|
|
p2->narrow('a', 'b'); // ok
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
undefbehavior.MinusOnePosType</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Undefined behavior: passing -1 to any <code>streambuf</code>/<code>
|
|
istream</code>/<code>ostream</code> member that accepts a value of
|
|
type <code>traits::pos_type</code> result in undefined behavior.
|
|
<p>Source: C++03 27.4.3.2p3; C++11 27.5.4.2p3.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <fstream>
|
|
|
|
class my_streambuf : public std::streambuf {
|
|
void f() {
|
|
seekpos(-1); // warn
|
|
}
|
|
};
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <fstream>
|
|
|
|
void test() {
|
|
std::filebuf fb;
|
|
std::istream in(&fb);
|
|
std::filebuf::off_type pos(-1);
|
|
in.seekg(pos); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ============================ different ================================ -->
|
|
<h3>different</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr>
|
|
</thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.SuccessiveAssign</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Successive assign to a variable.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
int test() {
|
|
int i;
|
|
i=1;
|
|
i=2; // warn
|
|
return i;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.NullDerefStmtOrder</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Dereferencing of the null pointer might take place. Checking the pointer for
|
|
null should be performed first.
|
|
<br>Note: possibly an enhancement to <span class="name">
|
|
core.NullDereference</span>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
struct S {
|
|
int x;
|
|
};
|
|
|
|
struct S* f();
|
|
|
|
void test() {
|
|
struct S *p1 = f();
|
|
int x1 = p1->x; // warn
|
|
if (p1) {};
|
|
|
|
struct S *p2 = f();
|
|
int x2 = p2->x; // ok
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.NullDerefCondOrder</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Dereferencing of the null pointer might take place. Checking the pointer for
|
|
null should be performed first.
|
|
<br>Note: possibly an enhancement to <span class="name">
|
|
core.NullDereference</span>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
struct S {int i;};
|
|
|
|
struct S* f();
|
|
|
|
void test() {
|
|
struct S *p = f();
|
|
if (p->i && p) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.MultipleAccessors</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Identical accessor bodies. Possibly a misprint.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {
|
|
int i;
|
|
int j;
|
|
public:
|
|
int getI() { return i; }
|
|
int getJ() { return i; } // warn
|
|
};
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
class A {
|
|
int i;
|
|
int j;
|
|
public:
|
|
void setI(int& ii) { i = ii; }
|
|
void setJ(int& jj) { i = jj; } // warn
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.AccessorsForPublic</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Accessors exist for a public class field. Should this field really be
|
|
public?</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class A {
|
|
public:
|
|
int i; // warn
|
|
int getI() { return i; }
|
|
void setI(int& ii) { i = ii; }
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.LibFuncResultUnised</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Calling a function ignoring its return value is of no use (create the list of
|
|
known system/library/API functions falling into this category).</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <vector>
|
|
|
|
void test() {
|
|
std::vector<int> v;
|
|
v.empty(); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.WrongVarForStmt</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Wrong variable is possibly used in the loop/cond-expression of
|
|
the <code>for</code> statement. Did you mean
|
|
'proper_variable_name'?</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int i = 0;
|
|
int j = 0;
|
|
for (i = 0; i < 3; j += 1); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int i = 0;
|
|
int j = 0;
|
|
for (int j = 0; i < 3; ++j); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.FloatingCompare</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Comparing floating point numbers may be not precise.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <math.h>
|
|
|
|
double test() {
|
|
double b = sin(M_PI / 6.0);
|
|
if (b == 0.5) // warn
|
|
b = 0;
|
|
return b;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.BitwiseOpBoolArg</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Boolean value met at the left/right part of the bitwise <code>&</code>
|
|
or <code>|</code> operator.
|
|
Did you mean <code>&&</code> (<code>||</code>) ?</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
int f();
|
|
|
|
void test() {
|
|
bool b = true;
|
|
if (b & f()) {} // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.LabelInsideSwitch</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Possibly a misprint: label found inside a <code>switch()</code>
|
|
statement.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test(int c) {
|
|
switch(c){
|
|
case 1:
|
|
c += 1; break;
|
|
defalt: // warn (did you mean 'default'?)
|
|
c -= 1; break;
|
|
}
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.IdenticalCondIfIf</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
The conditions of two subsequent <code>if</code> statements are
|
|
identical.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
int test(int c) {
|
|
if (c > 5)
|
|
c += 1;
|
|
if (c > 5) // warn
|
|
c -= 1;
|
|
return c;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.LogicalOpUselessArg</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
The second operand of a <code>&&</code> operator has no impact on
|
|
expression result.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test(unsigned a) {
|
|
if (a<7 && a<10) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.SameResLogicalExpr</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
An expression is always evaluated to true/false.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int i = 0;
|
|
if (i != 0) {}; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test(int i) {
|
|
if (i == 0 && i == 1) {}; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test(int i) {
|
|
if (i < 0 || i >= 0) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.OpPrecedenceAssignCmp</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Comparison operation has higher precedence then assignment. Boolean value is
|
|
assigned to a variable of other type. Parenthesis may bee required around an
|
|
assignment.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
int f();
|
|
|
|
void test(int x, int y) {
|
|
bool b;
|
|
if((b = x != y)) {} // ok
|
|
if((x = f() != y)) {} // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.OpPrecedenceIifShift</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
<code>?:</code> has lower precedence then <code><<</code>.
|
|
<p>Source: Stephen C. Dewhurst "C++ Gotchas: Avoiding Common Problems in Coding
|
|
and Design", advise 15.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <iostream>
|
|
|
|
void test(int a) {
|
|
std::cout << a ? "a" : "b"; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void test(int a) {
|
|
a << a > 7 ? 1 : 2; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.ObjectUnused</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
The object was created but is not being used.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
struct S {
|
|
int x, y;
|
|
S(int xx, int yy) : x(xx), y(yy) {}
|
|
S(int xx) {
|
|
S(xx, 0); // warn
|
|
}
|
|
};
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <exception>
|
|
|
|
void test() {
|
|
std::exception();
|
|
// warn (did you mean 'throw std::exception()'?)
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.StaticArrayPtrCompare</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Pointer to static array is being compared to NULL. May the subscripting is
|
|
missing.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int a[1][1];
|
|
if (a[0] == 0) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.ConversionToBool</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Odd implicit conversion to boolean.
|
|
<br>Note: possibly merge with <span class="name">
|
|
alpha.core.BoolAssignment</span>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
bool test() {
|
|
return 1.; // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
bool test() {
|
|
return ""; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.ArrayBound</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Out-of-bound dynamic array access.
|
|
<br>Note: possibly an enhancement to <span class="name">
|
|
alpha.security.ArrayBoundV2</span>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test() {
|
|
int *p = new int[1];
|
|
int i = 1;
|
|
if(p[i]) {}; // warn
|
|
delete[] p;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.StrcpyInputSize</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Buffer copy without checking the size of input.
|
|
<br>Note: possibly an enhancement to <span class="name">
|
|
alpha.unix.cstring.OutOfBounds</span>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
void test(char* string) {
|
|
char buf[24];
|
|
strcpy(buf, string); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.IntegerOverflow</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Integer overflow.
|
|
<br>Note: partially handled by Clang core
|
|
(search for 'overflow in expression' warning in Clang tests).
|
|
<p>Source: <a href="http://cwe.mitre.org/data/definitions/190.html">
|
|
CWE-190</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <limits.h>
|
|
|
|
int f(int x);
|
|
|
|
void test() {
|
|
f(INT_MAX + 1); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
#include <limits.h>
|
|
|
|
int test() {
|
|
int x = INT_MAX / 2 + 1;
|
|
return x * 2; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.SignExtension</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Unexpected sign extension might take place.
|
|
<p>Source: <a href="http://cwe.mitre.org/data/definitions/194.html">
|
|
CWE-194</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
unsigned long long test(long long sll) {
|
|
unsigned long long ull = sll; // warn
|
|
return ull;
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void f(unsigned int i);
|
|
|
|
void test(int si) {
|
|
f(si); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
unsigned int test(int i) {
|
|
return i;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.NumericTruncation</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Numeric truncation might take place.
|
|
<p>Source: <a href="http://cwe.mitre.org/data/definitions/197.html">
|
|
CWE-197</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
unsigned long test(unsigned long long ull) {
|
|
unsigned long ul = ull; // warn
|
|
return ul;
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
void f(int i);
|
|
|
|
void test(long long sll) {
|
|
f(sll); // warn
|
|
}
|
|
</pre></div>
|
|
<div class="example"><pre>
|
|
int f();
|
|
|
|
short test(long long sll) {
|
|
short ss = f();
|
|
return ss;
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
different.MissingCopyCtorAssignOp</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
A class has dynamically allocated data members but do not define a copy
|
|
constructor/assignment operator.
|
|
<p>Source: Scott Meyers "Effective C++", item 11: Prevent exceptions from
|
|
leaving destructors.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
class C {
|
|
int *p; // warn
|
|
public:
|
|
C() { p = new int; }
|
|
~C() { delete p; }
|
|
};
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
</table>
|
|
|
|
<!-- ============================ WinAPI =================================== -->
|
|
<h3>WinAPI</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
WinAPI.CreateProcess</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
<code>CreateProcess()</code>: if the first parameter <code><i>
|
|
lpApplicationName</i></code> is NULL then the executable name must be in the
|
|
white space-delimited string pointed to by <code><i>lpCommandLine</code></i>.
|
|
If the executable or path name has a space in it, there is a risk that a
|
|
different executable could be run because of the way the function parses
|
|
spaces.
|
|
<p>Source: <a href="http://msdn.microsoft.com/en-us/library/windows/desktop/ms682425%28v=vs.85%29.aspx">
|
|
MSDN: CreateProcess function, Security Remarks</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <windows.h>
|
|
|
|
void test() {
|
|
STARTUPINFO si;
|
|
PROCESS_INFORMATION pi;
|
|
CreateProcess(NULL, TEXT("C:\\Program Files\\App -L -S"),
|
|
NULL, NULL, TRUE, 0, NULL, NULL, &si, &pi);
|
|
// warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
WinAPI.LoadLibrary</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
The <code>SearchPath()</code> function is used to retrieve a path to a DLL for
|
|
a subsequent <code>LoadLibrary()</code> call.
|
|
<p>Source: <a href="http://msdn.microsoft.com/en-us/library/windows/desktop/ms684175%28v=vs.85%29.aspx">
|
|
MSDN: LoadLibrary function, Security Remarks</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <windows.h>
|
|
|
|
HINSTANCE test() {
|
|
char filePath[100];
|
|
SearchPath(NULL, "file.dll", NULL, 100, filePath, NULL);
|
|
return LoadLibrary(filePath); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
WinAPI.WideCharToMultiByte</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Buffer overrun while calling <code>WideCharToMultiByte()</code>. The size of
|
|
the input buffer equals the number of characters in the Unicode string, while
|
|
the size of the output buffer equals the number of bytes.
|
|
<p>Source: <a href="http://msdn.microsoft.com/en-us/library/windows/desktop/dd374130%28v=vs.85%29.aspx">
|
|
MSDN: WideCharToMultiByte function</a>.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <windows.h>
|
|
|
|
void test() {
|
|
wchar_t ws[] = L"abc";
|
|
char s[3];
|
|
WideCharToMultiByte(CP_UTF8, 0, ws, -1, s,
|
|
3, NULL, NULL); // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
</table>
|
|
|
|
<!-- =========================== optimization ============================== -->
|
|
<h3>optimization</h3>
|
|
<table class="checkers">
|
|
<col class="namedescr"><col class="example"><col class="progress">
|
|
<thead><tr><td>Name, Description</td><td>Example</td><td>Progress</td></tr></thead>
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
optimization.PassConstObjByValue</span><span class="lang">
|
|
(C, C++)</span><div class="descr">
|
|
Optimization: It is more effective to pass constant parameter by reference to
|
|
avoid unnecessary object copying.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
struct A {};
|
|
|
|
void f(const struct A a); // warn
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
optimization.PostfixIncIter</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Optimization: It is more effective to use prefix increment operator with
|
|
iterator.
|
|
<p>Source: Scott Meyers "More Effective C++", item 6:
|
|
Distinguish between prefix and postfix forms of increment and decrement
|
|
operators.</p></div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <vector>
|
|
|
|
void test() {
|
|
std::vector<int> v;
|
|
std::vector<int>::const_iterator it;
|
|
for(it = v.begin();
|
|
it != v.end(); it++) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
optimization.MultipleCallsStrlen</span><span class="lang">
|
|
(C)</span><div class="descr">
|
|
Optimization: multiple calls to <code>strlen()</code> for a string in an
|
|
expression. It is more effective to hold a value returned
|
|
from <code>strlen()</code> in a temporary variable.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <string.h>
|
|
|
|
void test(const char* s) {
|
|
if (strlen(s) > 0 &&
|
|
strlen(s) < 7) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
optimization.StrLengthCalculation</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Optimization: it is more efficient to use <code>string::length()</code> to
|
|
calculate the length of an <code>std::string</code>.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <string>
|
|
#include <string.h>
|
|
|
|
void test() {
|
|
std::string s;
|
|
if (strlen(s.c_str()) != 0) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
<tr><td><div class="namedescr expandable"><span class="name">
|
|
optimization.EmptyContainerDetect</span><span class="lang">
|
|
(C++)</span><div class="descr">
|
|
Optimization: It is more efficient to use containers <code>empty()</code>
|
|
method to identify an empty container.</div></div></td>
|
|
<td><div class="exampleContainer expandable">
|
|
<div class="example"><pre>
|
|
#include <list>
|
|
|
|
void test() {
|
|
std::list<int> l;
|
|
if (l.size() != 0) {}; // warn
|
|
}
|
|
</pre></div></div></td>
|
|
<td class="aligned"></td></tr>
|
|
|
|
|
|
</table>
|
|
|
|
<br>
|
|
</div> <!-- page -->
|
|
</div> <!-- content -->
|
|
</body>
|
|
</html>
|