c16d5557cd
-- 4e043a11b4c10a24e84046827ee16f47e11e35cc by Abseil Team <absl-team@google.com>: Merge of https://github.com/abseil/abseil-cpp/pull/136 PiperOrigin-RevId: 218197648 -- e61f06e1e601061a443feaa8c5207c52437bd641 by Abseil Team <absl-team@google.com>: Don't include <iostream> into int128, it's wasteful Including iostream emits a global constructor for initializing std::cout and friends, which isn't actually used by this file. PiperOrigin-RevId: 218156386 -- 8a6c82396e4c956be7f285328aec131cb4965f16 by Xiaoyi Zhang <zhangxy@google.com>: Fix MSVC compiler warnings on discarding return values of functions with 'nodiscard' attribute. PiperOrigin-RevId: 217883401 -- abf3e3a0f22bc4070df9dbc9a4ef4d883ed686bf by Tom Manshreck <shreck@google.com>: Update public README to add new libraries PiperOrigin-RevId: 217879399 -- 43b3b420a4e861711abbfbd497b8f2b3de17ec8c by Abseil Team <absl-team@google.com>: Import of CCTZ from GitHub. PiperOrigin-RevId: 217780963 -- 1c8831947ca6a65a63842e6bd5f37a7c102a4e1b by Abseil Team <absl-team@google.com>: Fix typo in a comment (missing comma in usage example). PiperOrigin-RevId: 217776645 GitOrigin-RevId: 4e043a11b4c10a24e84046827ee16f47e11e35cc Change-Id: I8999ae928da7a0030b4ecfd8d13da8522fdd013a
114 lines
4.7 KiB
Markdown
114 lines
4.7 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)
|
|
- [Quickstart](#quickstart)
|
|
- [Building Abseil](#build)
|
|
- [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.
|
|
|
|
<a name="quickstart"></a>
|
|
## Quickstart
|
|
|
|
If you want to just get started, make sure you at least run through the
|
|
[Abseil Quickstart](https://abseil.io/docs/cpp/quickstart). The Quickstart
|
|
contains information about setting up your development environment, downloading
|
|
the Abseil code, running tests, and getting a simple binary working.
|
|
|
|
<a name="build"></a>
|
|
## Building Abseil
|
|
|
|
[Bazel](http://bazel.build) is the official build system for Abseil,
|
|
which is supported on most major platforms (Linux, Windows, MacOS, for example)
|
|
and compilers. See the [quickstart](https://abseil.io/docs/cpp/quickstart) for
|
|
more information on building Abseil using the Bazel build system.
|
|
|
|
<a name="cmake"></a>
|
|
If you require CMake support, please check the
|
|
[CMake build instructions](CMake/README.md).
|
|
|
|
## 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,
|
|
including Abseil's unordered "Swiss table" containers.
|
|
* [`debugging`](absl/debugging/)
|
|
<br /> The `debugging` library contains code useful for enabling leak
|
|
checks, and stacktrace and symbolization utilities.
|
|
* [`hash`](absl/hash/)
|
|
<br /> The `hash` library contains the hashing framework and default hash
|
|
functor implementations for hashable types in Abseil.
|
|
* [`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 the C++17 `std::optional` type.
|
|
* [`utility`](absl/utility/)
|
|
<br /> The `utility` library contains utility and helper code.
|
|
|
|
## 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.
|