---
name: "libcaca-style"
section: "3caca"
platform: "linux"
package: "libcaca"
version: "0.99.beta20-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libcaca-style"
---

# libcaca-style(3caca)

Libcaca coding style

## NAME

libcaca-style - Libcaca coding style

## General guidelines

A pretty safe rule of thumb is: look at what has already been done and try to do the same.

- •

  Tabulations should be avoided and replaced with *eight* spaces.

- •

  Indentation is generally 4 spaces.

- •

  Lines should wrap at most at 79 characters.

- •

  Do not leave whitespace at the end of lines.

- •

  Do not use multiple spaces for anything else than indentation.

- •

  Code qui fait des warnings == code de porc == deux baffes dans ta gueule

## C coding style

Try to use short names whenever possible (i for indices, w for width, cv for canvas...). Macros are always uppercase, variable and function names are always lowercase. Use the underscore to separate words within names:

```
#define BROKEN 0
#define MAX(x, y) ((x > y) ? (x) : (y))
unsigned int x, y, w, h;
char *font_name;
void frobulate_every_three_seconds(void);
```

const is a *suffix*. It's char const \*foo, not const char \*foo.

Use spaces after commas and between operators. Do not use spaces after an opening parenthesis or before a closing one:

```
a += 2;
b = (a * (c + d));
x = min(x1, x2, x3);
```

Do not put a space between functions and the corresponding opening parenthesis:

```
int function(int);
```

A space can be inserted after keywords such as for, while or if, but consistency with the rest of the page is encouraged:

```
if(a == b)
    return;
if (p == NULL)
```

Do not put parentheses around return values:

```
return a + (b & x) + d[10];
```

Opening braces should be on a line of their own, aligned with the current block. Braces are optional for one-liners:

```
int function(int a)
{
    if(a & 0x84)
        return a;
    if(a < 0)
    {
        return -a;
    }
    else
    {
        a /= 2;
        switch(a)
        {
            case 0:
            case 1:
                return -1;
                break;
            default:
                return a;
        }
    }
}
```

## C++ coding style

Nothing here yet.