summaryrefslogtreecommitdiffstats
path: root/clang-tools-extra/docs/clang-tidy/checks/modernize-use-uncaught-exceptions.rst
blob: 615f2e3f4a27fd6e0653f8695879208a5acb5289 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
.. title:: clang-tidy - modernize-use-uncaught-exceptions

modernize-use-uncaught-exceptions
====================================

This check will warn on calls to ``std::uncaught_exception`` and replace them
with calls to ``std::uncaught_exceptions``, since ``std::uncaught_exception``
was deprecated in C++17.

Below are a few examples of what kind of occurrences will be found and what
they will be replaced with.

.. code-block:: c++

	#define MACRO1 std::uncaught_exception
	#define MACRO2 std::uncaught_exception

	int uncaught_exception() {
		return 0;
	}

	int main() {
		int res;

	  res = uncaught_exception();
	  // No warning, since it is not the deprecated function from namespace std
	  
	  res = MACRO2();
	  // Warning, but will not be replaced
	  
	  res = std::uncaught_exception();
	  // Warning and replaced
	  
	  using std::uncaught_exception;
	  // Warning and replaced
	  
	  res = uncaught_exception();
	  // Warning and replaced
	}

After applying the fixes the code will look like the following:

.. code-block:: c++

	#define MACRO1 std::uncaught_exception
	#define MACRO2 std::uncaught_exception

	int uncaught_exception() {
		return 0;
	}

	int main() {
	  int res;
	  
	  res = uncaught_exception();
	  
	  res = MACRO2();
	  
	  res = std::uncaught_exceptions();
	  
	  using std::uncaught_exceptions;
	  
	  res = uncaught_exceptions();
	}
OpenPOWER on IntegriCloud