---
name: "roar_vs_meta"
section: "3"
platform: "linux"
package: "libroar-dev"
version: "1.0~beta12-4"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/roar_vs_meta"
---

# roar\_vs\_meta(3)

Update meta data for a stream

## NAME

roar\_vs\_meta - Update meta data for a stream

## SYNOPSIS

\#include \<roaraudio.h\>

int     roar\_vs\_meta          (roar\_vs\_t \* vss, struct roar\_keyval \* kv, size\_t len, int \* error);

## DESCRIPTION

This function updates meta data of the stream. This should be done before any read or write operation and can be used at any time to update the meta data.

## PARAMETERS

- **vss**

  The VS object to be updated.

- **kv**

  An array of meta data elements.

- **len**

  Length of array **kv**.

- **error**

  This is a pointer to a integer used to store the error value in case of error. This can be NULL if not used but it is very recommended to use this error value to report good error messages to the user.

## RETURN VALUE

On success these calls return 0.  On error, -1 is returned.

## EXAMPLES

 struct roar\_keyval kv\[2\] = {\
   {.key = "TITLE",  .value = "Some title"},\
   {.key = "ARTIST", .value = "Some artist"}\
  };\
  ret = roar\_vs\_meta(vss, &kv, 2, &err);

## SEE ALSO

[**roarvs**(7)](/roarvs/7.md), [**libroar**(7)](/libroar/7.md), [**RoarAudio**(7)](/RoarAudio/7.md).