From: Josh Coalson <jcoalson@users.sourceforce.net>
Date: Wed, 24 Sep 2003 04:20:07 +0000 (+0000)
Subject: add OggFLAC__stream_decoder_get_resolved_state_string()
X-Git-Tag: 1.2.0~1030
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=03140c4291b9395a59bfcb2a025461dc5e9fc9bc;p=platform%2Fupstream%2Fflac.git

add OggFLAC__stream_decoder_get_resolved_state_string()
---

diff --git a/include/OggFLAC/stream_decoder.h b/include/OggFLAC/stream_decoder.h
index 9d9ed9f..c75eb66 100644
--- a/include/OggFLAC/stream_decoder.h
+++ b/include/OggFLAC/stream_decoder.h
@@ -440,6 +440,19 @@ OggFLAC_API OggFLAC__StreamDecoderState OggFLAC__stream_decoder_get_state(const
  */
 OggFLAC_API FLAC__StreamDecoderState OggFLAC__stream_decoder_get_FLAC_stream_decoder_state(const OggFLAC__StreamDecoder *decoder);
 
+/** Get the current decoder state as a C string.
+ *  This version automatically resolves
+ *  \c OggFLAC__STREAM_DECODER_FLAC_STREAM_DECODER_ERROR
+ *  by getting the FLAC stream decoder's state.
+ *
+ * \param  decoder  A decoder instance to query.
+ * \assert
+ *    \code decoder != NULL \endcode
+ * \retval const char *
+ *    The decoder state as a C string.  Do not modify the contents.
+ */
+OggFLAC_API const char *OggFLAC__stream_decoder_get_resolved_state_string(const OggFLAC__StreamDecoder *decoder);
+
 /** This is inherited from FLAC__StreamDecoder; see FLAC__stream_decoder_get_channels()
  *
  * \param  decoder  A decoder instance to query.