इसका उपयोग स्ट्रीम से अनफॉर्मेटेड इनपुट के रूप में कैरेक्टर्स निकालने और उन्हें c-स्ट्रिंग के रूप में s में संग्रहीत करने के लिए किया जाता है, जब तक कि निकाला गया कैरेक्टर डिलिमिटिंग कैरेक्टर न हो, या n कैरेक्टर्स s में लिखे जा चुके हों (टर्मिनेटिंग नल कैरेक्टर सहित)। डिक्लेरेशन इस प्रकार है:
basic_istream& getline (char_type* s, streamsize n); basic_istream& getline (char_type* s, streamsize n, char_type delim);
पैरामीटर्स हैं 's' कैरेक्टर्स के ऐरे का पॉइंटर, जहां निकाले गए कैरेक्टर्स c_string के रूप में संग्रहीत होते हैं। अगला पैरामीटर 'n' यह लिखे जाने वाले कैरेक्टर्स की अधिकतम संख्या है (टर्मिनेटिंग कैरेक्टर सहित)। तीसरा पैरामीटर 'delim' एक्सप्लिसिट डिलिमिटिंग कैरेक्टर है। लगातार कैरेक्टर्स निकालने का ऑपरेशन तब रुक जाता है जब अगला कैरेक्टर जो निकालने वाला है, इसकी तुलना इससे बराबर होती है (traits_type::eq का उपयोग करके)।
यह फ़ंक्शन basic_istream ऑब्जेक्ट (*this) लौटाता है।
उदाहरण
#include <iostream>
using namespace std;
int main() {
char name[256], title[256];
cout << "Please, enter your name: ";
cin.getline(name, 256);
cout << "Please, enter your favourite movie: ";
cin.getline(title, 256);
cout << name << "'s favourite movie is " << title;
}
आउटपुट
Please, enter your name: Jack Please, enter your favourite movie: The Boss Baby Jack's favourite movie is The Boss Baby
