1
0
mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-01-24 02:20:03 +08:00
SpaceVim/docs/layers/lang/c.md
2020-09-29 00:35:18 +08:00

104 lines
2.2 KiB
Markdown

---
title: "SpaceVim lang#c layer"
description: "C/C++/Object-C language support for SpaceVim, include code completion, jump to definition, quick runner."
---
# [Available Layers](../../) >> lang#c
<!-- vim-markdown-toc GFM -->
- [Description](#description)
- [Install](#install)
- [Features](#features)
- [Configuration](#configuration)
- [Key bindings](#key-bindings)
<!-- vim-markdown-toc -->
## Description
`lang#c` layer provides c/c++/object-c language support for SpaceVim.
## Install
To use this configuration layer, update the custom configuration file with:
```toml
[[layers]]
name = "lang#c"
```
## Features
- code completion
- syntax checking
- formatting
## Configuration
- `enable_clang_syntax_highlight` (boolean)
Enable/Disable clang based syntax highlighting.
- `clang_executable` (string)
Set the path to the clang executable
- `libclang_path` (string)
The libclang shared object (dynamic library) file path. By default it is empty.
- `clang_std` (dict)
A dict containing the standards you want to use. The default is:
```json
{
"c": "c11",
"cpp": "c++1z",
"objc": "c11",
"objcpp": "c++1z",
}
```
- `clang_flag` (list)
You should be able to just paste most of your compile flags in there.
You can also use a list ['-Iwhatever', ...] when loading this layer.
Here is an example how to use above options:
```toml
[[layers]]
name = "lang#c"
clang_executable = "/usr/bin/clang"
clang_flag = ['-I/user/include']
[layer.clang_std]
c = "c11"
cpp = "c++1z"
objc = "c11"
objcpp = "c++1z"
```
Instead of using `clang_flag` options, You can also create a `.clang` file
in the root directory of your project. SpaceVim will load the options
defined in `.clang` file. For example:
```
-std=c11
-I/home/test
```
Note: If `.clang` file contains std configuration, it will override
`clang_std` layer option.
## Key bindings
| key bindings | Descriptions |
| ------------ | ---------------------------- |
| `SPC l d` | show documentation |
| `SPC l e` | rename symbol |
| `SPC l f` | references |
| `SPC l r` | compile and run current file |
| `g d` | defintion preview |