roar_str2codec(3) debian man page | unix.com

roar_str2codec(3)					System Manager's Manual: RoarAudio					 roar_str2codec(3)

NAME
       roar_str2codec - Get codec ID by codec name

       roar_codec2str - Get codec name by ID

SYNOPSIS
	#include <roaraudio.h>

	int    roar_str2codec (char * codec);
	char * roar_codec2str (int    codec);

DESCRIPTION
       roar_str2codec converts a string to a RoarAudio Codec ID. It also supports some common aliases.	roar_codec2str is the reverse operation of
       roar_str2codec: It get's a name by the ID given.  If a codec is valid the following should be true:
	roar_str2codec(roar_codec2str(codec)) == codec

       Note that because of aliasing and case insensitivity the revers operation needs not to be true.

THREAD SAFETY
       Because roar_codec2str returns a static unique pointer for each codec it is fully thread safe.

RETURN VALUE
       On success roar_str2codec returns a codec ID.  On error, -1 is returned.  roar_codec2str returns the name of the codec or  NULL	on  error.
       You must not free this pointer or write to it.

EXAMPLES
       FIXME

SEE ALSO
       libroar(7), RoarAudio(7).

RoarAudio							     May 2011							 roar_str2codec(3)