<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>SphinxBase: include/sphinxbase/pio.h Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="navtree.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="navtree.js"></script> <script type="text/javascript" src="resize.js"></script> <script type="text/javascript"> $(document).ready(initResizable); </script> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">SphinxBase <span id="projectnumber">0.6</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> </div> <div id="side-nav" class="ui-resizable side-nav-resizable"> <div id="nav-tree"> <div id="nav-tree-contents"> </div> </div> <div id="splitbar" style="-moz-user-select:none;" class="ui-resizable-handle"> </div> </div> <script type="text/javascript"> initNavTree('pio_8h.html',''); </script> <div id="doc-content"> <div class="header"> <div class="headertitle"> <h1>include/sphinxbase/pio.h</h1> </div> </div> <div class="contents"> <a href="pio_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* -*- c-basic-offset: 4; indent-tabs-mode: nil -*- */</span> <a name="l00002"></a>00002 <span class="comment">/* ====================================================================</span> <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 1999-2004 Carnegie Mellon University. All rights</span> <a name="l00004"></a>00004 <span class="comment"> * reserved.</span> <a name="l00005"></a>00005 <span class="comment"> *</span> <a name="l00006"></a>00006 <span class="comment"> * Redistribution and use in source and binary forms, with or without</span> <a name="l00007"></a>00007 <span class="comment"> * modification, are permitted provided that the following conditions</span> <a name="l00008"></a>00008 <span class="comment"> * are met:</span> <a name="l00009"></a>00009 <span class="comment"> *</span> <a name="l00010"></a>00010 <span class="comment"> * 1. Redistributions of source code must retain the above copyright</span> <a name="l00011"></a>00011 <span class="comment"> * notice, this list of conditions and the following disclaimer. </span> <a name="l00012"></a>00012 <span class="comment"> *</span> <a name="l00013"></a>00013 <span class="comment"> * 2. Redistributions in binary form must reproduce the above copyright</span> <a name="l00014"></a>00014 <span class="comment"> * notice, this list of conditions and the following disclaimer in</span> <a name="l00015"></a>00015 <span class="comment"> * the documentation and/or other materials provided with the</span> <a name="l00016"></a>00016 <span class="comment"> * distribution.</span> <a name="l00017"></a>00017 <span class="comment"> *</span> <a name="l00018"></a>00018 <span class="comment"> * This work was supported in part by funding from the Defense Advanced </span> <a name="l00019"></a>00019 <span class="comment"> * Research Projects Agency and the National Science Foundation of the </span> <a name="l00020"></a>00020 <span class="comment"> * United States of America, and the CMU Sphinx Speech Consortium.</span> <a name="l00021"></a>00021 <span class="comment"> *</span> <a name="l00022"></a>00022 <span class="comment"> * THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY ``AS IS'' AND </span> <a name="l00023"></a>00023 <span class="comment"> * ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, </span> <a name="l00024"></a>00024 <span class="comment"> * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR</span> <a name="l00025"></a>00025 <span class="comment"> * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY</span> <a name="l00026"></a>00026 <span class="comment"> * NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span> <a name="l00027"></a>00027 <span class="comment"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT </span> <a name="l00028"></a>00028 <span class="comment"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, </span> <a name="l00029"></a>00029 <span class="comment"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY </span> <a name="l00030"></a>00030 <span class="comment"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT </span> <a name="l00031"></a>00031 <span class="comment"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE </span> <a name="l00032"></a>00032 <span class="comment"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span> <a name="l00033"></a>00033 <span class="comment"> *</span> <a name="l00034"></a>00034 <span class="comment"> * ====================================================================</span> <a name="l00035"></a>00035 <span class="comment"> *</span> <a name="l00036"></a>00036 <span class="comment"> */</span> <a name="l00037"></a>00037 <span class="comment">/*</span> <a name="l00038"></a>00038 <span class="comment"> * pio.h -- Packaged I/O routines.</span> <a name="l00039"></a>00039 <span class="comment"> *</span> <a name="l00040"></a>00040 <span class="comment"> * **********************************************</span> <a name="l00041"></a>00041 <span class="comment"> * CMU ARPA Speech Project</span> <a name="l00042"></a>00042 <span class="comment"> *</span> <a name="l00043"></a>00043 <span class="comment"> * Copyright (c) 1999 Carnegie Mellon University.</span> <a name="l00044"></a>00044 <span class="comment"> * ALL RIGHTS RESERVED.</span> <a name="l00045"></a>00045 <span class="comment"> * **********************************************</span> <a name="l00046"></a>00046 <span class="comment"> * </span> <a name="l00047"></a>00047 <span class="comment"> * HISTORY</span> <a name="l00048"></a>00048 <span class="comment"> * $Log: pio.h,v $</span> <a name="l00049"></a>00049 <span class="comment"> * Revision 1.3 2005/06/22 08:00:09 arthchan2003</span> <a name="l00050"></a>00050 <span class="comment"> * Completed all doxygen documentation on file description for libs3decoder/libutil/libs3audio and programs.</span> <a name="l00051"></a>00051 <span class="comment"> *</span> <a name="l00052"></a>00052 <span class="comment"> * Revision 1.2 2005/06/22 03:09:52 arthchan2003</span> <a name="l00053"></a>00053 <span class="comment"> * 1, Fixed doxygen documentation, 2, Added keyword.</span> <a name="l00054"></a>00054 <span class="comment"> *</span> <a name="l00055"></a>00055 <span class="comment"> * Revision 1.2 2005/06/16 00:14:08 archan</span> <a name="l00056"></a>00056 <span class="comment"> * Added const keyword to file argument for file_open</span> <a name="l00057"></a>00057 <span class="comment"> *</span> <a name="l00058"></a>00058 <span class="comment"> * Revision 1.1 2005/06/15 06:11:03 archan</span> <a name="l00059"></a>00059 <span class="comment"> * sphinx3 to s3.generic: change io.[ch] to pio.[ch]</span> <a name="l00060"></a>00060 <span class="comment"> *</span> <a name="l00061"></a>00061 <span class="comment"> * Revision 1.5 2005/06/15 04:21:46 archan</span> <a name="l00062"></a>00062 <span class="comment"> * 1, Fixed doxygen-documentation, 2, Add keyword such that changes will be logged into a file.</span> <a name="l00063"></a>00063 <span class="comment"> *</span> <a name="l00064"></a>00064 <span class="comment"> * Revision 1.4 2005/04/20 03:49:32 archan</span> <a name="l00065"></a>00065 <span class="comment"> * Add const to string argument of myfopen.</span> <a name="l00066"></a>00066 <span class="comment"> *</span> <a name="l00067"></a>00067 <span class="comment"> * Revision 1.3 2005/03/30 01:22:48 archan</span> <a name="l00068"></a>00068 <span class="comment"> * Fixed mistakes in last updates. Add</span> <a name="l00069"></a>00069 <span class="comment"> *</span> <a name="l00070"></a>00070 <span class="comment"> * </span> <a name="l00071"></a>00071 <span class="comment"> * 08-Dec-1999 M K Ravishankar (rkm@cs.cmu.edu) at Carnegie Mellon University</span> <a name="l00072"></a>00072 <span class="comment"> * Added stat_mtime().</span> <a name="l00073"></a>00073 <span class="comment"> * </span> <a name="l00074"></a>00074 <span class="comment"> * 11-Mar-1999 M K Ravishankar (rkm@cs.cmu.edu) at Carnegie Mellon University</span> <a name="l00075"></a>00075 <span class="comment"> * Added _myfopen() and myfopen macro.</span> <a name="l00076"></a>00076 <span class="comment"> * </span> <a name="l00077"></a>00077 <span class="comment"> * 05-Sep-97 M K Ravishankar (rkm@cs.cmu.edu) at Carnegie Mellon University</span> <a name="l00078"></a>00078 <span class="comment"> * Started.</span> <a name="l00079"></a>00079 <span class="comment"> */</span> <a name="l00080"></a>00080 <a name="l00081"></a>00081 <a name="l00082"></a>00082 <span class="preprocessor">#ifndef _LIBUTIL_IO_H_</span> <a name="l00083"></a>00083 <span class="preprocessor"></span><span class="preprocessor">#define _LIBUTIL_IO_H_</span> <a name="l00084"></a>00084 <span class="preprocessor"></span> <a name="l00085"></a>00085 <span class="preprocessor">#include <stdio.h></span> <a name="l00086"></a>00086 <span class="preprocessor">#if !defined(_WIN32_WCE) && !(defined(__ADSPBLACKFIN__) && !defined(__linux__))</span> <a name="l00087"></a>00087 <span class="preprocessor"></span><span class="preprocessor">#include <sys/stat.h></span> <a name="l00088"></a>00088 <span class="preprocessor">#endif</span> <a name="l00089"></a>00089 <span class="preprocessor"></span> <a name="l00090"></a>00090 <span class="comment">/* Win32/WinCE DLL gunk */</span> <a name="l00091"></a>00091 <span class="preprocessor">#include <sphinxbase/sphinxbase_export.h></span> <a name="l00092"></a>00092 <span class="preprocessor">#include <sphinxbase/prim_type.h></span> <a name="l00093"></a>00093 <a name="l00104"></a>00104 <span class="preprocessor">#ifdef __cplusplus</span> <a name="l00105"></a>00105 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> { <a name="l00106"></a>00106 <span class="preprocessor">#endif</span> <a name="l00107"></a>00107 <span class="preprocessor"></span><span class="preprocessor">#if 0</span> <a name="l00108"></a>00108 <span class="preprocessor"></span><span class="comment">/* Fool Emacs. */</span> <a name="l00109"></a>00109 } <a name="l00110"></a>00110 <span class="preprocessor">#endif</span> <a name="l00111"></a>00111 <span class="preprocessor"></span> <a name="l00116"></a>00116 SPHINXBASE_EXPORT <a name="l00117"></a>00117 FILE *<a class="code" href="pio_8h.html#aa3d71506049eb49cf03eff1b89ef281f" title="Like fopen, but use popen and zcat if it is determined that &quot;file&quot; is compressed (i...">fopen_comp</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *file, <a name="l00118"></a>00118 <span class="keyword">const</span> <span class="keywordtype">char</span> *mode, <a name="l00119"></a>00119 int32 *ispipe <a name="l00121"></a>00121 ); <a name="l00122"></a>00122 <a name="l00126"></a>00126 SPHINXBASE_EXPORT <a name="l00127"></a>00127 <span class="keywordtype">void</span> <a class="code" href="pio_8h.html#a87592c3a2d0a00eed9eda014950beb65" title="Close a file opened using fopen_comp.">fclose_comp</a> (FILE *fp, <a name="l00128"></a>00128 int32 ispipe <a name="l00130"></a>00130 ); <a name="l00131"></a>00131 <a name="l00136"></a>00136 SPHINXBASE_EXPORT <a name="l00137"></a>00137 FILE *<a class="code" href="pio_8h.html#addfd26392f118f811584721b8d4854ce" title="Open a file for reading, but if file not present try to open compressed version (if file is uncompres...">fopen_compchk</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *file, <a name="l00138"></a>00138 int32 *ispipe <a name="l00140"></a>00140 ); <a name="l00141"></a>00141 <a name="l00145"></a>00145 SPHINXBASE_EXPORT <a name="l00146"></a>00146 FILE *<a class="code" href="pio_8h.html#aa22301f25d56be607c9ff45f2c935b14" title="Wrapper around fopen to check for failure and E_FATAL if failed.">_myfopen</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *file, <span class="keyword">const</span> <span class="keywordtype">char</span> *mode, <a name="l00147"></a>00147 <span class="keyword">const</span> <span class="keywordtype">char</span> *pgm, int32 line); <span class="comment">/* In: __FILE__, __LINE__ from where called */</span> <a name="l00148"></a>00148 <span class="preprocessor">#define myfopen(file,mode) _myfopen((file),(mode),__FILE__,__LINE__)</span> <a name="l00149"></a>00149 <span class="preprocessor"></span> <a name="l00150"></a>00150 <a name="l00158"></a>00158 SPHINXBASE_EXPORT <a name="l00159"></a>00159 int32 <a class="code" href="pio_8h.html#a601277430d3221bf1906bb879ae26d3e" title="NFS file reads seem to fail now and then.">fread_retry</a>(<span class="keywordtype">void</span> *pointer, int32 size, int32 num_items, FILE *stream); <a name="l00160"></a>00160 <a name="l00171"></a>00171 SPHINXBASE_EXPORT <a name="l00172"></a>00172 <span class="keywordtype">char</span> *<a class="code" href="pio_8h.html#a11e0daa4f315d01c2e030d3a0abe702c" title="Read a line of arbitrary length from a file and return it as a newly allocated string.">fread_line</a>(FILE *stream, <span class="keywordtype">size_t</span> *out_len); <a name="l00173"></a>00173 <a name="l00177"></a><a class="code" href="structlineiter__t.html">00177</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structlineiter__t.html" title="Line iterator for files.">lineiter_t</a> { <a name="l00178"></a>00178 <span class="keywordtype">char</span> *buf; <a name="l00179"></a>00179 <span class="keywordtype">size_t</span> bsiz; <a name="l00180"></a>00180 <span class="keywordtype">size_t</span> len; <a name="l00181"></a>00181 FILE *fh; <a name="l00182"></a>00182 } <a class="code" href="pio_8h.html#a3437935bf372acd79fa68b8f9754fa69" title="Line iterator for files.">lineiter_t</a>; <a name="l00183"></a>00183 <a name="l00187"></a>00187 SPHINXBASE_EXPORT <a name="l00188"></a>00188 <a class="code" href="structlineiter__t.html" title="Line iterator for files.">lineiter_t</a> *<a class="code" href="pio_8h.html#a22d0125ab198f02f8bbe543417d99566" title="Start reading lines from a file.">lineiter_start</a>(FILE *fh); <a name="l00189"></a>00189 <a name="l00193"></a>00193 SPHINXBASE_EXPORT <a name="l00194"></a>00194 <a class="code" href="structlineiter__t.html" title="Line iterator for files.">lineiter_t</a> *<a class="code" href="pio_8h.html#aff8df0b6928746d61b3520555263f71e" title="Move to the next line in the file.">lineiter_next</a>(<a class="code" href="structlineiter__t.html" title="Line iterator for files.">lineiter_t</a> *li); <a name="l00195"></a>00195 <a name="l00199"></a>00199 SPHINXBASE_EXPORT <a name="l00200"></a>00200 <span class="keywordtype">void</span> <a class="code" href="pio_8h.html#a3f80e5d4d666426cef229dd41237d9cf" title="Stop reading lines from a file.">lineiter_free</a>(<a class="code" href="structlineiter__t.html" title="Line iterator for files.">lineiter_t</a> *li); <a name="l00201"></a>00201 <a name="l00202"></a>00202 <a name="l00203"></a>00203 <span class="preprocessor">#ifdef _WIN32_WCE</span> <a name="l00204"></a>00204 <span class="preprocessor"></span><span class="comment">/* Fake this for WinCE which has no stat() */</span> <a name="l00205"></a>00205 <span class="preprocessor">#include <windows.h></span> <a name="l00206"></a>00206 <span class="keyword">struct </span>stat { <a name="l00207"></a>00207 DWORD st_mtime; <a name="l00208"></a>00208 DWORD st_size; <a name="l00209"></a>00209 }; <a name="l00210"></a>00210 <span class="preprocessor">#endif </span><span class="comment">/* _WIN32_WCE */</span> <a name="l00211"></a>00211 <a name="l00212"></a>00212 <span class="preprocessor">#if defined(__ADSPBLACKFIN__) && !defined(__linux__)</span> <a name="l00213"></a>00213 <span class="preprocessor"></span><span class="keyword">struct </span>stat { <a name="l00214"></a>00214 int32 st_mtime; <a name="l00215"></a>00215 int32 st_size; <a name="l00216"></a>00216 }; <a name="l00217"></a>00217 <a name="l00218"></a>00218 <span class="preprocessor">#endif</span> <a name="l00219"></a>00219 <span class="preprocessor"></span> <a name="l00223"></a><a class="code" href="pio_8h.html#ae72c3bec19638da72dad3849f75c0cd9">00223</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structbit__encode__s.html">bit_encode_s</a> <a class="code" href="structbit__encode__s.html">bit_encode_t</a>; <a name="l00224"></a>00224 <a name="l00228"></a>00228 <a class="code" href="structbit__encode__s.html">bit_encode_t</a> *<a class="code" href="pio_8h.html#a82e4694a4c13c96550f2410f8c63b1f5" title="Attach bitstream encoder to a file.">bit_encode_attach</a>(FILE *outfh); <a name="l00229"></a>00229 <a name="l00233"></a>00233 <a class="code" href="structbit__encode__s.html">bit_encode_t</a> *<a class="code" href="pio_8h.html#ada6d9bb75e08493cde00d396dae088f1" title="Retain pointer to a bit encoder.">bit_encode_retain</a>(<a class="code" href="structbit__encode__s.html">bit_encode_t</a> *be); <a name="l00234"></a>00234 <a name="l00240"></a>00240 <span class="keywordtype">int</span> <a class="code" href="pio_8h.html#a8330637520174419771670ed740c9049" title="Release pointer to a bit encoder.">bit_encode_free</a>(<a class="code" href="structbit__encode__s.html">bit_encode_t</a> *be); <a name="l00241"></a>00241 <a name="l00245"></a>00245 <span class="keywordtype">int</span> <a class="code" href="pio_8h.html#a59d83bd5850d9ec58175c566d6d48f71" title="Write bits to encoder.">bit_encode_write</a>(<a class="code" href="structbit__encode__s.html">bit_encode_t</a> *be, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> <span class="keyword">const</span> *bits, <span class="keywordtype">int</span> nbits); <a name="l00246"></a>00246 <a name="l00250"></a>00250 <span class="keywordtype">int</span> <a class="code" href="pio_8h.html#ae71dedb663c8e3ae8b91dbfbc95ac420" title="Write lowest-order bits of codeword to encoder.">bit_encode_write_cw</a>(<a class="code" href="structbit__encode__s.html">bit_encode_t</a> *be, uint32 codeword, <span class="keywordtype">int</span> nbits); <a name="l00251"></a>00251 <a name="l00255"></a>00255 <span class="keywordtype">int</span> <a class="code" href="pio_8h.html#a3e818645e567961225977a1923debc3d" title="Flush any unwritten bits, zero-padding if necessary.">bit_encode_flush</a>(<a class="code" href="structbit__encode__s.html">bit_encode_t</a> *be); <a name="l00256"></a>00256 <a name="l00266"></a>00266 SPHINXBASE_EXPORT <a name="l00267"></a>00267 int32 <a class="code" href="pio_8h.html#a0ba35509687e80ee65ba731c7cfcad9b" title="There is no bitstream decoder, because a stream abstraction is too slow.">stat_retry</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *file, <span class="keyword">struct</span> stat *statbuf); <a name="l00268"></a>00268 <a name="l00273"></a>00273 SPHINXBASE_EXPORT <a name="l00274"></a>00274 int32 <a class="code" href="pio_8h.html#a289e3a1582ab60563ae0689979992669" title="Return time of last modification for the given file, or -1 if stat fails.">stat_mtime</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *file); <a name="l00275"></a>00275 <a name="l00281"></a>00281 SPHINXBASE_EXPORT <a name="l00282"></a>00282 <span class="keywordtype">int</span> <a class="code" href="pio_8h.html#a6df697b8a08cd4d11fe7b864dcb99012" title="Create a directory and all of its parent directories, as needed.">build_directory</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *path); <a name="l00283"></a>00283 <a name="l00284"></a>00284 <span class="preprocessor">#ifdef __cplusplus</span> <a name="l00285"></a>00285 <span class="preprocessor"></span>} <a name="l00286"></a>00286 <span class="preprocessor">#endif</span> <a name="l00287"></a>00287 <span class="preprocessor"></span> <a name="l00288"></a>00288 <span class="preprocessor">#endif</span> </pre></div></div> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="pio_8h.html">pio.h</a> </li> <li class="footer">Generated on Tue Apr 19 2011 for SphinxBase by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </li> </ul> </div> </body> </html>