cheat-sheet-rust/README.md

# cheat-sheet-rust

Here is the IO-Project cheat sheet to quickly learn the "Rust" programming language

## Table of Contents

- [cheat-sheet-rust](#cheat-sheet-rust)
  - [Table of Contents](#table-of-contents)
  - [Basics](#basics)
    - [Useful cargo commands](#useful-cargo-commands)
    - [Code comments](#code-comments)
    - [Variables](#variables)
    - [Data types](#data-types)
      - [Scalar types](#scalar-types)
    - [Functions](#functions)

## Basics

> Rust is a systems programming language that runs blazingly fast, prevents segfaults, and guarantees thread safety.
> We will start now by introducing the basic concepts of the Rust language such as variables, loops, functions.

### Useful cargo commands

- `cargo new <project_name>`: Create a new project
- `cargo build`: Build the project
- `cargo run`: Build and run the project
- `cargo check`: Check if the project can be built
- `cargo build --release`: Build the project in release mode
- `cargo update`: Update the dependencies
- `cargo doc --open`: Generate the documentation and open it in the browser
- `cargo test`: Run the tests
- `cargo test -- --nocapture`: Run the tests and show the output of the tests
- `cargo test -- --ignored`: Run the tests that are ignored
- `cargo test <test_name>`: Run the tests that match the test name

### Code comments

When you start learning a new language, it's important to know how to comment the code. In ruste there are a large number of ways of commenting code. You'll also notice that the norm is 4 spaces for indentation, not tabs or 2 spaces.

````rust
//! A doc comment that applies to the implicit anonymous module of this crate
pub mod outer_module {
    //!  - Inner line doc
    //!! - Still an inner line doc (but with a bang at the beginning)

    /*!  - Inner block doc */
    /*!! - Still an inner block doc (but with a bang at the beginning) */

    //   - Only a comment
    ///  - Outer line doc (exactly 3 slashes)
    //// - Only a comment

    /*   - Only a comment */
    /**  - Outer block doc (exactly) 2 asterisks */
    /*** - Only a comment */
    pub mod inner_module {}

    pub mod nested_comments {
        /* In Rust /* we can /* nest comments */ */ */

        // All three types of block comments can contain or be nested inside
        // any other type:

        /*   /* */  /** */  /*! */  */
        /*!  /* */  /** */  /*! */  */
        /**  /* */  /** */  /*! */  */
        pub mod dummy_item {}
    }

    pub mod degenerate_cases {
        // empty inner line doc
        //!

        // empty inner block doc
        /*!*/

        // empty line comment
        //

        // empty outer line doc
        ///

        // empty block comment
        /**/
        pub mod dummy_item {}

        // empty 2-asterisk block isn't a doc block, it is a block comment
        /***/

    }
    /* The next one isn't allowed because outer doc comments
       require an item that will receive the doc */

    /// Where is my item?
}
````

### Variables

By default in rust **variable are immutable**. If you want to make a variable mutable you need to add the keyword `mut` before the variable name. **We recommend to use immutable variables as much as possible** because it's safer for two reason. First, Rust ensures that used memory is deallocated when the program is compiled, as this programming language does not have a garbage collector. Second, it is easier to reason about immutable variables because you know that the value will not change.

````rust
fn main() {
    /// Immutable variable (will throw an error)
    let x = 5;
    println!("The value of x is: {}", x);  // --> The value of x is: 5
    x = 6; // This will throw an error because x is immutable

    //// Mutable variable
    let mut x = 5;
    println!("The value of x is: {}", x);  // --> The value of x is: 5
    x = 6; // This will not throw an error because x is mutable
    println!("The value of x is: {}", x);  // --> The value of x is: 6

    //// Shadowing variable
    let x = 5;
    println!("The value of x is: {}", x);  // --> The value of x is: 5
    let x = x + 1; // This will not throw an error because we are creating a new variable and shadowing the previous one
    println!("The value of x is: {}", x);  // --> The value of x is: 6
}
````

You can also declare a constant variable using the `const` keyword. The **type of the variable must be specified** and it will be immutable. Constants can be declared anywhere, **the variable name must be in uppercase** and the value must be a constant expression, not the result of a function call or any other value that could only be calculated at runtime.

````rust
fn main() {
    //// Constants
    const HEAL_POINTS: u32 = 100_000 * 5;
    println!("The value of HEAL_POINTS is: {}", HEAL_POINTS);  // --> The value of HEAL_POINTS is: 500000
}
````

### Data types

**Rust is a statically typed language**, which means that it must know the types of all variables at compile time. The compiler can usually infer what type we want to use based on the value and how we use it. In addition, we can add type annotation to indicate which type we want to use.

````rust
fn main() {
    // Convert a string to integer by specifying the type
    let guess: u32 = "42".parse().expect("Not a number!"); // The type mus be specified (u32)
    println!("The value of guess is: {}", guess);  // --> The value of guess is: 42
}
````

#### Scalar types

A scalar type represents a single value. Rust has four primary scalar types: integers, floating-point numbers, Booleans, and characters.

| Length  | Signed | Unsigned |
| ------- | ------ | -------- |
| 8-bit   | i8     | u8       |
| 16-bit  | i16    | u16      |
| 32-bit  | i32    | u32      |
| 64-bit  | i64    | u64      |
| 128-bit | i128   | u128     |
| arch    | isize  | usize    |


| Number literals | Example |
|-----------------|---------|
| Decimal         | 98_222  |
| Hex             | 0xff    |
| Octal           | 0o77    |
| Binary          | 0b1111_0000 |
| Byte (u8 only)  | b'A'    |

In Rust you can cast one type into another using the `as` keyword. You can also specify the signature of a number using the suffix `_type` (e.g. `5_i32`).

````rust
fn main() {
    //// Integer types
    let x: u32 = 5 as u32; // Unsigned integer
    let x: i32 = 5; // Signed integer (default one)

    //// Floating-point types
    let x: f32 = 5.0_f32; // 32-bit floating-point number
    let x: f64 = 5.0; // 64-bit floating-point number (default one)

    //// Boolean types
    let x: bool = true; // Boolean type

    //// Character types
    let x: char = 'x'; // Character type

    /// Numeric operations
    let sum = 5 + 10; // Addition
    let difference = 95.5 - 4.3; // Subtraction
    let product = 4 * 30; // Multiplication
    let quotient = 56.7 / 32.2; // Division
    let remainder = 43 % 5; // Remainder

    /// If statements
    let number: i32 = 3;
    if number < 5 {
        println!("number smaller than 5");  // --> condition was true
    } else if number > 25 {
        println!("number bigger than 25");
    } else {
        println!("number between 5 and 25");
    }
````


### Functions

````rust
fn main() {

}
````