---
name: "lqr_carver_list_start"
section: "3"
platform: "linux"
package: "liblqr-1-0-dev"
version: "0.4.1-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/lqr_carver_list_start"
---

# lqr\_carver\_list\_start(3)

get the staritng point of the attachement list in an LqrCarver object

## NAME

lqr\_carver\_list\_start - get the staritng point of the attachement list in an LqrCarver object

## SYNOPSIS

```
#include <lqr.h>
```

**LqrCarverList\* lqr\_carver\_list\_start(LqrCarver\*** *carver***);**

## DESCRIPTION

The function **lqr\_carver\_list\_start** returns the stating point of the LqrCarverList object associated with the LqrCarver object pointed to by *carver*, which is used to keep track of the LqrCarver objects attached to it.

The returned value is NULL if there are no attached carvers.

Use the functions [**lqr\_carver\_list\_current**(3)](/lqr_carver_list_current/3.md) and [**lqr\_carver\_list\_next**(3)](/lqr_carver_list_next/3.md) to access the list element individually, or the function [**lqr\_carver\_list\_foreach**(3)](/lqr_carver_list_foreach/3.md) to operate on whole lists.

## SEE ALSO

[**lqr\_carver\_attach**(3)](/lqr_carver_attach/3.md), [**lqr\_carver\_list\_current**(3)](/lqr_carver_list_current/3.md), [**lqr\_carver\_list\_next**(3)](/lqr_carver_list_next/3.md), [**lqr\_carver\_list\_foreach**(3)](/lqr_carver_list_foreach/3.md)

## COPYRIGHT

Copyright © 2007-2009 Carlo Baldassi\