C++ Standard Library
In the C++ programming language, the C++ Standard Library is a collection of classes and functions, which are written in the core language and part of the C++ ISO Standard itself.[1]
C++ Standard Library |
---|
Containers |
C standard library |
Overview
The C++ Standard Library provides several generic containers, functions to use and manipulate these containers, function objects, generic strings and streams (including interactive and file I/O), support for some language features, and functions for everyday tasks such as finding the square root of a number. The C++ Standard Library also incorporates most headers of the ISO C standard library ending with ".h", but their use is deprecated.[2] No other headers in the C++ Standard Library end in ".h". Features of the C++ Standard Library are declared within the std
namespace.
The C++ Standard Library is based upon conventions introduced by the Standard Template Library (STL), and has been influenced by research in generic programming and developers of the STL such as Alexander Stepanov and Meng Lee.[3][4] Although the C++ Standard Library and the STL share many features, neither is a strict superset of the other.
A noteworthy feature of the C++ Standard Library is that it not only specifies the syntax and semantics of generic algorithms, but also places requirements on their performance.[5] These performance requirements often correspond to a well-known algorithm, which is expected but not required to be used. In most cases this requires linear time O(n) or linearithmic time O(n log n), but in some cases higher bounds are allowed, such as quasilinear time O(n log2 n) for stable sort (to allow in-place merge sort). Previously, sorting was only required to take O(n log n) on average, allowing the use of quicksort, which is fast in practice but has poor worst-case performance, but introsort was introduced to allow both fast average performance and optimal worst-case complexity, and as of C++11, sorting is guaranteed to be at worst linearithmic. In other cases requirements remain laxer, such as selection, which is only required to be linear on average (as in quickselect),[6] not requiring worst-case linear as in introselect.
The C++ Standard Library underwent ISO standardization as part of the C++ ISO Standardization effort, and is undergoing further work[7] regarding standardization of expanded functionality.
Implementations
Microsoft C++ Standard Library (STL)
At CppCon 2019 on September 16th, 2019, Microsoft announced releasing their implementation of the C++ Standard Library (also known as the STL) as open source.[8] It is hosted on GitHub and licensed under the Apache License 2.0 with LLVM Exception.[9][10]
Apache C++ Standard Library
The Apache C++ Standard Library is another open source implementation. It was originally developed commercially by Rogue Wave Software and later donated to the Apache Software Foundation.[11] However, after more than five years without a release, the board of the Apache Software Foundation decided to end this project and move it to Apache Attic.[12]
LLVM C++ Standard Library
The LLVM project includes an implementation of the C++ Standard Library called libc++, dual-licensed under the MIT License and the UIUC license. Since v9.0.0, it was relicensed to the Apache License 2.0 with LLVM Exceptions.
Standard headers
The following files contain the declarations of the C++ Standard Library.
Containers
- <array>
- New in C++11 and TR1. Provides the container class template
std::array
, a container for a fixed sized array. - <bitset>
- Provides the specialized container class
std::bitset
, a bit array. - <deque>
- Provides the container class template
std::deque
, a double-ended queue. - <forward_list>
- New in C++11 and TR1. Provides the container class template
std::forward_list
, a singly linked list. - <list>
- Provides the container class template
std::list
, a doubly linked list. - <map>
- Provides the container class templates
std::map
andstd::multimap
, sorted associative array and multimap. - <queue>
- Provides the container adapter class
std::queue
, a single-ended queue, andstd::priority_queue
, a priority queue. - <set>
- Provides the container class templates
std::set
andstd::multiset
, sorted associative containers or sets. - <stack>
- Provides the container adapter class
std::stack
, a stack. - <unordered_map>
- New in C++11 and TR1. Provides the container class template
std::unordered_map
andstd::unordered_multimap
, hash tables. - <unordered_set>
- New in C++11 and TR1. Provides the container class template
std::unordered_set
andstd::unordered_multiset
. - <vector>
- Provides the container class template
std::vector
, a dynamic array.
General
- <algorithm>
- Provides definitions of many container algorithms.
- <chrono>
- Provides time elements, such as
std::chrono::duration
,std::chrono::time_point
, and clocks.
- <functional>
- Provides several function objects, designed for use with the standard algorithms.
- <iterator>
- Provides classes and templates for working with iterators.
- <memory>
- Provides facilities for memory management in C++, including the class template
std::unique_ptr
. - <stdexcept>
- Contains standard exception classes such as
std::logic_error
andstd::runtime_error
, both derived fromstd::exception
. - <tuple>
- New in C++11 and TR1. Provides a class template
std::tuple
, a tuple. - <utility>
- Provides the template class
std::pair
, for working with object pairs (two-member tuples), and the namespacestd::rel_ops
, for easier operator overloading.
Localization
- <locale>
- Defines classes and declares functions that encapsulate and manipulate the information peculiar to a locale.
- <codecvt>
- Provides code conversion facets for various character encodings.
Strings
- <string>
- Provides the C++ standard string classes and templates.
- <regex>
- New in C++11. Provides utilities for pattern matching strings using regular expressions.
Streams and input/output
- <fstream>
- Provides facilities for file-based input and output. See fstream.
- <iomanip>
- Provides facilities to manipulate output formatting, such as the base used when formatting integers and the precision of floating point values.
- <ios>
- Provides several types and functions basic to the operation of iostreams.
- <iosfwd>
- Provides forward declarations of several I/O-related class templates.
- <iostream>
- Provides C++ input and output fundamentals. See iostream.
- <istream>
- Provides the template class
std::istream
and other supporting classes for input. - <ostream>
- Provides the template class
std::ostream
and other supporting classes for output. - <sstream>
- Provides the template class
std::stringstream
and other supporting classes for string manipulation. - <streambuf>
- Provides reading and writing functionality to/from certain types of character sequences, such as external files or strings.
Language support
- <exception>
- Provides several types and functions related to exception handling, including
std::exception
, the base class of all exceptions thrown by the Standard Library. - <limits>
- Provides the template class
std::numeric_limits
, used for describing properties of fundamental numeric types. - <new>
- Provides operators
new
anddelete
and other functions and types composing the fundamentals of C++ memory management. - <typeinfo>
- Provides facilities for working with C++ run-time type information.
Thread support library
- <thread>
- New in C++11. Provide class and namespace for working with threads.
- <mutex>
- New in C++11. 30.4-1. This section provides mechanisms for mutual exclusion: mutexes, locks, and call once.
- <condition_variable>
- New in C++11. 30.5-1. Condition variables provide synchronization primitives used to block a thread until notified by some other thread that some condition is met or until a system time is reached.
- <future>
- New in C++11. 30.6.1-1. Describes components that a C++ program can use to retrieve in one thread the result (value or exception) from a function that has run in the same thread or another thread.
Numerics library
Components that C++ programs may use to perform seminumerical operations.
- <complex>
- The header <complex> defines a class template, and numerous functions for representing and manipulating complex numbers.
- <random>
- Facility for generating (pseudo-)random numbers
- <valarray>
- Defines five class templates (valarray, slice_array, gslice_array, mask_array, and indirect_array), two classes (slice and gslice),and a series of related function templates for representing and manipulating arrays of values.
- <numeric>
- Generalized numeric operations.
C standard library
Each header from the C Standard Library is included in the C++ Standard Library under a different name, generated by removing the .h, and adding a 'c' at the start; for example, 'time.h' becomes 'ctime'. The only difference between these headers and the traditional C Standard Library headers is that where possible the functions should be placed into the std:: namespace. In ISO C, functions in the standard library are allowed to be implemented by macros, which is not allowed by ISO C++.
See also
References
- ISO/IEC 14882:2003(E) Programming Languages — C++ §17-27
- ISO/IEC 14882:2003(E) Programming Languages — C++ §D.5
- Bjarne Stroustrup. The Design and Evolution of C++ §8.5. Addison Wesley. ISBN 0-201-54330-3.
- Alexander Stepanov, Meng Lee (1 August 1994). "The Standard Template Library". HP Labs. Retrieved 22 October 2017.
- "Generic Algorithms", David Musser
- "std::nth_element". cppreference.com. Retrieved 20 March 2018.
- "JTC1/SC22/WG21 - The C++ Standards Committee". ISO/IEC. Retrieved 7 July 2009.
- https://devblogs.microsoft.com/cppblog/open-sourcing-msvcs-stl/
- https://github.com/microsoft/STL
- https://github.com/microsoft/STL/blob/master/LICENSE.txt
- Apache C++ Standard Library
- Brett Porter (18 July 2013). "Apache C++ Standard Library and the Attic". stdcxx-dev mailing list. Retrieved 27 February 2014.
Further reading
- Stroustrup, Bjarne. The C++ Programming Language. Addison-Wesley. ISBN 978-0321563842.
- Josuttis, Nicolai. The C++ Standard Library - A Tutorial and Reference. Addison-Wesley. ISBN 978-0-321-62321-8.
- Van Weert, Peter; Gregoire, Marc. C++ Standard Library Quick Reference. Apress. ISBN 978-1484218754.
External links
- C++ Standard Library reference
- Microsoft C++ Standard Library Reference
- Rogue Wave SourcePro C++ documentation
- Apache C++ Standard Library Wiki, retired 15 May 2014 (based on Rogue Wave C++ Standard Library 4.1.0)
- STLport C++ Standard Library documentation
- The GNU C++ Library online documentation
- LLVM/Clang C++ Standard Library documentation