array_allocate(3) [debian man page]

array_allocate(3)					     Library Functions Manual						 array_allocate(3)

NAME

       array_allocate - make sure array has at least n elements allocated

SYNTAX

       #include <array.h>

       void* array_allocate(array* x, uint64 membersize, int64 pos);

	 array x;
	 int64 pos;
	 t* p = array_allocate(&x,sizeof(t),pos);

DESCRIPTION

       array_allocate  makes sure that enough bytes are allocated in x for at least pos+1 objects of type t. (The size of t must be positive; oth-
       erwise the effects are undefined.) If not enough bytes are allocated (or x is unallocated), array_allocate allocates more bytes, moving the
       dynamically allocated region if necessary.  array_allocate often allocates somewhat more bytes than necessary, to save time later.

       array_allocate  then  makes sure that the number of bytes initialized covers at least those pos+1 objects. If not enough bytes are initial-
       ized, array_allocate initializes more bytes (setting them to 0), up to exactly the end of the pos+1st object.

       array_allocate then returns a pointer to the pos+1st object; i.e., object number pos, with objects numbered starting at 0. This pointer can
       be  used  to  change  or  inspect  the  object.	The  pointer  can  continue to be used through subsequent calls to array_get, array_start,
       array_length, and array_bytes, but it must not be used after any other operations on this array.

       If something goes wrong, array_allocate returns 0, setting errno appropriately, without touching x. In particular, array_allocate returns 0
       if

       o      x has failed, or

       o      pos is negative, or

       o      not enough memory is available.

       array_allocate does not change x to have failed; if you want to do that, use array_fail.

SEE ALSO

       array_get(3), array_start(3), array_fail(3)

																 array_allocate(3)

Decoder(3pm)						User Contributed Perl Documentation					      Decoder(3pm)

NAME

       Audio::FLAC::Decoder - An object-oriented FLAC decoder

SYNOPSIS

	 use Audio::FLAC::Decoder;
	 my $decoder = Audio::FLAC::Decoder->open("song.flac");
	 my $buffer;
	 while ((my $len = $decoder->sysread($buffer) > 0) {
	   # do something with the PCM stream
	 }

	 OR

	 open FLAC, "song.flac" or die $!;
	 my $decoder = Audio::FLAC::Decoder->open(*FLAC);

	 OR

	 # can also be IO::Socket or any other IO::Handle subclass.
	 my $fh = IO::Handle->new("song.flac");
	 my $decoder = Audio::FLAC::Decoder->open($fh);

DESCRIPTION

       This module provides users with Decoder objects for FLAC files.	One can read data in PCM format from the stream, seek by pcm samples, or
       time.

CONSTRUCTOR

   "open ($filename)"
       Opens an FLAC file for decoding. It opens a handle to the file or uses an existing handle and initializes all of the internal FLAC decoding
       structures.  Note that the object will maintain open file descriptors until the object is collected by the garbage handler. Returns "undef"
       on failure.

INSTANCE METHODS

   "sysread ($buffer, [$size])"
       Reads PCM data from the FLAC stream into $buffer.  Returns the number of bytes read, 0 when it reaches the end of the stream, or a value
       less than 0 on error.  The optional size can specify how many bytes to read.

   "raw_seek ($pos)"
       Seeks through the compressed bitstream to the offset specified by $pos in raw bytes.  Returns 0 on success.

   "sample_seek ($pos)"
       Seeks through the bitstream to the offset specified by $pos in pcm samples. Returns 0 on success.

   "time_seek ($pos, [$page])"
       Seeks through the bitstream to the offset specified by $pos in seconds. Returns 0 on success.

   "bitrate ([$stream])"
       Returns the average bitrate for the specified logical bitstream.  If $stream is left out or set to -1, the average bitrate for the entire
       stream will be reported.

   "time_total ([$stream])"
       Returns the total number of seconds in the bitstream.

   "raw_tell ()"
       Returns the current offset in bytes.

   "time_tell ()"
       Returns the current offset in seconds. - NOT YET IMPLEMENTED

REQUIRES

       libFLAC

COPYRIGHT

       Copyright (c) 2004-2008, Dan Sully.  All Rights Reserved.

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

SEE ALSO

       Audio::FLAC::Header

perl v5.14.2							    2008-11-24							      Decoder(3pm)