== Clone of https://github.com/carbon-language/carbon-lang.git ==

josh11b 9b028bb743 Destructors (#1154) 4 years ago
.github 6fe8411122 Refactor common script functionality and reimplement the buildifier pre-commit (#1080) 4 years ago
.vscode 3116c6ff5d Update vscode recommendations (#707) 4 years ago
bazel 770555d8c9 Update check_deps, make reusing scripts easier (#1187) 4 years ago
common 770555d8c9 Update check_deps, make reusing scripts easier (#1187) 4 years ago
docs 9b028bb743 Destructors (#1154) 4 years ago
executable_semantics 770555d8c9 Update check_deps, make reusing scripts easier (#1187) 4 years ago
github_tools ad08148304 Specify gql version (#1039) 4 years ago
installers 770555d8c9 Update check_deps, make reusing scripts easier (#1187) 4 years ago
migrate_cpp eda43faa5a Note namespace and static recommendations in C++ style guide (#1041) 4 years ago
proposals 9b028bb743 Destructors (#1154) 4 years ago
scripts 770555d8c9 Update check_deps, make reusing scripts easier (#1187) 4 years ago
third_party 22462a0d7f Carbon fuzzing 3/3: added actual fuzzer implementation and a fuzzverter utility for investigating crashing protos (#1156) 4 years ago
toolchain a24963ea6b Move diagnostic definitions to be closer to where they emit (#1169) 4 years ago
.bazelignore fbb0aa729b Update LLVM and switch to upstreamed Bazel BUILD. (#838) 4 years ago
.bazeliskrc 151f54e040 Update bazel version (#925) 4 years ago
.bazelrc 22462a0d7f Carbon fuzzing 3/3: added actual fuzzer implementation and a fuzzverter utility for investigating crashing protos (#1156) 4 years ago
.clang-format f44cf22924 Add a C++ style guide for the project (#113) 5 years ago
.clang-tidy f9014a6d10 clang-tidy with readability checks (#1148) 4 years ago
.codespell_ignore 1723b4e0b2 Hide `Interpreter` in .cpp (#1036) 4 years ago
.gdbinit dcc694c2e0 Auto-enable pretty-printing of libcxx in gdb. (#679) 4 years ago
.gitallowed cc4211442f Merge carbon-project-tools back into carbon-lang (#203) 5 years ago
.gitignore 07cee1b82a Switch to the Bazel disk cache (locally and in CI). (#579) 4 years ago
.pre-commit-config.yaml db0de1004f Trying to get scripts to use hermetic clang-format (#1180) 4 years ago
.prettierrc.yaml a768b0ee19 Adjust copyrights based on carbon-project-tools/#3 (#171) 5 years ago
BUILD d550256c93 Delete the website and references (#782) 4 years ago
CODEOWNERS fa984743bf Update CODEOWNERS for the carbon-leads switch (#458) 5 years ago
CODE_OF_CONDUCT.md 24b763c7e8 Fix or remove invalid anchor links, adding pre-commit (#997) 4 years ago
CONTRIBUTING.md a13cecccc6 Updates docs for community changes (#489) 5 years ago
LICENSE 7e81d1c213 Fix typo 'langauge'. 5 years ago
README.md 9c0675d2b4 Work on wording around interop tradeoffs (#1185) 4 years ago
WORKSPACE 22462a0d7f Carbon fuzzing 3/3: added actual fuzzer implementation and a fuzzverter utility for investigating crashing protos (#1156) 4 years ago
bazel-execroot e440b07eb3 Improve correctness of our Clang tooling infrastructure. (#392) 5 years ago
compile_flags.txt e476373d28 Cleanup the new dependencies and our tooling setup. (#943) 4 years ago
pyproject.toml a768b0ee19 Adjust copyrights based on carbon-project-tools/#3 (#171) 5 years ago
setup.cfg 797a33df02 Fix flake8 config (#1181) 4 years ago

README.md

Carbon language

The Carbon Language project is an experiment exploring a future direction for the C++ programming language.

Carbon goals | Carbon and C++ | Take a look | Join us

<img src="docs/images/quicksort_snippet.svg" align="right" width="575"

 alt="Quicksort code in Carbon. Follow the link to read more.">

**Fast and works with C++**
  • Performance matching C++ using LLVM, with low-level access to bits and addresses
  • Interoperate with your existing C++ code, from inheritance to templates
  • Fast and scalable builds that work with your existing C++ build systems

Modern and evolving

  • Solid language foundations that are easy to learn, especially if you have used C++
  • Easy, tool-based upgrades between Carbon versions
  • Safer fundamentals, and an incremental path towards a memory-safe subset

Welcoming open-source community

  • Clear goals and priorities with robust governance
  • Community that works to be welcoming, inclusive, and friendly
  • Batteries-included approach: compiler, libraries, docs, tools, package manager, and more

Carbon goals

We believe Carbon must support:

  1. Performance-critical software
  2. Software and language evolution
  3. Code that is easy to read, understand, and write
  4. Practical safety and testing mechanisms
  5. Fast and scalable development
  6. Modern OS platforms, hardware architectures, and environments
  7. Interoperability with and migration from existing C++ code

While many languages share subsets of these goals, what distinguishes Carbon is their combination. For the Carbon project, they are prioritized in the above order to help make clear what tradeoffs we intend to make. However, each and every goal remains critically important: Carbon must have excellent C++ interoperability and migration to be successful.

Read the language overview for more on the language design itself, and the goals for more on these values.

Carbon and C++

If you're already a C++ developer, Carbon should have a short learning curve. It is built out of a consistent set of language constructs that should feel familiar. C++ code like this:

<img src="docs/images/cpp_snippet.svg" width="600"

 alt="A snippet of C++ code. Follow the link to read it.">

can be mechanically transformed to Carbon, like so:

<img src="docs/images/carbon_snippet.svg" width="600"

 alt="A snippet of converted Carbon code. Follow the link to read it.">

without loss of performance or readability. Yet, translating C++ to Carbon isn't necessary; you can call Carbon from C++ without overhead and the other way around. You can port your library to Carbon, or write new Carbon on top of your existing C++ investment. Carbon won't add a sea of dependencies or slow down your performance-critical code. For example:

<img src="docs/images/mixed_snippet.svg" width="600"

 alt="A snippet of mixed Carbon and C++ code. Follow the link to read it.">

In terms of safety, any language that can seamlessly call C++ will not be perfectly safe in every dimension. However, Carbon's design encourages you to use safe constructs where possible.

Ultimately, C++ carries a significant historical legacy, including around ABI stability, that constrains its evolution. Carbon is an attempt to set a new direction for C++ developers that allows for fast development, flexibility, and delight without sacrificing performance, interoperability, and familiarity.

Read more about C++ interop in Carbon.

Take a look

Learn more about Carbon's design:

Join us

Carbon is committed to a welcoming and inclusive environment where everyone can contribute.