Differences

This shows you the differences between two versions of the page.

--- guides:software:gcc:start [2020/07/19 13:04] – [Other Arguments] wikiadmin
+++ guides:software:gcc:start [2022/08/02 11:59] (current) – external edit 127.0.0.1
@@ Line 146: / Line 146: @@
 compilation terminated.
 </code>
-==== Producing Additional Warnings ====
-==== Other Arguments ====
 g++ supports many flags.  These include
@@ Line 160: / Line 155: @@
   * Information flags
   * Many others
-===== Multiple File Compilation ======
+On most linux systems //man g++// will show documentation for the flags supported by your version of g++.
+==== Some Useful Arguments ====
+  * //- -version// will display the version of g++ you are using.
+    * <code>
+$ g++ --version
+g++ (GCC) 9.3.1 20200408 (Red Hat 9.3.1-2)
+Copyright (C) 2019 Free Software Foundation, Inc.
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+</code>
+    * In general, you want your version of g++ to be as close to the version of g++ on the homework standard machine specified by your instructor.
+    * If your version is not the same, make sure that you compile your code on the homework standard machine specified by your instructor **before** you submit any code.
+  * //-std// controls the version of the c++ language the compiler will use.
+    * There have been multiple c++ standards over the years, generally named after the year the standard was adopted.
+    * //-std=c++98// supports the 1998 ISO c++ standard
+    * //-std=c++11// supports the 2011 version
+    * //-std=c++14// supports the 2014 version
+    * //-std=c++17// supports the 2017 version
+    * Consider the following code
+      * <code c++>
+#include <iostream>
+using namespace std;
+int main() {
+    string greeting="Hello World!";
+    for(auto & letter: greeting) {
+        cout << letter;
+    }
+    cout << endl;
+    return 0;
+}
+        </code>
+      * It will not compile under c++98
+      * <code>
+$ g++ -std=c++98 auto.cpp
+auto.cpp: In function 'int main()':
+auto.cpp:8:16: error: ISO C++ forbids declaration of 'letter' with no type [-fpermissive]
+|     for(auto & letter: greeting) {
+      |                ^~~~~~
+auto.cpp:8:24: warning: range-based 'for' loops only available with '-std=c++11' or '-std=gnu++11'
+|     for(auto & letter: greeting) {
+      |                        ^~~~~~~~
+auto.cpp:8:24: error: forming reference to reference type 'std::__cxx11::basic_string<char>&'
+        </code>
+      * But it will compile under c++14
+      * <code>
+$ g++ -std=c++14 auto.cpp
+        </code>
+    * There are **many** other standards supported.
+    * You should check with your instructor regarding which version of the compiler you should use.
+==== Producing Additional Warnings ====
+Compilers are also capable of analyzing source code to predict where this code may cause run time errors.    By turning on these warnings you are more likely to write code that conforms to the standard and less likely to have common runtime errors in  your code.
+Your instructor may require one or more of the following flags when compiling code:
+  * //-Wpedantic//
+    * This requests the compiler to follow the ISO C++ standard, rejecting forbidden and non-standard extensions
+  * //-Wall//
+    * Enables MANY different warnings for constructs that are considered questionable.
+  * //-Wextra//
+    * Enables many additional warnings
+  * //-Wmisleading-indentation//
+    * Warn if the indentation of the code does not reflect the block structure.
+  * //-Wunused//
+    * Warn if different declared items are not used
+  * //-Wuninitialized//
+    * Warn about uninitialized variables.
+    * This flag requires //-O**n**// for some variables.
+      * See below.
+  * //-Wshadow//
+    * Warn when shadow variables are declared in a scope
+  * //-Wconversion//
+    * Warn when an implicit conversion may change a value.
+Note:  There are **many** other warning producing flags.
+For the following code:
+<code c++>
+#include <iostream>
+using namespace std;
+int main() {
+    int a,b;
+    int c;
+    if (a = b)
+       cout << " a is 4" << endl;
+       a = 5;
+    return 3.14;
+}
+</code>
+Compiling without additional flags produces no warnings.  But compiling with the listed flags produces
+<code>
+$ g++ bad.cpp
+$ g++ -g -O3 -Wpedantic -Wall -Wextra -Wmisleading-indentation -Wunused -Wuninitialized -Wshadow -Wconversion bad.cpp
+bad.cpp: In function 'int main()':
+bad.cpp:10:11: warning: suggest parentheses around assignment used as truth value [-Wparentheses]
+|     if (a = b)
+      |         ~~^~~
+bad.cpp:10:5: warning: this 'if' clause does not guard... [-Wmisleading-indentation]
+|     if (a = b)
+      |     ^~
+bad.cpp:12:8: note: ...this statement, but the latter is misleadingly indented as if it were guarded by the 'if'
+|        a = 5;
+      |        ^
+bad.cpp:14:12: warning: conversion from 'double' to 'int' changes value from '3.1400000000000001e+0' to '3' [-Wfloat-conversion]
+|     return 3.14;
+      |            ^~~~
+bad.cpp:8:9: warning: unused variable 'c' [-Wunused-variable]
+|     int c;
+      |         ^
+bad.cpp:10:11: warning: 'b' is used uninitialized in this function [-Wuninitialized]
+|     if (a = b)
+      |         ~~^~~
+</code>
+You should use all command line flags specified by your instructor.
+Note: If you wish to avoid typing command line arguments, you may wish to investigate
+  * Makefiles
+  * Command Line History
+==== Other Arguments ====
+Other flags are useful in different situations.
+  * //-g// tells the compiler to retain debugging information.  This is useful when using a //symbolic debugger// such as //gdb//.
+      * This is probably a good option to have enabled.
+  * //-O**n**// tells the compiler to optimize the code.
+      * This may result in a more efficient executable.
+      * **n** is the level of optimization
+      * This is currently an integer between 1 and 3.
+      * Compiling with higher values of n may take longer, but will generally result in a faster executable.