---
name: "buffer_getline"
section: "3"
platform: "linux"
package: "libowfat-dev"
version: "0.32-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/buffer_getline"
---

# buffer\_getline(3)

read line from buffer

## NAME

buffer\_getline - read line from buffer

## SYNTAX

**#include \<libowfat/buffer.h\>**

ssize\_t **buffer\_getline**(buffer\* *b*,char\* *x*,size\_t *len*);

## DESCRIPTION

buffer\_getline copies data from *b* to *x*\[0\], *x*\[1\], ..., *x*\[*len*-1\] until *len* bytes have been copied or a new-line character ('\\n') is encountered.  That character is also copied.

Note that line is not 0-terminated to make reading lines with 0-bytes possible through this interface.

## RETURN VALUE

Number of bytes read (without '\\n'), -1 on error (setting *errno*).

## SEE ALSO

[buffer\_init(3)](/buffer_init/3.md), [buffer\_feed(3)](/buffer_feed/3.md), [buffer\_peek(3)](/buffer_peek/3.md), [buffer\_seek(3)](/buffer_seek/3.md), [buffer(3)](/buffer/3.md)