---
name: "brlapi_writeBrlDots"
section: "3"
platform: "linux"
package: "libbrlapi-dev"
version: "3.4.1-4"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/brlapi_write"
---

# brlapi\_writeBrlDots(3)

write text to the braille display

Part of [brlapi\_write(3)](/brlapi_write/3.md).

## NAME

Writing on the braille display - write text to the braille display

### Functions

int **brlapi\_writeBrl** (uint32\_t cursor, const char \*str)\
 int **brlapi\_writeBrlDots** (const char \*dots)\

## Detailed Description

Once **brlapi\_getTty()** was called, the application can call **brlapi\_writeBrl()** to write things on the braille display.

**Note:**

Be sure to call **brlapi\_getTty()** *before* calling brlapi\_write\*(), or else you'll get an error. This is particularly not always trivial when writing multithreaded applications.

## Function Documentation

### int brlapi\_writeBrl (uint32\_t cursor, const char \* str)

Write the given \\0-terminated string to the braille display

If the string is too long, it is cut. If it's too short, spaces are appended.

**Parameters:**

*cursor* gives the cursor position; if less than or equal to 0 or greater than the display width, no cursor is shown at all; \
 *str* points on the string to be displayed.

**Returns:**

0 on success, -1 on error.

### int brlapi\_writeBrlDots (const char \* dots)

Write the given dots array to the display

**Parameters:**

*dots* points on an array of dot information, one per character. Its size must hence be the same as what **brlapi\_getDisplaySize()** returns.

**Returns:**

0 on success, -1 on error.