User Input in the Terminal
This lesson introduces the fundamentals of capturing user input, using std::cin and std::getline()
Up until now, our C++ programs have been running on their own, without any interaction from users. But what if we want to create more dynamic and responsive software?
In this lesson, we'll explore how to capture user input, allowing our programs to adapt and respond to the choices made by those using them.
Using std::cin and std::getline()
Just like std::cout is a stream of output, std::cin is a stream of input from our user. Both std::cout and std::cin are available within the <iostream> header:
#include <iostream>There are numerous ways to interact with std::cin. The most straightforward is using std::getline() to get a line of text from our users.
std::getline() is part of the <string> header and accepts two arguments:
- The input stream, representing where the data is coming from. To let the user input text in the terminal, we'd use
std::cinfor this. - A reference to a
std::string, which will be populated with what the user entered.
Below, we show this in action:
#include <iostream>
#include <string>
int main() {
std::string UserInput;
std::cout << "Enter some text: ";
std::getline(std::cin, UserInput);
std::cout << "You entered: " << UserInput;
}Now, our program will pause at the std::getline() call, and wait for user input. Typing something on our keyboard and hitting return will yield output like the following:
Enter some text: Hello!
You entered: Hello!A Practical Example
Let's see a bigger example of this. The following code lets our users pick what type of Character they want to play as:
#include <iostream>
#include <string>
class Character {
public:
Character(const std::string& ClassName)
: ClassName { ClassName } {
}
void SetName(const std::string& NewName) {
Name = NewName;
}
std::string Name;
std::string ClassName;
};
class Warrior : public Character {
public:
Warrior() : Character("Warrior") {}
};
class Rogue : public Character {
public:
Rogue() : Character("Rogue") {}
};
class Wizard : public Character {
public:
Wizard() : Character("Wizard") {}
};
std::string SelectClass() {
std::cout << "What class do you want to play?"
<< "\n- Enter 1 for Warrior"
<< "\n- Enter 2 for Rogue"
<< "\n- Enter 3 for Wizard"
<< "\n\nMake your selection: ";
std::string ClassString;
std::getline(std::cin, ClassString);
return ClassString;
}
std::string SelectName() {
std::cout << "Enter your name: ";
std::string Name;
std::getline(std::cin, Name);
return Name;
}
int main() {
Character* PlayerCharacter;
Warrior PlayerWarrior;
Rogue PlayerRogue;
Wizard PlayerWizard;
std::string SelectedClass{SelectClass()};
if (SelectedClass == "1") {
PlayerCharacter = &PlayerWarrior;
} else if (SelectedClass == "2") {
PlayerCharacter = &PlayerRogue;
} else {
PlayerCharacter = &PlayerWizard;
}
PlayerCharacter->SetName(SelectName());
std::cout
<< PlayerCharacter->Name << " the "
<< PlayerCharacter->ClassName
<< " is entering the arena!";
}After running this code, and providing the requested input, we might see something like this:
What class do you want to play?
- Enter 1 for Warrior
- Enter 2 for Rogue
- Enter 3 for Wizard
Make your selection: 2
Enter your name: Grifter
Grifter the Rogue is entering the arena!Summary
In this lesson, we explored the basics of obtaining user input in C++ using std::cin and std::getline(). These techniques let us make our terminal programs interactive and responsive to user commands.
Bitwise Operators and Bit Flags
Unravel the fundamentals of bitwise operators and bit flags in this practical lesson