---
name: "buffer_getline"
section: "3diet"
platform: "linux"
package: "libowfat-dev"
version: "0.28-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/buffer_getline/3diet"
---

# buffer\_getline(3diet)

read line from buffer

## NAME

buffer\_getline - read line from buffer

## SYNTAX

**#include \<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)