dev-notes/C++/C++.md

# C/C++ Cheat Sheet

## Naming convention

C++ element  | Case
-------------|------------
class        | PascalCase
variable     | camelCase
method       | camelCase

## Library Import

`#include <iostream>`  
C++ libs encapsulate C libs.  
A C library can be used with the traditional name `<lib.h>` or with the prefix _**c**_ and without `.h` as `<clib>`.

### Special Operators

Operator   | Operator Name
-----------|----------------------------------------------------
`::`       | global reference operator
`&`        | address operator (returns a memory address)
`*`        | deferentiation operator (returns the pointed value)

### Constant Declaration

```cpp
#define constant_name value
const type constant_name = value;
```

### Console pausing before exit

```cpp
#include <cstdlib>
system("pause");
getchar();    // waits imput from keyboard, if is last instruction will prevent closing console until satisfied
```

### Namespace definition

Can be omitted and replaced by namespce`::`  
`using namespace <namespace>;`

### Main Function

```cpp
int main() {
    //code here
    return 0;
}
```

### Variable Declaration

```cpp
type var_name = value;    //c-like initialization
type var_name (value);    //constructor initialization
type var_name {value};    //uniform initialization
type var_1, var_2, ..., var_n;
```

### Type Casting

`(type) var;`  
`type(var);`

### Variable Types

Type                     | Value Range                       | Byte
-------------------------|-----------------------------------|------
`short`                  | -32768 to 32765                   | 1
`unsigned short`         | 0 to 65535                        | 1
`int`                    | -2147483648 to 2147483647         | 4
`unisgned int`           | 0 to 4294967295                   | 4
`long`                   | -2147483648 to 2147483647         | 4
`unsigned long`          | 0 to 4294967295                   | 4
`long long`              |                                   | 8
`float`                  | +/- 3.4e +/- 38 (~7 digits)       | 4
`double`                 | +/- 1.7e +/- 308 (~15 digits)     | 8
`long double`            |                                   | 16 (?)

Type                     | Value
-------------------------|-----------------------------
`bool`                   | true or false
`char`                   | ascii characters
`string`                 | sequence of ascii characters
`NULL`                   | empty value

### Integer Numerals

Example  | Type
---------|------------------------
`75`     | decimal
`0113`   | octal (zero prefix)
`0x4`    | hexadecimal (0x prefix)
`75`     | int
`75u`    | unsigned int
`75l`    | long
`75ul`   | unsigned long
`75lu`   | unsigned long

### FLOATING POINT NUMERALS

Example     | Type
------------|-------------
`3.14159L`  | long double
`60.22e23f` | flaot

Code      | Value
----------|---------------
`3.14159` | 3.14159
`6.02e23` | 6.022 * 10^23
`1.6e-19` | 1.6 * 10^-19
`3.0`     | 3.0

### Character/String Literals

`'z'` single character literal  
`"text here"` string literal

### Special Characters

Escape Character   | Character
-------------------|-----------------------------
`\n`               | neweline
`\r`               | carriage return
`\t`               | tab
`\v`               | vertical tab
`\b`               | backspace
`\f`               | form feed
`\a`               | alert (beep)
`\'`               | single quote (')
`\"`               | double quote (")
`\?`               | question mark (?)
`\\`               | backslash  (\)
`\0`               | string termination character

### Screen Output

```cpp
cout << expression;    // print line on screen (no automatic newline)
cout << expressin_1 << expreeeion_2;    // concatenation of outputs
cout << expression << "\n";    // print line on screen
cout << expression << endl;    // print line on screen

//Substitutes variable to format specifier
#include <stdio.h>
printf("text %<fmt_spec>", variable);    // has problems, use PRINTF_S
printf_s("text %<fmt_spec>", variable);
```

### Input

```cpp
#iclude <iostream>
cin >> var;    //space terminates value
cin >> var_1 >> var_2;

//if used after cin >> MUST clear buffer with cin.ignore(), cin.sync() or std::ws
getline(stream, string, delimiter)     //read input from stream (usially CIN) and store in in string, a different delimiter character can be set.

#include <stdio.h>
scanf("%<fmt_spec>", &variable);    // has problems, use SCANF_S
scanf_s("%<fmt_spec>", &variable);    //return number of succescully accepted inputs
```

### Fromat Specifiers %[width].[lenght][specifier]

Specifier   | Specified Format
------------|-----------------------------------------
`%d`, `%i`  | singed decimal integer
`%u`        | unsigned decimal integer
`%o`        | unsigned octal
`%x`        | unsigned hexadecimal integer
`%X`        | unsigned hexadecimal integer (UPPERCASE)
`%f`        | decimal floating point (lowercase)
`%F`        | decimal floating point (UPPERCASE)
`%e`        | scientific notation (lowercase)
`%E`        | scientific notation (UPPERCASE)
`%a`        | hexadecimal floating point (lowercase)
`%A`        | hexadecimal floating point (UPPERCASE)
`%c`        | character
`%s`        | string
`%p`        | pointer address

### CIN input validation

```cpp
if (cin.fail()) // if cin fails to get an input
{
    cin.clear();    // reset  cin status (modified by cin.fail() ?)
    cin.ignore(n, '\n');    //remove n characters from budder or until \n

    //error message here
}

if (!(cin >> var)) // if cin fails to get an input
{
    cin.clear();    // reset  cin status (modified by cin.fail() ?)
    cin.ignore(n, '\n');    //remove n characters from budder or until \n

    //error message here
}
```

### Cout Format Specifier

```cpp
#include <iomanip>
cout << stew(print_size) << setprecision(num_digits) << var;    //usage

setbase(base)    //set numberica base [dec, hex, oct]
setw(print_size)    //set the total number of characters to display
setprecision(num_digits)    //sets the number of decimal digits to siaplay
setfill(character)    //use character to fill space between words
```

### Arithmetic Operators

Operator | Operation
---------|---------------
a `+` b  | sum
a `-` b  | subtraction
a `*` b  | multiplication
a `/` b  | division
a `%` b  | modulo
a`++`    | increment
a`--`    | decrement

### Comparison Operators

Operator | Operation
---------|--------------------------
a `==` b | equal to
a `!=` b | not equal to
a `>` b  | greater than
a `<` b  | lesser than
a `>=` b | greater than or equal to
a `<=` b | lesser than or equal to

### Logical Operator

Operator             | Operation
---------------------|-----------------------
`!`a, `not` a        | logical negation (NOT)
a `&&` b, a `and` b  | logical AND
a `||` b, a `or` b   | logical OR

### Conditional Ternary Operator

`condition ? result_1 : result_2`  
If condition is true evaluates to result_1, and otherwise to result_2

### Bitwise Operators

Operator               | Operation
-----------------------|---------------------
`~`a, `compl` a        | bitwise **NOT**
a `&` b, a `bitand` b  | bitwise **AND**
a `|` b, a `bitor` b   | bitwise **OR**
a `^` b, a `xor` b,    | bitwise **XOR**
a `<<` b               | bitwise left shift
a `>>` b               | bitwise right shift

### Compound Assignement O

Operator    | Operation
------------|------------
a `+=` b    | a = a + b
a `-=` b    | a = a - b
a `*=` b    | a = a * b
a `/=` b    | a = a / b
a `%=` b    | a = a % b
a `&=` b    | a = a & b
a `|=` b    | a = a | b
a `^=` b    | a = a ^ b
a `<<=` b   | a = a << b
a `>>=` b   | a = a >> b

### Operator Precedence

1. `!`
2. `*`, `/`, `%`
3. `+`, `-`
4. `<`, `<=`, `<`, `>=`
5. `==`, `!=`
6. `&&`
7. `||`
8. `=`

### Mathematical Functions

```cpp
#include <cmath>
abs(x);    // absolute value
labs(x);    //absolute value if x is long, result is long
fabs(x);    //absolute value if x i float, result is float
sqrt(x);    // square root
ceil(x);    // ceil function (next initeger)
floor(x);    // floor function (integer part of x)
log(x);    // natural log of x
log10(x);    // log base 10 of x
exp(x);    // e^x
pow(x, y);    // x^y
sin(x);
cos(x);
tan(x);
asin(x);    //arcsin(x)
acos(x);    //arccos(x)
atan(x);    //arctan(x)
atan2(x, y);    //arctan(x / y)
sinh(x);    //hyperbolic sin(x)
cosh(x);    //hyperbolic cos(x)
tanh(x);    //hyperbolic tan(X)
```

### Character Classification

```cpp
isalnum(c);    //true if c is alphanumeric
isalpha(c);    //true if c is a letter
isdigit(c);    //true if char is 0 1 2 3 4 5 6 7 8 9
iscntrl(c);    //true id c is DELETE or CONTROL CHARACTER
isascii(c);    //true if c is a valid ASCII character
isprint(c);    //true if c is printable
isgraph(c);    //true id c is printable, SPACE excluded
islower(c);    //true if c is lowercase
isupper(c);    //true if c is uppercase
ispunct(c);    //true if c is punctuation
isspace(c);    //true if c is SPACE
isxdigit(c);    //true if c is HEX DIGIT
```

### Character Functions

```cpp
#include <ctype.n>

tolower(c);    //transfromas charatcer in lowercase
toupper(c);    //transform character in uppercase
```

### Random Numbers Between max-min (int)

```cpp
#include <time>
#include <stdlib.h>
srand(time(NULL));    //initzialize seed
var = rand()   //random number
var = (rand() % max + 1)    //random numbers between 0 & max
var = (rand() % (max - min + 1)) + min    //random numbers between min &  max
```

### Flush Output Buffer

```cpp
#include <stdio.h>
fflush(FILE);    // empty output buffer end write its content on argument passed
```

**Do not use stdin** to empty INPUT buffers. It's undefined C behaviour.  

## STRINGS (objects)

```cpp
#include <string>

string string_name = "string_content";    //string declaration
string string_name = string("strintg_content");    // string creation w/ constructor

string.length    //returns the length of the string

//if used after cin >> MUST clear buffer with cin.ignore(), cin.sync() or std::ws
getline(source, string, delimiter);    //string input, source can be input stream (usually cin)

printf_s("%s", string.c_str());    //print the string as a char array, %s --> char*

string_1 + string_2;    // string concatenation
string[pos]    //returns char at index pos
```

### String Functions

```cpp
string.c_str()    //transfroms the string in pointer to char[] (char array aka C string) ter,iomated by '\0'

strlen(string);    //return lenght (num of chars) of the string
strcat(destination, source);    //appends chars of string2 to string1
strncat(string1, string2, nchar);    //appends the first n chars of string 2 to string1
strcpy(string1, string2.c_str());    //copies string2 into string1 char by char
strncpy(string1, string2, n);    //copy first n chars from string2 to string1
strcmp(string1, string2);    //compares string1 w/ string2
strncmp(string1, string2, n);    //compares first n chars
//returns < 0 if string1 precedes string2
//returns 0 if string1 == string2
// returns > 0 if string1 succedes string2
strchr(string, c);    //returns index of c in string if it exists, NULL otherwise
strstr(string1, string2);    //returns pointer to starting index of string1 in string2
strpbrk(string, charSet);    //Returns a pointer to the first occurrence of any character from strCharSet in str, or a NULL pointer if the two string arguments have no characters in common.
```

### String Conversion

```cpp
atof(string);    //converts string in double if possible
atoi(string);    //converts string in integer if possible
atol(string);    //converts string in long if possible
```

### String Methods

```C++
string.at(pos);    // returns char at index pos
string.substr(start, end);    // returns substring between indexes START and END
string.c_str();    //reads string char by char
string.find(substring);    // The zero-based index of the first character in string object that matches the requested substring or characters
```

## VECTORS

```cpp
#include <vector>
vector<type> vector_name = {values};    //variable length array
```

## Selection Statements

### Simple IF

```cpp
if (condition)
    //single istruction


if (condition) {
    //code here
}
```

### Simple IF-ELSE

```cpp
if (condition) {
    //code here
} else {
    //code here
}
```

## IF-ELSE mutli-branch

```cpp
if (condition) {
    //code here
} else if (condition) {
    //code here
} else {
    //code here
}
```

### Switch

```cpp
switch (expression) {
    case constant_1:
        //code here
        break;

    case constant_2:
        //code here
        break;

    default:
        //code here
}
```

## Loop Statements

### While Loop

```cpp
while (condition) {
    //code here
}
```

### Do While

```cpp
do {
    //code here
} while (condition);
```

### For Loop

```cpp
for (initialization; condition; increase) {
    //code here
}
```

### Range-Based For Loop

```cpp
for (declaration : range) {
    //code here
}
```

### Break Statement

`break;` leaves a loop, even if the condition for its end is not fulfilled.

### Continue Statement

`continue;` causes the program to skip the rest of the loop in the current iteration.

## Functions

Functions **must** be declared **before** the main function.  
It is possible to declare functions **after** the main only if the *prototype* is declared **before** the main.  
To return multiple variables those variables can be passed by reference so that their values is adjourned in the main.

### Function Prototype (before main)

`type function_name(type argument1, ...);`

### Standard Function

```cpp
type functionName (parameters) {    //parametri formali aka arguents
    //code here
    return <expression>;
}
```

### Void Function (aka procedure)

```cpp
void functionName (parameters) {
    //code here
}
```

### Arguments passed by reference without pointers

Passing arguments by reference causes modifications made inside the funtion to be propagated to the values outside.  
Passing arguments by values copies the values to the arguments: changes remain inside the function.  

```cpp
type functionName (type &argument1, ...) {
    //code here
    return <expression>;
}
```

`functionName (arguments);`

### Arguments passed by reference with pointers

Passing arguments by reference causes modifications made inside the funtion to be propagated to the values outside.  
Passing arguments by values copies the values to the arguments: changes remain inside the function.

```cpp
type function_name (type *argument_1, ...) {
    instructions;
    return <expression>;
}
```

`function_name (&argument_1, ...);`

## Arrays

```cpp
type arrayName[dimension];    //array declaration
type arrayName[dimension] = {value1, value2, ...};    //array declaration & inizialization, values number must match dimension

array[index]    //item access, index starts at 0 (zero)
array[index] = value;    //value assignement at position index
```

## String as array of Chars

```cpp
char string[] = "text";    //converts string in char array, string length determines dimesion of the array
string str = string[]    //a array of chars is automatically converted to a string
```

## Array as function parameter

The dimesion is not specified because it is determined by the passed array.  
The array is passed by reference.

```cpp
type function(type array[]){
    //code here
}

//array is not modificable inside the function (READ ONLY)
type function(const type array[]){
    //code here
}

function(array);    //array passed w/out square brackets []
```

### Multi-Dimensional Array (Matrix)

```cpp
type matrix[rows][columns];
matrix[i][j]    //element A_ij of the matrix
```

### Matrix as function parameter

```cpp
//matrix passed by reference, second dimension is mandatory
type function(type matrix[][columns]){
    //code here
};

//martix values READ ONLY
type function(const type matric[][columns]){
    //code here
}

type function(type matrix[][dim2]...[dimN]){
    //code here
}
```

## Record (struct)

List of non omogeneous items

### Struct Definition (before functions, outside main)

```cpp
struct structName {
    type field1;
    type field2;
    type field3;
    type field4;
};

structName variable;    //STRUCT variable
variable.field    //field access
```

## Pointers

Pointers hold memory adresses of declared variables, they should be initialized to NULL.

```cpp
type *pointer = &variable;     //pointer init and assignement
type *pointer = NULL;
type *pointer = otherPointer;
type **pointerToPointer = &pointer;    // pointerToPointer -> pointer -> variable
```

`&variable` extracts the address, the pointer holds the address of the variable.  
pointer type and variable type **must** match.  
(*) --> "value pointed to by"

```cpp
pointer    //addres of pointed value (value of variable)
*pointer    //value of pointed variable
**pointer //value pointed by *pointer (pointer to pointer)
```

### Pointer to array

```cpp
type *pointer;
type array[dim] = {};


pointer = array;    //point to array (pointer points to first "cell" of array)
pointer++;    //change pointed value to successive "cell" of array
```

### Pointers, Arrays & Functions

```cpp
func(array)    //pass entire array to function (no need to use (&) to extract address)

type func(type* array){
    array[index]    //acces to item of array at index
}
```

### Pointer to Struct

```cpp
(*structPointer).field    //acces to field value
structPointer->structField    //acces to field value
```

## Dynamic Structures

Dynamic structures are structures without a fixed number of items.  

Every item in a dynamic structure is called **node**.  
Every node is composed by two parts:

* the value (item)
* pointer to successive node

**Lists** are *linear* dinamyc structures in which is only defined the preceding and succeding item. A List is a group of homogeneous items (all of the same type).  

**Trees**, **Graphs** are non *linear* dynamic structures in which an item cha have multiple successors.  

### Stack

A **Stack** is a list in with nodes can be extracted from one *side* only (*LIFO*).
The extraction of an item from the *top* is called **pop**

```cpp
// node structure
struct Node {
    type value;
    stack *next;
}
```

#### Node Instertion

```cpp
Node *stackNode;    //current node
Node* head = NULL;    //pointer to head of stack

int nodeValue;
//assign value to nodeValue

stackNode = new Node;    //create new node

stackNode->value = nodevalue;    //valorize node
stackNode->next = head;    //update node poiter to old head adding it to the stack

head = stackNode;    //update head to point to new first node
```

#### Node Deletion

```cpp
stackNode = head->next;    //memorize location of second node
delete head;    //delete first node
head = stackNode;    //update head to point to new first node
```

#### Passing Head To Functions

```cpp
type function(Node** head)    //value of head passed by address (head is Node*)
{
    *head = ...    //update value of head (pointed variable/object/Node)
}
```

### Queue

A **Queue** is a list in which nodes enter from one side and can be extracted only from the other side (*FIFO*).

### Linked List

A **Linked List** is list in which nodes can be extracted from each side and from inside the linked list.

Linked lists can be *linear*, *circular* or *bidirectional*.  
In circular linked lists the last node points to the first.

Nodes of bidirectional linked lists are composed by three parts:

* the value (item)
* pointer to successive node
* pointer to previous item

Thus the first and last node will have a component empty since they only point to a single node.

### Dynamic Memory Allocation

C/C++ does not automatically free allocated memory when nodes are deleted. It must be done manuallty.  

In **C++**:

* `new` is used to allocate memory dynamically.  
* `delete` is use to free the dinamically allocated memory.

In **C**:

* `malloc()` returns a void pointer if the allocation is successful.
* `free()` frees the memory

```C
list *pointer = (list*)malloc(sizeof(list));    //memory allocation
free(pointer)    //freeing of memory
```

`malloc()` returns a *void pointer* thus the list must be casted to a void type with `(list*)`

## Files

The object oriented approach is based on the use of *streams*.  
A **Stream** can be considered a stream of data that passes sequentially from a source to a destination.

The avaiable classes in C++ to operate on files are:

* `ifstream` for the input (reading)
* `ofstream` for the output (writing)
* `fstream` for input or output

### File Opening

Filename can be string literal or CharArray (use `c_str()`).

```cpp
ifstream file;
file.open("filename");    //read from file

ofstream file;
file.open("filename");    //writo to file


fstream file;
file.open("filename", ios::in);    //read form file
file.open("filename", ios::out);    //write to file
file.open("filename", ios::app);    //append to file
file.open("filename", ios::trunc);    //overwrite file
file.open("filename", ios::nocreate);    //opens file only if it exists, error otherwise. Does not create new file
file.open("filename", ios::noreplace);    //opens file only if it not exists, error otherwise. If it not exists the file is created.
file.open("filename", ios::binary);    //opens file in binary format
```

If file opening fails the stream has value 0, otherwise the value is the assigned memory address.  
Opening modes can be conbined with the OR operator: `ios::mode | ios::mode`.

### File Reading & Writing

To write to and read from a file the `>>` and `<<` operators are used.

```cpp
file.open("filename", ios::in | ios::out);

file << value << endl;    //write to file

string line;
do {
    getline(file, line);    //read file line by line
    //code here
} while (!file.eof());    // or !EOF
```

### Stream state & Input errors

Once a stream is in a **state of error** it will remain so until the status flags are *explicitly resetted*. The input operations on such a stream are *void* until the reset happens.  
To clear the status of a stream the `clear()` method is used.  
Furthermore, when an error on the stream happens **the stream is not cleared** of it's charaters contents.  
To clear the stream contents the `ignore()` method is used.