2a62fbdedf
- 76fcc6eebc6a5b5a885f04e1579762573c2bf9bc Fix broken links, and remove old README files from Git. by Daniel Katz <katzdm@google.com> - 174287df7bc7c1832fe4a66d82ee0f61a8788460 Remove "test_dependencies.bzl" file. Not needed. by Daniel Katz <katzdm@google.com> - 4e9416b389e61f5258c3a7fc0f7966f03d9ae086 Fix broken about/intro link in README.md by Abseil Team <absl-team@google.com> - 2a662ff187987246cf8f3c1de83eaa23f1d2c034 Delete extraneous comments. by Abseil Team <absl-team@google.com> - 3bdc2d15af21e0297ccf39c90c0ed51a35900679 Cleanup usage of GUNIT_DEPS_SELECTOR/GUNIT_MAIN_DEPS_SELE... by Gennadiy Rozental <rogeeff@google.com> - bec32fc8efee3ae5b67c07dcae08d74540c944d0 Enable time_test on windows: by Xiaoyi Zhang <zhangxy@google.com> GitOrigin-RevId: 76fcc6eebc6a5b5a885f04e1579762573c2bf9bc Change-Id: I9556164f6b48dae1fa02b2ec6444517faed23e1f
90 lines
3.6 KiB
Markdown
90 lines
3.6 KiB
Markdown
# Abseil - C++ Common Libraries
|
|
|
|
The repository contains the Abseil C++ library code. Abseil is an open-source
|
|
collection of C++ code (compliant to C++11) designed to augment the C++
|
|
standard library.
|
|
|
|
## Table of Contents
|
|
|
|
- [About Abseil](#about)
|
|
- [Codemap](#codemap)
|
|
- [License](#license)
|
|
- [Links](#links)
|
|
|
|
<a name="about"></a>
|
|
## About Abseil
|
|
|
|
Abseil is an open-source collection of C++ library code designed to augment
|
|
the C++ standard library. The Abseil library code is collected from Google's
|
|
own C++ code base, has been extensively tested and used in production, and
|
|
is the same code we depend on in our daily coding lives.
|
|
|
|
In some cases, Abseil provides pieces missing from the C++ standard; in
|
|
others, Abseil provides alternatives to the standard for special needs
|
|
we've found through usage in the Google code base. We denote those cases
|
|
clearly within the library code we provide you.
|
|
|
|
Abseil is not meant to be a competitor to the standard library; we've
|
|
just found that many of these utilities serve a purpose within our code
|
|
base, and we now want to provide those resources to the C++ community as
|
|
a whole.
|
|
|
|
## Codemap
|
|
|
|
Abseil contains the following C++ library components:
|
|
|
|
* [`base`](absl/base/) Abseil Fundamentals
|
|
<br /> The `base` library contains initialization code and other code which
|
|
all other Abseil code depends on. Code within `base` may not depend on any
|
|
other code (other than the C++ standard library).
|
|
* [`algorithm`](absl/algorithm/)
|
|
<br /> The `algorithm` library contains additions to the C++ `<algorithm>`
|
|
library and container-based versions of such algorithms.
|
|
* [`container`](absl/container/)
|
|
<br /> The `container` library contains additional STL-style containers.
|
|
* [`debugging`](absl/debugging/)
|
|
<br /> The `debugging` library contains code useful for enabling leak
|
|
checks. Future updates will add stacktrace and symbolization utilities.
|
|
* [`memory`](absl/memory/)
|
|
<br /> The `memory` library contains C++11-compatible versions of
|
|
`std::make_unique()` and related memory management facilities.
|
|
* [`meta`](absl/meta/)
|
|
<br /> The `meta` library contains C++11-compatible versions of type checks
|
|
available within C++14 and C++17 versions of the C++ `<type_traits>` library.
|
|
* [`numeric`](absl/numeric/)
|
|
<br /> The `numeric` library contains C++11-compatible 128-bit integers.
|
|
* [`strings`](absl/strings/)
|
|
<br /> The `strings` library contains a variety of strings routines and
|
|
utilities, including a C++11-compatible version of the C++17
|
|
`std::string_view` type.
|
|
* [`synchronization`](absl/synchronization/)
|
|
<br /> The `synchronization` library contains concurrency primitives (Abseil's
|
|
`absl::Mutex` class, an alternative to `std::mutex`) and a variety of
|
|
synchronization abstractions.
|
|
* [`time`](absl/time/)
|
|
<br /> The `time` library contains abstractions for computing with absolute
|
|
points in time, durations of time, and formatting and parsing time within
|
|
time zones.
|
|
* [`types`](absl/types/)
|
|
<br /> The `types` library contains non-container utility types, like a
|
|
C++11-compatible version of `absl::optional`.
|
|
|
|
## License
|
|
|
|
The Abseil C++ library is licensed under the terms of the Apache
|
|
license. See [LICENSE](LICENSE) for more information.
|
|
|
|
## Links
|
|
|
|
For more information about Abseil:
|
|
|
|
* Consult our [Abseil Introduction](http://abseil.io/about/intro)
|
|
* Read [Why Adopt Abseil](http://abseil.io/about/philosophy) to understand our
|
|
design philosophy.
|
|
* Peruse our
|
|
[Abseil Compatibility Guarantees](http://abseil.io/about/compatibility) to
|
|
understand both what we promise to you, and what we expect of you in return.
|
|
|
|
## Disclaimer
|
|
|
|
* This is not an official Google product.
|