
- The C Standard Library
- The C Standard Library
- The C++ Standard Library
- C++ Library - Home
- C++ Library - <fstream>
- C++ Library - <iomanip>
- C++ Library - <ios>
- C++ Library - <iosfwd>
- C++ Library - <iostream>
- C++ Library - <istream>
- C++ Library - <ostream>
- C++ Library - <sstream>
- C++ Library - <streambuf>
- C++ Library - <atomic>
- C++ Library - <complex>
- C++ Library - <exception>
- C++ Library - <functional>
- C++ Library - <limits>
- C++ Library - <locale>
- C++ Library - <memory>
- C++ Library - <new>
- C++ Library - <numeric>
- C++ Library - <regex>
- C++ Library - <stdexcept>
- C++ Library - <string>
- C++ Library - <thread>
- C++ Library - <tuple>
- C++ Library - <typeinfo>
- C++ Library - <utility>
- C++ Library - <valarray>
- The C++ STL Library
- C++ Library - <array>
- C++ Library - <bitset>
- C++ Library - <deque>
- C++ Library - <forward_list>
- C++ Library - <list>
- C++ Library - <map>
- C++ Library - <queue>
- C++ Library - <set>
- C++ Library - <stack>
- C++ Library - <unordered_map>
- C++ Library - <unordered_set>
- C++ Library - <vector>
- C++ Library - <algorithm>
- C++ Library - <iterator>
- C++ Programming Resources
- C++ Programming Tutorial
- C++ Useful Resources
- C++ Discussion
C++ Algorithm Library - is_sorted() Function
Description
The C++ function std::algorithm::is_sorted() tests whether range is sorted or not. It uses binary function for comparision.
Declaration
Following is the declaration for std::algorithm::is_sorted() function form std::algorithm header.
C++11
template <class ForwardIterator, class Compare> bool is_sorted (ForwardIterator first, ForwardIterator last, Compare comp);
Parameters
first − Forward iterator to the initial position.
last − Forward iterator to the final position.
comp − A binary function which accepts two arguments and returns bool.
Return value
Returns true if range is sorted otherwise returns false.
Exceptions
Throws exception if either the binary function or an operation on an iterator throws exception.
Please note that invalid parameters cause undefined behavior.
Time complexity
Linear.
Example
The following example shows the usage of std::algorithm::is_sorted() function.
#include <iostream> #include <vector> #include <algorithm> using namespace std; bool ignore_case(char a, char b) { return (tolower(a) == tolower(b)); } int main(void) { vector<char> v = {'A', 'b', 'C', 'd', 'E'}; bool result; result = is_sorted(v.begin(), v.end()); if (result == false) cout << "Vector elements are not sorted in ascending order." << endl; result = is_sorted(v.begin(), v.end(), ignore_case); if (result == true) cout << "Vector elements are sorted in ascending order." << endl; return 0; }
Let us compile and run the above program, this will produce the following result −
Vector elements are not sorted in ascending order. Vector elements are sorted in ascending order.