How to Use Templates and Macros in C++

In this tutorial, we will explore templates and macros in C++.

Prerequisites

Employing Macros

Let’s explore how to use macros in C++ and their application in robotics projects. Macros are preprocessor directives that allow you to define reusable pieces of code, processed before compilation. 

Open a terminal window, and type this: 

cd ~/Documents/cpp_tutorial && code . 

Create a new C++ file and name it basic_macro.cpp.

Type the following code into the editor:

#include <iostream>

// Define a constant macro
#define PI 3.14159

// Define a function-like macro
#define AREA_CIRCLE(radius) (PI * (radius) * (radius))

int main() {
    double radius = 5.0;
    double area = AREA_CIRCLE(radius);

    std::cout << "The area of a circle with radius " << radius << " is: " << area << std::endl;

    return 0;
}

In this code, we define two macros:

  1. PI is a constant macro that defines the value of pi.
  2. AREA_CIRCLE(radius) is a function-like macro that calculates the area of a circle given its radius.

In the main() function, we use the AREA_CIRCLE macro to calculate the area of a circle with a radius of 5.0 and store the result in the area variable. We then print the calculated area using std::cout.

Run the code.

1-basic-macro

The output displays the calculated area of the circle using the AREA_CIRCLE macro.

It’s important to note that macros should be used sparingly and with caution, as they can sometimes lead to unexpected behavior if not used carefully. In modern C++, const variables, inline functions, or templates are often preferred over macros when possible.

Implementing Template Functions

Let’s explore template functions in C++, which allow us to write generic functions that can work with different data types. This is particularly useful in robotics when dealing with various sensor data types or mathematical operations. 

Create a new C++ file and name it template_functions_example.cpp

Type the following code into the editor:

#include <iostream>

template<typename T>
T find_max(T a, T b) {
    return (a > b) ? a : b;
}

int main() {
    std::cout << "Max of 10 and 20 is: " << find_max<int>(10, 20) << std::endl;
    std::cout << "Max of 5.5 and 2.1 is: " << find_max<double>(5.5, 2.1) << std::endl;
    return 0;
}

In this code, we define a template function find_max that takes two parameters of the same type and returns the greater of the two. The function uses the ternary operator to compare the two values. We then test this function with integers and doubles to show its versatility.

Run the code.

2-template-functions-example

The output should display “Max of 10 and 20 is: 20” and “Max of 5.5 and 2.1 is: 5.5”, demonstrating how the template function adapts to different data types.

Defining Template Classes

Let’s explore template classes in C++, which allow us to create generic classes that can work with different data types. This is particularly useful for creating reusable data structures in robotics applications. 

Create a new C++ file and name it template_class.cpp.

Type the following code into the editor:

#include <iostream>

// Template class for a point in 2D space
template <typename T>
class Point {
private:
    T x;
    T y;

public:
    Point(T x, T y) : x(x), y(y) {}

    T getX() const { return x; }
    T getY() const { return y; }

    void printPoint() const {
        std::cout << "(" << x << ", " << y << ")" << std::endl;
    }
};

int main() {
    Point<int> int_point(5, 10);
    Point<double> double_point(3.14, 2.71);

    std::cout << "Integer point: ";
    int_point.printPoint();

    std::cout << "Double point: ";
    double_point.printPoint();

    return 0;
}

In this code, we define a template class called Point that represents a point in 2D space. The class has two private member variables, x and y, of type T. The typename keyword is used to specify that T is a type parameter.

The Point class has a constructor that takes x and y values and initializes the member variables. It also provides getter functions getX() and getY() to access the values of x and y, respectively. The printPoint() function is a member function that prints the point in the format (x, y).

In the main() function, we create two instances of the Point class: int_point with integer values and double_point with double values. 

We use the printPoint() function to print the points and verify that the template class works correctly with different data types.

Run the code.

3-template-class

The output displays the points created with integer and double values.

Template classes provide flexibility and help reduce code duplication, making the code more maintainable and efficient.

Thanks, and I’ll see you in the next tutorial.

Keep building!

How to Use Lambda Expressions and File I/O in C++

In this tutorial, we will explore lambda expressions and file I/O using C++.

Prerequisites

Using Lambda Expressions 

Let’s explore lambda expressions in C++ and how they can be used in robotics projects. 

Lambda expressions allow us to define anonymous functions inline, which is particularly useful for operations like sorting sensor data or defining quick callback functions. 

Open a terminal window, and type this:

cd ~/Documents/cpp_tutorial
code .

Create a new C++ file and name it lambda_sensors.cpp

Type the following code into the editor:

#include <iostream>
#include <vector>
#include <algorithm>  // Include for std::sort

int main() {
    // Example list of sensor readings (could be temperatures, distances, etc.)
    std::vector<int> sensorReadings = {90, 85, 60, 75, 100};

    // Print original readings
    std::cout << "Original readings: ";
    for (int reading : sensorReadings) {
        std::cout << reading << " ";
    }
    std::cout << std::endl;

    // Using a lambda expression to sort the readings in descending order
    std::sort(sensorReadings.begin(), sensorReadings.end(), [](int a, int b) {
        return a > b;  // Comparison criterion defined inline
    });

    // Print sorted readings
    std::cout << "Sorted readings (desc): ";
    for (int reading : sensorReadings) {
        std::cout << reading << " ";
    }
    std::cout << std::endl;

    return 0;
}

In this code, we start with a vector of integers representing sensor readings. The lambda expression is used within the std::sort function. Here, the lambda (int a, int b) { return a > b; } defines an inline function that tells std::sort how to compare two elements, specifying that we want to sort in descending order without the need for a separate function.

Run the code.

1-lambda-sensors

You should see the original and sorted readings displayed, showcasing how lambda expressions facilitate custom sorting in a concise manner.

This example highlights the utility of lambda expressions in C++, allowing for immediate definition of small scope functions directly within the code where they are needed. 

Iterating with for_each Loop

Let’s explore how to use the for_each loop in C++. The for_each loop is part of the C++ Standard Library and provides a clear, concise way to perform operations on every element in a range, such as an array or a container like a vector. This is particularly useful in robotics for tasks like processing sensor data, where you need to apply the same operation to a series of values.

Let’s demonstrate the use of the for_each loop with an example where we’ll process a list of distances recorded by a robot’s sensors.

Create a new C++ file and name it for_each_loop.cpp.

Type the following code into the editor:

#include <iostream>
#include <vector>
#include <algorithm>  // Include for std::for_each

int main() {
    // Example list of distances measured by sensors (in meters)
    std::vector<int> distances = {5, 10, 3, 7, 9};

    // Print original distances
    std::cout << "Original distances: ";
    for (int distance : distances) {
        std::cout << distance << " ";
    }
    std::cout << std::endl;

    // Using a lambda expression with std::for_each to increment each distance by 1
    std::for_each(distances.begin(), distances.end(), [](int &d) {
        d += 1;  // Increment each element by 1
    });

    // Print updated distances
    std::cout << "Updated distances: ";
    for (int distance : distances) {
        std::cout << distance << " ";
    }
    std::cout << std::endl;

    return 0;
}

In this example, we begin with a vector of integers representing distances recorded by a robot. We use std::for_each along with a lambda expression that increments each element in the vector. The lambda (int &d) { d += 1; } directly modifies each element by adding 1, demonstrating an efficient way to process and update data in-place.

Run the code.

2-for-each-loop

You should see both the original and updated distances displayed, showing the practical application of the for_each loop in modifying elements directly.

Handling File Input and output

Let’s explore how to handle file input and output in C++ and its applications in robotics projects.

File input and output are essential operations in many programs, including robotics applications. In C++, the <fstream> library provides classes for reading from and writing to files. The ifstream class is used for reading from files, while the ofstream class is used for writing to files.

Let’s create a new C++ file named file_io_example.cpp to demonstrate file input and output.

Type the following code into the editor:

#include <iostream>
#include <fstream>
#include <string>

int main() {
    std::string filename = "robot_data.txt";
    std::ofstream output_file(filename);

    if (output_file.is_open()) {
        output_file << "Sensor1: 10.5\n";
        output_file << "Sensor2: 20.7\n";
        output_file << "Sensor3: 15.2\n";
        output_file.close();
        std::cout << "Data written to file: " << filename << std::endl;
    } else {
        std::cout << "Unable to open file for writing." << std::endl;
    }

    std::ifstream input_file(filename);
    std::string line;

    if (input_file.is_open()) {
        while (std::getline(input_file, line)) {
            std::cout << line << std::endl;
        }
        input_file.close();
    } else {
        std::cout << "Unable to open file for reading." << std::endl;
    }

    return 0;
}

In this code, we first create a file named “robot_data.txt” using an ofstream object. We check if the file is successfully opened using the is_open() function. If the file is open, we write some sensor data to the file using the << operator and then close the file.

Next, we read the data from the same file using an ifstream object. We check if the file is successfully opened for reading. If the file is open, we read the file line by line using getline() and print each line to the console. After reading, we close the file.

Run the code.

3-file-io-example

The output confirms that the data was written to the file and then displays the contents of the file.

In robotics projects, file I/O can be used for various purposes, such as saving sensor data, reading configuration files, or storing robot states for analysis or debugging.

Thanks, and I’ll see you in the next tutorial.

Keep building!

How to Use Structs and Operator Overloading in C++

In this tutorial, we will explore how to use structs and operator overloading in C++. 

Prerequisites

Working with Structs

Let’s explore how to work with structs in C++ and their application in robotics projects. 

Structs can be used in C++ to group related data together, making the code more organized and readable. Structs are particularly useful in robotics projects for representing various data structures, such as robot configurations, sensor readings, or control parameters.

Open a terminal window, and type this:

cd ~/Documents/cpp_tutorial
code .

Create a new C++ file named robot_struct.cpp.

Type the following code into the editor:

#include <iostream>
#include <string>

struct RobotSpec {
    std::string model;
    int max_speed;
    double weight;
};

void print_robot_spec(const RobotSpec& spec) {
    std::cout << "Model: " << spec.model << std::endl;
    std::cout << "Max Speed: " << spec.max_speed << " m/s" << std::endl;
    std::cout << "Weight: " << spec.weight << " kg" << std::endl;
}

int main() {
    RobotSpec robot = {"MobileBot", 5, 10.5};
    print_robot_spec(robot);
    return 0;
}

In this code, we define a struct called RobotSpec to represent the specifications of a robot. It contains three members: model (a string), max_speed (an integer), and weight (a double).

We also define a function print_robot_spec() that takes a constant reference to a RobotSpec object and prints its members.

In the main() function, we create an instance of the RobotSpec struct called robot and initialize its members. 

We then pass robot to the print_robot_spec() function to print its specifications.

Run the code.

1-working-with-structs

The output displays the robot’s specifications as defined in the RobotSpec struct.

Implementing Operator Overloading

Let’s explore the concept of operator overloading in C++ and its applications in robotics projects.

Operator overloading is a powerful feature in C++ that allows you to define custom behavior for operators when applied to user-defined types. This means you can make operators like +, -, *, /, and others work with your own classes and objects in a way that makes sense for your specific use case.

Let’s create a new C++ file named distance.cpp to demonstrate operator overloading.

Type the following code into the editor:

#include <iostream>

class Distance {
public:
    int meters;

    Distance(int m = 0) : meters(m) {}

    Distance operator+(const Distance& other) const {
        return Distance(meters + other.meters);
    }
};

int main() {
    Distance d1(5);
    Distance d2(10);
    Distance sum = d1 + d2;
    std::cout << "d1 = " << d1.meters << " meters" << std::endl;
    std::cout << "d2 = " << d2.meters << " meters" << std::endl;
    std::cout << "sum = " << sum.meters << " meters" << std::endl;
    return 0;
}

In this code, we define a class called Distance to represent a distance in meters. We overload the + operator by defining the operator+() member function. This function takes another Distance object as a parameter and returns a new Distance object that is the sum of the two distances.

In the main() function, we create two Distance objects, d1 and d2, and compute their sum using the overloaded + operator. We then print the distances and their sum using the meters member variable.

Run the code.

2-operator-overloading

The output displays the distances d1 and d2, as well as their sum, in meters.

By overloading the + operator, we’ve made it possible to add two Distance objects together using the familiar syntax d1 + d2, which makes the code more intuitive and readable.

In robotics projects, operator overloading can be useful for performing operations on custom data types, such as distances, angles, or time durations, making the code more expressive and easier to understand.

Thanks, and I’ll see you in the next tutorial.

Keep building!