GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • TUTORIALS
  • REFERENCE
  • ARTICLES
  • FORUM
  • C library:
  • <cassert> (assert.h)
  • <cctype> (ctype.h)
  • <cerrno> (errno.h)
  • <cfenv> (fenv.h)
  • <cfloat> (float.h)
  • <cinttypes> (inttypes.h)
  • <ciso646> (iso646.h)
  • <climits> (limits.h)
  • <clocale> (locale.h)

This view

  • Original page
  • New address

GeezerVison is showing cplusplus.com — std::string::empty

  • TUTORIALS
  • REFERENCE
  • ARTICLES
  • FORUM

C++

  • Tutorials
  • Reference
  • Articles
  • Forum

Reference

  • C library:

    • <cassert> (assert.h)
    • <cctype> (ctype.h)
    • <cerrno> (errno.h)
    • C++11
      <cfenv> (fenv.h)
    • <cfloat> (float.h)
    • C++11
      <cinttypes> (inttypes.h)
    • <ciso646> (iso646.h)
    • <climits> (limits.h)
    • <clocale> (locale.h)
    • <cmath> (math.h)
    • <csetjmp> (setjmp.h)
    • <csignal> (signal.h)
    • <cstdarg> (stdarg.h)
    • C++11
      <cstdbool> (stdbool.h)
    • <cstddef> (stddef.h)
    • C++11
      <cstdint> (stdint.h)
    • <cstdio> (stdio.h)
    • <cstdlib> (stdlib.h)
    • <cstring> (string.h)
    • C++11
      <ctgmath> (tgmath.h)
    • <ctime> (time.h)
    • C++11
      <cuchar> (uchar.h)
    • <cwchar> (wchar.h)
    • <cwctype> (wctype.h)
  • Containers:

    • C++11
      <array>
    • <deque>
    • C++11
      <forward_list>
    • <list>
    • <map>
    • <queue>
    • <set>
    • <stack>
    • C++11
      <unordered_map>
    • C++11
      <unordered_set>
    • <vector>
  • Input/Output:

    • <fstream>
    • <iomanip>
    • <ios>
    • <iosfwd>
    • <iostream>
    • <istream>
    • <ostream>
    • <sstream>
    • <streambuf>
  • Multi-threading:

    • C++11
      <atomic>
    • C++11
      <condition_variable>
    • C++11
      <future>
    • C++11
      <mutex>
    • C++11
      <thread>
  • Other:

    • <algorithm>
    • <bitset>
    • C++11
      <chrono>
    • C++11
      <codecvt>
    • <complex>
    • <exception>
    • <functional>
    • C++11
      <initializer_list>
    • <iterator>
    • <limits>
    • <locale>
    • <memory>
    • <new>
    • <numeric>
    • C++11
      <random>
    • C++11
      <ratio>
    • C++11
      <regex>
    • <stdexcept>
    • <string>
    • C++11
      <system_error>
    • C++11
      <tuple>
    • C++11
      <type_traits>
    • C++11
      <typeindex>
    • <typeinfo>
    • <utility>
    • <valarray>

<string>

  • class templates

    • basic_string
    • char_traits
  • classes

    • string
    • C++11
      u16string
    • C++11
      u32string
    • wstring
  • functions

    • C++11
      stod
    • C++11
      stof
    • C++11
      stoi
    • C++11
      stol
    • C++11
      stold
    • C++11
      stoll
    • C++11
      stoul
    • C++11
      stoull
    • C++11
      to_string
    • C++11
      to_wstring

string

  • string::~string
  • string::string
  • member functions

    • string::append
    • string::assign
    • string::at
    • C++11
      string::back
    • string::begin
    • string::c_str
    • string::capacity
    • C++11
      string::cbegin
    • C++11
      string::cend
    • string::clear
    • string::compare
    • string::copy
    • C++11
      string::crbegin
    • C++11
      string::crend
    • string::data
    • string::empty
    • string::end
    • string::erase
    • string::find
    • string::find_first_not_of
    • string::find_first_of
    • string::find_last_not_of
    • string::find_last_of
    • C++11
      string::front
    • string::get_allocator
    • string::insert
    • string::length
    • string::max_size
    • string::operator[]
    • string::operator+=
    • string::operator=
    • C++11
      string::pop_back
    • string::push_back
    • string::rbegin
    • string::rend
    • string::replace
    • string::reserve
    • string::resize
    • string::rfind
    • C++11
      string::shrink_to_fit
    • string::size
    • string::substr
    • string::swap
  • member constants

    • string::npos
  • non-member overloads

    • getline (string)
    • operator+ (string)
    • operator<< (string)
    • operator>> (string)
    • relational operators (string)
    • swap (string)
  • Reference
  • <string>
  • string
  • empty
public member function
<string>

std::string::empty

bool empty() const;
bool empty() const noexcept;
Test if string is empty
Returns whether the string is empty (i.e. whether its length is 0).

This function does not modify the value of the string in any way. To clear the content of a string, see string::clear.

Parameters

none

Return Value

true if the string length is 0, false otherwise.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// string::empty
#include <iostream>
#include <string>

int main ()
{
  std::string content;
  std::string line;
  std::cout << "Please introduce a text. Enter an empty line to finish:\n";
  do {
    getline(std::cin,line);
    content += line + '\n';
  } while (!line.empty());
  std::cout << "The text you introduced was:\n" << content;
  return 0;
}

This program reads the user input line by line and stores it into string content until an empty line is introduced.

Complexity

Unspecified, but generally constant.
Constant.

Iterator validity

No changes.

Data races

The object is accessed.

Exception safety

No-throw guarantee: this member function never throws exceptions.

See also

string::clear
Clear string (public member function)
string::size
Return length of string (public member function)
string::length
Return length of string (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2026 - All rights reserved - v3.3.4s
Spotted an error? contact us
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.