\hypertarget{group__Eet__File__Group}{}\section{Eet File Main Functions}
\label{group__Eet__File__Group}\index{Eet File Main Functions@{Eet File Main Functions}}


Functions to create, destroy and do basic manipulation of \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} handles.  


\subsection*{Modules}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Eet__File__Cipher__Group}{Eet File Ciphered Main Functions}
\begin{DoxyCompactList}\small\item\em Most of the \hyperlink{group__Eet__File__Group}{Eet File Main Functions} have alternative versions that accounts for ciphers to protect their content. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Data Structures}
\begin{DoxyCompactItemize}
\item 
struct \hyperlink{struct__Eet__Entry}{\+\_\+\+Eet\+\_\+\+Entry}
\end{DoxyCompactItemize}
\subsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga24b2559f539042a2414a9fed47b8e911}\label{group__Eet__File__Group_ga24b2559f539042a2414a9fed47b8e911}} 
\#define {\bfseries E\+E\+T\+\_\+\+I\+M\+A\+G\+E\+\_\+\+L\+O\+S\+S\+L\+E\+SS}~E\+M\+I\+L\+E\+\_\+\+I\+M\+A\+G\+E\+\_\+\+L\+O\+S\+S\+L\+E\+SS
\item 
\mbox{\Hypertarget{group__Eet__File__Group_gad7a958d8561297c24ea035548e5bccb4}\label{group__Eet__File__Group_gad7a958d8561297c24ea035548e5bccb4}} 
\#define {\bfseries E\+E\+T\+\_\+\+I\+M\+A\+G\+E\+\_\+\+J\+P\+EG}~E\+M\+I\+L\+E\+\_\+\+I\+M\+A\+G\+E\+\_\+\+J\+P\+EG
\item 
\mbox{\Hypertarget{group__Eet__File__Group_gab00cdecb86b126af82e831409485e88b}\label{group__Eet__File__Group_gab00cdecb86b126af82e831409485e88b}} 
\#define {\bfseries E\+E\+T\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C1}~E\+M\+I\+L\+E\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C1
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga6f0325bc074b1a11004aa3d5c5484004}\label{group__Eet__File__Group_ga6f0325bc074b1a11004aa3d5c5484004}} 
\#define {\bfseries E\+E\+T\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C2\+\_\+\+R\+GB}~E\+M\+I\+L\+E\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C2\+\_\+\+R\+GB
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga9ed3bf8d75fd2ab88ccedcbb0d1e6564}\label{group__Eet__File__Group_ga9ed3bf8d75fd2ab88ccedcbb0d1e6564}} 
\#define {\bfseries E\+E\+T\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C2\+\_\+\+R\+G\+BA}~E\+M\+I\+L\+E\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C2\+\_\+\+R\+G\+BA
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga8ab2b3d77315d1eceb72afc1d4386772}\label{group__Eet__File__Group_ga8ab2b3d77315d1eceb72afc1d4386772}} 
\#define {\bfseries E\+E\+T\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C1\+\_\+\+A\+L\+P\+HA}~E\+M\+I\+L\+E\+\_\+\+I\+M\+A\+G\+E\+\_\+\+E\+T\+C1\+\_\+\+A\+L\+P\+HA
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga098bb8eac2734aad31f7598e20b195f5}\label{group__Eet__File__Group_ga098bb8eac2734aad31f7598e20b195f5}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+A\+R\+G\+B8888}~\hyperlink{group__Emile__Image__Group_gga6bbda446d5ddf75fd911fbc0dff6876fa063317d9465b70ef466bd0c6e466caa9}{E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+A\+R\+G\+B8888}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_gaa326066dd666e89d363018f630699a2d}\label{group__Eet__File__Group_gaa326066dd666e89d363018f630699a2d}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+G\+R\+Y8}~E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+G\+R\+Y8
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga7204c6542a0ee5faf02a0cdb5add8ddd}\label{group__Eet__File__Group_ga7204c6542a0ee5faf02a0cdb5add8ddd}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+A\+G\+R\+Y88}~\hyperlink{group__Emile__Image__Group_gga6bbda446d5ddf75fd911fbc0dff6876fa3c0600b436f608f0809fff5adfa541a3}{E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+A\+G\+R\+Y88}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga37a12528c21639d5bd5a5e772a3a5b2e}\label{group__Eet__File__Group_ga37a12528c21639d5bd5a5e772a3a5b2e}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+E\+T\+C1}~\hyperlink{group__Emile__Image__Group_gga6bbda446d5ddf75fd911fbc0dff6876fa1033c7d2c7aca562859d2e3aef609989}{E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+E\+T\+C1}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga778dcc5c34a12df218420cfd6309451b}\label{group__Eet__File__Group_ga778dcc5c34a12df218420cfd6309451b}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+R\+G\+B8\+\_\+\+E\+T\+C2}~\hyperlink{group__Emile__Image__Group_gga6bbda446d5ddf75fd911fbc0dff6876fad3319deeb70798b8138eb24f788d92b4}{E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+R\+G\+B8\+\_\+\+E\+T\+C2}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga2245f1492b0e03fcdce401356dbbf032}\label{group__Eet__File__Group_ga2245f1492b0e03fcdce401356dbbf032}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+R\+G\+B\+A8\+\_\+\+E\+T\+C2\+\_\+\+E\+AC}~\hyperlink{group__Emile__Image__Group_gga6bbda446d5ddf75fd911fbc0dff6876fa5efb8e475746b3b748c5db143ce57032}{E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+R\+G\+B\+A8\+\_\+\+E\+T\+C2\+\_\+\+E\+AC}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_gadf95731a21b5be273ff56d94b1eaddbe}\label{group__Eet__File__Group_gadf95731a21b5be273ff56d94b1eaddbe}} 
\#define {\bfseries E\+E\+T\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+E\+T\+C1\+\_\+\+A\+L\+P\+HA}~\hyperlink{group__Emile__Image__Group_gga6bbda446d5ddf75fd911fbc0dff6876fadb771419dcfe343f10db016b862d3bc8}{E\+M\+I\+L\+E\+\_\+\+C\+O\+L\+O\+R\+S\+P\+A\+C\+E\+\_\+\+E\+T\+C1\+\_\+\+A\+L\+P\+HA}
\end{DoxyCompactItemize}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef enum \hyperlink{group__Eet__File__Group_gaa8e1a7af50fefaf15eb2f69543d24998}{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode} \hyperlink{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}{Eet\+\_\+\+File\+\_\+\+Mode}
\begin{DoxyCompactList}\small\item\em Modes that a file can be opened. \end{DoxyCompactList}\item 
\mbox{\Hypertarget{group__Eet__File__Group_gaa5d4e899fede583cd76dd0c36671ebd6}\label{group__Eet__File__Group_gaa5d4e899fede583cd76dd0c36671ebd6}} 
typedef \hyperlink{group__Emile__Image__Group_ga3dcc86fe594217afb40befc71d0a6d8a}{Emile\+\_\+\+Image\+\_\+\+Encoding} {\bfseries Eet\+\_\+\+Image\+\_\+\+Encoding}
\item 
\mbox{\Hypertarget{group__Eet__File__Group_gaa453e4518293646ce103a4cb33d71533}\label{group__Eet__File__Group_gaa453e4518293646ce103a4cb33d71533}} 
typedef \hyperlink{group__Emile__Image__Group_gae4022652475a28417c2780ad5217c8f4}{Emile\+\_\+\+Colorspace} {\bfseries Eet\+\_\+\+Colorspace}
\item 
typedef struct \+\_\+\+Eet\+\_\+\+File \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File}
\begin{DoxyCompactList}\small\item\em Opaque handle that defines an Eet file (or memory). \end{DoxyCompactList}\item 
\mbox{\Hypertarget{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}\label{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}} 
typedef struct \+\_\+\+Eet\+\_\+\+Dictionary \hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary}
\begin{DoxyCompactList}\small\item\em Opaque handle that defines a file-\/backed (mmaped) dictionary of strings. \end{DoxyCompactList}\item 
\mbox{\Hypertarget{group__Eet__File__Group_ga7d77ade0697b902580b3fb9b7942444e}\label{group__Eet__File__Group_ga7d77ade0697b902580b3fb9b7942444e}} 
typedef struct \hyperlink{struct__Eet__Entry}{\+\_\+\+Eet\+\_\+\+Entry} {\bfseries Eet\+\_\+\+Entry}
\end{DoxyCompactItemize}
\subsection*{Enumerations}
\begin{DoxyCompactItemize}
\item 
enum \hyperlink{group__Eet__File__Group_gaa8e1a7af50fefaf15eb2f69543d24998}{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode} \{ \newline
{\bfseries E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+I\+N\+V\+A\+L\+ID} = -\/1, 
\newline
\hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a416f7e9a76b8131a44bbeedb13060c81}{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD}, 
\newline
\hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a8f395f56fba48be007c65be51d799ee9}{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE}, 
\newline
\hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a763d29c19960a4e0d4eb7bc7bb512481}{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE}
 \}\begin{DoxyCompactList}\small\item\em Modes that a file can be opened. \end{DoxyCompactList}
\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\+\_\+open} (const char $\ast$file, \hyperlink{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}{Eet\+\_\+\+File\+\_\+\+Mode} mode)
\begin{DoxyCompactList}\small\item\em Open an eet file on disk, and returns a handle to it. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ \hyperlink{group__Eet__File__Group_ga56037051d2338fb69b4f1ce2d7365246}{eet\+\_\+mmap} (const \hyperlink{group__Eina__File__Group_ga20697123547cbc937c6c9dd845af0403}{Eina\+\_\+\+File} $\ast$file)
\begin{DoxyCompactList}\small\item\em Open an eet file on disk from an Eina\+\_\+\+File handle, and returns a handle to it. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ \hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\+\_\+memopen\+\_\+read} (const void $\ast$data, size\+\_\+t size)
\begin{DoxyCompactList}\small\item\em Open an eet file directly from a memory location. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}{Eet\+\_\+\+File\+\_\+\+Mode} \hyperlink{group__Eet__File__Group_ga806f64e7ad3463cd40337c5022c7e83c}{eet\+\_\+mode\+\_\+get} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Get the mode an Eet\+\_\+\+File was opened with. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__Group_gab002b16c58e2a62fc7981581647a0092}{Eet\+\_\+\+Error} \hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\+\_\+close} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Close an eet file handle and flush pending writes. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__Group_gab002b16c58e2a62fc7981581647a0092}{Eet\+\_\+\+Error} \hyperlink{group__Eet__File__Group_gaf343f344180955ed898aa86b90ebefda}{eet\+\_\+sync} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Sync content of an eet file handle, flushing pending writes. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary} $\ast$ \hyperlink{group__Eet__File__Group_gab45ad39596d2fb54a88fda93e7fa0b0f}{eet\+\_\+dictionary\+\_\+get} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Return a handle to the shared string dictionary of the Eet file. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int \hyperlink{group__Eet__File__Group_ga53290da52edb929b85e51f25e79d27c8}{eet\+\_\+dictionary\+\_\+string\+\_\+check} (\hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary} $\ast$ed, const char $\ast$string)
\begin{DoxyCompactList}\small\item\em Check if a given string comes from a given dictionary. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int \hyperlink{group__Eet__File__Group_ga1cadbf9178be9abf9578e429f93bc0a6}{eet\+\_\+dictionary\+\_\+count} (const \hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary} $\ast$ed)
\begin{DoxyCompactList}\small\item\em Return the number of strings inside a dictionary. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} void $\ast$ \hyperlink{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}{eet\+\_\+read} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$name, int $\ast$size\+\_\+ret)
\begin{DoxyCompactList}\small\item\em Read a specified entry from an eet file and return data. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} const void $\ast$ \hyperlink{group__Eet__File__Group_ga73852ab3d1276c2913715b3716cf4a04}{eet\+\_\+read\+\_\+direct} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$name, int $\ast$size\+\_\+ret)
\begin{DoxyCompactList}\small\item\em Read a specified entry from an eet file and return data. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int \hyperlink{group__Eet__File__Group_ga682d04715f0e11380c460814c4a9bd21}{eet\+\_\+write} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$name, const void $\ast$data, int size, int compress)
\begin{DoxyCompactList}\small\item\em Write a specified entry to an eet file handle. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int \hyperlink{group__Eet__File__Group_gaa8a980d684123dfbaf12e7efefdb57f5}{eet\+\_\+delete} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Delete a specified entry from an Eet file being written or re-\/written. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Eet__File__Group_ga8b73391dcfad6b71ae1cabe90a020f03}{eet\+\_\+alias} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$name, const char $\ast$destination, int compress)
\begin{DoxyCompactList}\small\item\em Alias a specific section to another one. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} const char $\ast$ \hyperlink{group__Eet__File__Group_gae6d5a64ad113443dd781fdf3ef57d4a5}{eet\+\_\+file\+\_\+get} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Retrieve the filename of an Eet\+\_\+\+File. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} const char $\ast$ \hyperlink{group__Eet__File__Group_ga06908aef2f65f1270839534e28b304b0}{eet\+\_\+alias\+\_\+get} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Retrieve the destination name of an alias. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} char $\ast$$\ast$ \hyperlink{group__Eet__File__Group_ga6700a425f59086e7c8a945d6923874d3}{eet\+\_\+list} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef, const char $\ast$glob, int $\ast$count\+\_\+ret)
\begin{DoxyCompactList}\small\item\em List all entries in eet file matching shell glob. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eina__Iterator__Group_ga15b975bb881d955249ce13d4ebc96948}{Eina\+\_\+\+Iterator} $\ast$ \hyperlink{group__Eet__File__Group_ga117c6d9d1c78d1791478b549118521ea}{eet\+\_\+list\+\_\+entries} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Return an iterator that will describe each entry of an Eet\+\_\+\+File. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int \hyperlink{group__Eet__File__Group_ga53bf1cf96267787aa93a99a0fe7ba8f7}{eet\+\_\+num\+\_\+entries} (\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$ef)
\begin{DoxyCompactList}\small\item\em Return the number of entries in the specified eet file. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Functions to create, destroy and do basic manipulation of \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} handles. 

This sections explains how to use the most basic Eet functions, which are used to work with eet files, read data from them, store it back in or take a look at what entries it contains, without making use of the serialization capabilities explained in \hyperlink{group__Eet__Data__Group}{Eet Data Serialization}.

The following example will serve as an introduction to most, if not all, of these functions.

If you are only using Eet, this is the only header you need to include.  
\begin{DoxyCodeInclude}
\textcolor{preprocessor}{#include <\hyperlink{Eet_8h}{Eet.h}>}

\end{DoxyCodeInclude}


Now let\textquotesingle{}s create ourselves an eet file to play with. The following function shows step by step how to open a file and write some data in it. First, we define our file handler and some other things we\textquotesingle{}ll put in it. 
\begin{DoxyCodeInclude}
   \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\_File} *ef;
   \textcolor{keywordtype}{char} buf[1024], *ptr;
   \textcolor{keywordtype}{int} size, len, i;
   \textcolor{keyword}{const} \textcolor{keywordtype}{char} *some\_strings[] = \{
      \textcolor{stringliteral}{"And some more strings"},
      \textcolor{stringliteral}{"spread across several"},
      \textcolor{stringliteral}{"elements of an array!"}
   \};
   \textcolor{keyword}{const} \textcolor{keywordtype}{char} some\_data[] =
     \textcolor{stringliteral}{"\(\backslash\)x1e\(\backslash\)xe7\(\backslash\)x0f\(\backslash\)x42\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x01\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x35"}
     \textcolor{stringliteral}{"\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)xa0\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)xa0\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x24\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x11"}
     \textcolor{stringliteral}{"\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x00\(\backslash\)x2f\(\backslash\)x6d\(\backslash\)x69\(\backslash\)x73\(\backslash\)x74\(\backslash\)x65\(\backslash\)x72\(\backslash\)x69\(\backslash\)x6f\(\backslash\)x75\(\backslash\)x73\(\backslash\)x2f"}
     \textcolor{stringliteral}{"\(\backslash\)x64\(\backslash\)x61\(\backslash\)x74\(\backslash\)x61\(\backslash\)x00\(\backslash\)x41\(\backslash\)x6e\(\backslash\)x20\(\backslash\)x45\(\backslash\)x45\(\backslash\)x54\(\backslash\)x20\(\backslash\)x69\(\backslash\)x6e\(\backslash\)x73\(\backslash\)x69"}
     \textcolor{stringliteral}{"\(\backslash\)x64\(\backslash\)x65\(\backslash\)x20\(\backslash\)x6f\(\backslash\)x66\(\backslash\)x20\(\backslash\)x61\(\backslash\)x6e\(\backslash\)x20\(\backslash\)x45\(\backslash\)x45\(\backslash\)x54\(\backslash\)x21\(\backslash\)x0a\(\backslash\)x54\(\backslash\)x68"}
     \textcolor{stringliteral}{"\(\backslash\)x69\(\backslash\)x73\(\backslash\)x20\(\backslash\)x77\(\backslash\)x61\(\backslash\)x73\(\backslash\)x6e\(\backslash\)x27\(\backslash\)x74\(\backslash\)x20\(\backslash\)x72\(\backslash\)x65\(\backslash\)x61\(\backslash\)x6c\(\backslash\)x6c\(\backslash\)x79"}
     \textcolor{stringliteral}{"\(\backslash\)x20\(\backslash\)x75\(\backslash\)x73\(\backslash\)x65\(\backslash\)x66\(\backslash\)x75\(\backslash\)x6c\(\backslash\)x20\(\backslash\)x62\(\backslash\)x75\(\backslash\)x74\(\backslash\)x20\(\backslash\)x69\(\backslash\)x74\(\backslash\)x20\(\backslash\)x68"}
     \textcolor{stringliteral}{"\(\backslash\)x65\(\backslash\)x6c\(\backslash\)x70\(\backslash\)x65\(\backslash\)x64\(\backslash\)x20\(\backslash\)x74\(\backslash\)x6f\(\backslash\)x20\(\backslash\)x73\(\backslash\)x68\(\backslash\)x6f\(\backslash\)x77\(\backslash\)x20\(\backslash\)x68\(\backslash\)x6f"}
     \textcolor{stringliteral}{"\(\backslash\)x77\(\backslash\)x0a\(\backslash\)x74\(\backslash\)x6f\(\backslash\)x20\(\backslash\)x75\(\backslash\)x73\(\backslash\)x65\(\backslash\)x20\(\backslash\)x65\(\backslash\)x65\(\backslash\)x74\(\backslash\)x5f\(\backslash\)x6d\(\backslash\)x65\(\backslash\)x6d"}
     \textcolor{stringliteral}{"\(\backslash\)x6f\(\backslash\)x70\(\backslash\)x65\(\backslash\)x6e\(\backslash\)x5f\(\backslash\)x72\(\backslash\)x65\(\backslash\)x61\(\backslash\)x64\(\backslash\)x28\(\backslash\)x29\(\backslash\)x20\(\backslash\)x74\(\backslash\)x6f\(\backslash\)x20\(\backslash\)x6f"}
     \textcolor{stringliteral}{"\(\backslash\)x70\(\backslash\)x65\(\backslash\)x6e\(\backslash\)x20\(\backslash\)x61\(\backslash\)x6e\(\backslash\)x20\(\backslash\)x65\(\backslash\)x65\(\backslash\)x74\(\backslash\)x20\(\backslash\)x66\(\backslash\)x69\(\backslash\)x6c\(\backslash\)x65\(\backslash\)x20"}
     \textcolor{stringliteral}{"\(\backslash\)x66\(\backslash\)x72\(\backslash\)x6f\(\backslash\)x6d\(\backslash\)x0a\(\backslash\)x64\(\backslash\)x61\(\backslash\)x74\(\backslash\)x61\(\backslash\)x20\(\backslash\)x61\(\backslash\)x6c\(\backslash\)x72\(\backslash\)x65\(\backslash\)x61\(\backslash\)x64"}
     \textcolor{stringliteral}{"\(\backslash\)x79\(\backslash\)x20\(\backslash\)x6c\(\backslash\)x6f\(\backslash\)x61\(\backslash\)x64\(\backslash\)x65\(\backslash\)x64\(\backslash\)x20\(\backslash\)x69\(\backslash\)x6e\(\backslash\)x20\(\backslash\)x6d\(\backslash\)x65\(\backslash\)x6d\(\backslash\)x6f"}
     \textcolor{stringliteral}{"\(\backslash\)x72\(\backslash\)x79\(\backslash\)x2e\(\backslash\)x0a\(\backslash\)x00"};

\end{DoxyCodeInclude}


We open a new file in write mode, and if it fails, we just return, since there\textquotesingle{}s not much more we can do about it.. 
\begin{DoxyCodeInclude}
   ef = \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\_open}(\textcolor{stringliteral}{"/tmp/my\_file.eet"}, \hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a8f395f56fba48be007c65be51d799ee9}{EET\_FILE\_MODE\_WRITE});
   \textcolor{keywordflow}{if} (!ef) \textcolor{keywordflow}{return} 0;

\end{DoxyCodeInclude}


Now, we need to write some data in our file. For now, strings will suffice, so let\textquotesingle{}s just dump a bunch of them in there. 
\begin{DoxyCodeInclude}

   strcpy(buf, \textcolor{stringliteral}{"Here is a string of data to save!"});
   size = \hyperlink{group__Eet__File__Group_ga682d04715f0e11380c460814c4a9bd21}{eet\_write}(ef, \textcolor{stringliteral}{"/key/to\_store/at"}, buf, \textcolor{keyword}{sizeof}(buf), 1);
   \textcolor{keywordflow}{if} (!size)
     \{
        fprintf(stderr, \textcolor{stringliteral}{"Error writing data!\(\backslash\)n"});
        \hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\_close}(ef);
        \textcolor{keywordflow}{return} 0;
     \}

\end{DoxyCodeInclude}


As you can see, we copied a string into our static buffer, which is a bit bigger than the full length of the string, and then told Eet to write it into the file, compressed, returning the size of the data written into the file. This is all to show that Eet treats data as just data. It doesn\textquotesingle{}t matter what that data represents (for now), it\textquotesingle{}s all just bytes for it. As running the following code will show, we took a string of around 30 bytes and put it in a buffer of 1024 bytes, but the returned size won\textquotesingle{}t be any of those. 
\begin{DoxyCodeInclude}
   len = strlen(buf);
   printf(\textcolor{stringliteral}{"strlen() = %d, eet\_write() = %d\(\backslash\)n"}, len, size);

\end{DoxyCodeInclude}


Next, we copy into our buffer our set of strings, including their null terminators and write them into the file. No error checking for the sake of brevity. And a call to \hyperlink{group__Eet__File__Group_gaf343f344180955ed898aa86b90ebefda}{eet\+\_\+sync()} to make sure all out data is properly written down to disk, even though we haven\textquotesingle{}t yet closed the file. 
\begin{DoxyCodeInclude}

   ptr = buf;
   \textcolor{keywordflow}{for} (i = 0; i < 3; i++)
     \{
        len = strlen(some\_strings[i]) + 1;
        memcpy(ptr, some\_strings[i], len);
        ptr += len;
     \}
   \hyperlink{group__Eet__File__Group_ga682d04715f0e11380c460814c4a9bd21}{eet\_write}(ef, \textcolor{stringliteral}{"/several/strings"}, buf, \textcolor{keyword}{sizeof}(buf), 1);
   \hyperlink{group__Eet__File__Group_gaf343f344180955ed898aa86b90ebefda}{eet\_sync}(ef);

\end{DoxyCodeInclude}


One more write, this time our large array of binary data and... well, I couldn\textquotesingle{}t come up with a valid use of the last set of strings we stored, so let\textquotesingle{}s take it out from the file with \hyperlink{group__Eet__File__Group_gaa8a980d684123dfbaf12e7efefdb57f5}{eet\+\_\+delete()}. 
\begin{DoxyCodeInclude}

   \hyperlink{group__Eet__File__Group_ga682d04715f0e11380c460814c4a9bd21}{eet\_write}(ef, \textcolor{stringliteral}{"/some/mysterious/data"}, some\_data, \textcolor{keyword}{sizeof}(some\_data) - 1, 1);

   \hyperlink{group__Eet__File__Group_gaa8a980d684123dfbaf12e7efefdb57f5}{eet\_delete}(ef, \textcolor{stringliteral}{"/several/strings"});

\end{DoxyCodeInclude}


Finally, we close the file, saving any changes back to disk and return. Notice how, if there\textquotesingle{}s any error closing the file or saving its contents, the return value from the function will be a false one, which later on will make the program exit with an error code. 
\begin{DoxyCodeInclude}

   \textcolor{keywordflow}{return} \hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\_close}(ef) == \hyperlink{group__Eet__Group_ggaa9142d865094701672375485d4a6284da2e3af24c66d0decf7c97fe4e5a7f75d4}{EET\_ERROR\_NONE};

\end{DoxyCodeInclude}


Moving onto our main function, we will open the same file and read it back. Trivial, but it\textquotesingle{}ll show how we can do so in more than one way. We\textquotesingle{}ll skip the variable declarations, as they aren\textquotesingle{}t very different from what we\textquotesingle{}ve seen already.

We start from the beginning by initializing Eet so things in general work. Forgetting to do so will result in weird results or crashes when calling any eet function, so if you experience something like that, the first thing to look at is whether \hyperlink{group__Eet__Group_ga9903687bfa20fe9a9e59d4c1d213e89a}{eet\+\_\+init()} is missing. Then we call our {\ttfamily create\+\_\+eet\+\_\+file} function, described above, to make sure we have something to work with. If the function fails it will return 0 and we just exit, since nothing from here onwards will work anyway. 
\begin{DoxyCodeInclude}
   \hyperlink{group__Eet__Group_ga9903687bfa20fe9a9e59d4c1d213e89a}{eet\_init}();

   \textcolor{keywordflow}{if} (!create\_eet\_file())
     \textcolor{keywordflow}{return} -1;

\end{DoxyCodeInclude}


Let\textquotesingle{}s take a look now at what entries our file has. For this, we use \hyperlink{group__Eet__File__Group_ga6700a425f59086e7c8a945d6923874d3}{eet\+\_\+list()}, which will return a list of strings, each being the name of one entry. Since we skipped before, it may be worth noting that {\ttfamily list} is declared as a {\ttfamily char} $\ast$$\ast$. The {\ttfamily num} parameter will, of course, have the number of entries contained in our file. If everything\textquotesingle{}s fine, we\textquotesingle{}ll get our list and print it to the screen, and once done with it, we free the list. That\textquotesingle{}s just the list, not its contents, as they are internal strings used by Eet and trying to free them will surely break things. 
\begin{DoxyCodeInclude}

   ef = \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\_open}(\textcolor{stringliteral}{"/tmp/my\_file.eet"}, \hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a416f7e9a76b8131a44bbeedb13060c81}{EET\_FILE\_MODE\_READ});
   \textcolor{keywordflow}{if} (!ef) \textcolor{keywordflow}{return} -1;

   list = \hyperlink{group__Eet__File__Group_ga6700a425f59086e7c8a945d6923874d3}{eet\_list}(ef, \textcolor{stringliteral}{"*"}, &num);
   \textcolor{keywordflow}{if} (list)
     \{
        \textcolor{keywordflow}{for} (i = 0; i < num; i++)
          printf(\textcolor{stringliteral}{"Key stored: %s\(\backslash\)n"}, list[i]);
        free(list);
     \}

\end{DoxyCodeInclude}


Reading back plain data is simple. Just a call to \hyperlink{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}{eet\+\_\+read()} with the file to read from, and the name of the entry we are interested in. We get back our data and the passed {\ttfamily size} parameter will contain the size of it. If the data was stored compressed, it will decompressed first. 
\begin{DoxyCodeInclude}

   ret = \hyperlink{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}{eet\_read}(ef, \textcolor{stringliteral}{"/key/to\_store/at"}, &size);
   \textcolor{keywordflow}{if} (ret)
     \{
        printf(\textcolor{stringliteral}{"Data read (%i bytes):\(\backslash\)n%s\(\backslash\)n"}, size, ret);
        free(ret);
     \}

\end{DoxyCodeInclude}


Another simple read for the set of strings from before, except those were deleted, so we should get a N\+U\+LL return and continue normally. 
\begin{DoxyCodeInclude}

   ret = \hyperlink{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}{eet\_read}(ef, \textcolor{stringliteral}{"/several/strings"}, &size);
   \textcolor{keywordflow}{if} (ret)
     \{
        printf(\textcolor{stringliteral}{"More data read (%i bytes):\(\backslash\)n%s\(\backslash\)n"}, size, ret);
        free(ret);
     \}

\end{DoxyCodeInclude}


Finally, we\textquotesingle{}ll get our binary data in the same way we got the strings. Once again, it makes no difference for Eet what the data is, it\textquotesingle{}s up to us to know how to handle it. 
\begin{DoxyCodeInclude}

   ret = \hyperlink{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}{eet\_read}(ef, \textcolor{stringliteral}{"/some/mysterious/data"}, &size);
   \textcolor{keywordflow}{if} (ret)
     \{

\end{DoxyCodeInclude}


Now some cheating, we know that this data is an Eet file because, well... we just know it. So we are going to open it and take a look at its insides. For this, \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\+\_\+open()} won\textquotesingle{}t work, as it needs to have a file on disk to read from and all we have is some data in R\+AM.

So how do we do? One way would be to create a normal file and write down our data, then open it with \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\+\_\+open()}. Another, faster and more efficient if all we want to do is read the file, is to use \hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\+\_\+memopen\+\_\+read()}. 
\begin{DoxyCodeInclude}
        \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\_File} *ef2;

        ef2 = \hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\_memopen\_read}(ret, size);

\end{DoxyCodeInclude}


As you can see, the size we got from our previous read was put to good use this time. Unlike the first one where all we had were strings, the size of the data read only serves to demonstrate that we are reading back the entire size of our original {\ttfamily buf} variable.

A little peeking to see how many entries the file has and to make an example of \hyperlink{group__Eet__File__Group_ga53bf1cf96267787aa93a99a0fe7ba8f7}{eet\+\_\+num\+\_\+entries()} to get that number when we don\textquotesingle{}t care about their names. 
\begin{DoxyCodeInclude}

        num = \hyperlink{group__Eet__File__Group_ga53bf1cf96267787aa93a99a0fe7ba8f7}{eet\_num\_entries}(ef2);
        printf(\textcolor{stringliteral}{"Mysterious data has %d entries\(\backslash\)n"}, num);

\end{DoxyCodeInclude}


More cheating follows. Just like we knew this was an Eet file, we also know what key to read from, and ontop of that we know that the data in it is not compressed. Knowing all this allows us to take some shortcuts. 
\begin{DoxyCodeInclude}

        printf(\textcolor{stringliteral}{"Mysterious data:\(\backslash\)n%s\(\backslash\)n"},
               (\textcolor{keywordtype}{char} *)\hyperlink{group__Eet__File__Group_ga73852ab3d1276c2913715b3716cf4a04}{eet\_read\_direct}(ef2, \textcolor{stringliteral}{"/mysterious/data"}, NULL));

\end{DoxyCodeInclude}


That\textquotesingle{}s a direct print of our data, whatever that data is. We don\textquotesingle{}t want to worry about having to free it later, so we just used eet\+\_\+direct\+\_\+read() to tell Eet to gives a pointer to the internal data in the file, without duplicating it. Since we said that data was not compressed, we shouldn\textquotesingle{}t worry about printing garbage to the screen (and yes, we also know the data is yet another string). We also don\textquotesingle{}t care about the size of the data as it was stored in the file, so we passed N\+U\+LL as the size parameter. One very important note about this, however, is that we don\textquotesingle{}t care about the size parameter because the data in the file contains the null terminator for the string. So when using Eet to store strings this way, it\textquotesingle{}s very important to consider whether you will keep that final null byte, or to always get the size read and do the necessary checks and copies. It\textquotesingle{}s up to the user and the particular use cases to decide how this will be done.

With everything done, close this second file and free the data used to open it. And this is important, we can\textquotesingle{}t free that data until we are done with the file, as Eet is using it. When opening with \hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\+\_\+memopen\+\_\+read()}, the data passed to it must be available for as long as the the file is open. 
\begin{DoxyCodeInclude}

        \hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\_close}(ef2);

        free(ret);
     \}

\end{DoxyCodeInclude}


Finally, we close the first file, shutdown all internal resources used by Eet and leave our main function, thus terminating our program. 
\begin{DoxyCodeInclude}

   \hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\_close}(ef);

   \hyperlink{group__Eet__Group_gacbc7583179399d3b3e7b003e911f866f}{eet\_shutdown}();

   \textcolor{keywordflow}{return} 0;

\end{DoxyCodeInclude}


You can look at the full code of the example \hyperlink{eet-file_8c-example}{here}. 

\subsection{Typedef Documentation}
\mbox{\Hypertarget{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}\label{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}} 
\index{Eet File Main Functions@{Eet File Main Functions}!Eet\+\_\+\+File\+\_\+\+Mode@{Eet\+\_\+\+File\+\_\+\+Mode}}
\index{Eet\+\_\+\+File\+\_\+\+Mode@{Eet\+\_\+\+File\+\_\+\+Mode}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{Eet\+\_\+\+File\+\_\+\+Mode}{Eet\_File\_Mode}}
{\footnotesize\ttfamily typedef enum \hyperlink{group__Eet__File__Group_gaa8e1a7af50fefaf15eb2f69543d24998}{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode}  \hyperlink{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}{Eet\+\_\+\+File\+\_\+\+Mode}}



Modes that a file can be opened. 

\mbox{\Hypertarget{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}\label{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}} 
\index{Eet File Main Functions@{Eet File Main Functions}!Eet\+\_\+\+File@{Eet\+\_\+\+File}}
\index{Eet\+\_\+\+File@{Eet\+\_\+\+File}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{Eet\+\_\+\+File}{Eet\_File}}
{\footnotesize\ttfamily \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File}}



Opaque handle that defines an Eet file (or memory). 

This handle will be returned by the functions \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\+\_\+open()} and \hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\+\_\+memopen\+\_\+read()} and is used by every other function that affects the file in any way. When you are done with it, call \hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\+\_\+close()} to close it and, if the file was open for writing, write down to disk any changes made to it.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\+\_\+open()} 

\hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\+\_\+memopen\+\_\+read()} 

\hyperlink{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}{eet\+\_\+close()} 
\end{DoxySeeAlso}


\subsection{Enumeration Type Documentation}
\mbox{\Hypertarget{group__Eet__File__Group_gaa8e1a7af50fefaf15eb2f69543d24998}\label{group__Eet__File__Group_gaa8e1a7af50fefaf15eb2f69543d24998}} 
\index{Eet File Main Functions@{Eet File Main Functions}!\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode@{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode}}
\index{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode@{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode}{\_Eet\_File\_Mode}}
{\footnotesize\ttfamily enum \hyperlink{group__Eet__File__Group_gaa8e1a7af50fefaf15eb2f69543d24998}{\+\_\+\+Eet\+\_\+\+File\+\_\+\+Mode}}



Modes that a file can be opened. 

\begin{DoxyEnumFields}{Enumerator}
\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD@{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD}!Eet File Main Functions@{Eet File Main Functions}}\index{Eet File Main Functions@{Eet File Main Functions}!E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD@{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD}}}\mbox{\Hypertarget{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a416f7e9a76b8131a44bbeedb13060c81}\label{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a416f7e9a76b8131a44bbeedb13060c81}} 
E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD&File is read-\/only. \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE@{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE}!Eet File Main Functions@{Eet File Main Functions}}\index{Eet File Main Functions@{Eet File Main Functions}!E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE@{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE}}}\mbox{\Hypertarget{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a8f395f56fba48be007c65be51d799ee9}\label{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a8f395f56fba48be007c65be51d799ee9}} 
E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE&File is write-\/only. \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE@{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE}!Eet File Main Functions@{Eet File Main Functions}}\index{Eet File Main Functions@{Eet File Main Functions}!E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE@{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE}}}\mbox{\Hypertarget{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a763d29c19960a4e0d4eb7bc7bb512481}\label{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a763d29c19960a4e0d4eb7bc7bb512481}} 
E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE&File is for both read and write. \\
\hline

\end{DoxyEnumFields}


\subsection{Function Documentation}
\mbox{\Hypertarget{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}\label{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+open@{eet\+\_\+open}}
\index{eet\+\_\+open@{eet\+\_\+open}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+open()}{eet\_open()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File}$\ast$ eet\+\_\+open (\begin{DoxyParamCaption}\item[{const char $\ast$}]{file,  }\item[{\hyperlink{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}{Eet\+\_\+\+File\+\_\+\+Mode}}]{mode }\end{DoxyParamCaption})}



Open an eet file on disk, and returns a handle to it. 


\begin{DoxyParams}{Parameters}
{\em file} & The file path to the eet file. eg\+: {\ttfamily \char`\"{}/tmp/file.\+eet\char`\"{}}. \\
\hline
{\em mode} & The mode for opening. Either \hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a416f7e9a76b8131a44bbeedb13060c81}{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD}, \hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a8f395f56fba48be007c65be51d799ee9}{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE} or \hyperlink{group__Eet__File__Group_ggaa8e1a7af50fefaf15eb2f69543d24998a763d29c19960a4e0d4eb7bc7bb512481}{E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE}. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An opened eet file handle.
\end{DoxyReturn}
This function will open an exiting eet file for reading, and build the directory table in memory and return a handle to the file, if it exists and can be read, and no memory errors occur on the way, otherwise N\+U\+LL will be returned.

It will also open an eet file for writing. This will, if successful, delete the original file and replace it with a new empty file, till the eet file handle is closed or flushed. If it cannot be opened for writing or a memory error occurs, N\+U\+LL is returned.

You can also open the file for read/write. If you then write a key that does not exist it will be created, if the key exists it will be replaced by the new data.

If the same file is opened multiple times, then the same file handle will be returned as eet maintains an internal list of all currently open files. Note that it considers files opened for read only and those opened for read/write and write only as 2 separate sets. Those that do not write to the file and those that do. Eet will allow 2 handles to the same file if they are in the 2 separate lists/groups. That means opening a file for read only looks in the read only set, and returns a handle to that file handle and increments its reference count. If you open a file for read/write or write only it looks in the write set and returns a handle after incrementing the reference count. You need to close an eet file handle as many times as it has been opened to maintain correct reference counts. Files whose modified timestamp or size do not match those of the existing referenced file handles will not be returned and a new handle will be returned instead.

\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-basic_8c-example}{eet-\/basic.\+c}, \hyperlink{eet-data-cipher_decipher_8c-example}{eet-\/data-\/cipher\+\_\+decipher.\+c}, \hyperlink{eet-data-file_descriptor_01_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+01.\+c}, \hyperlink{eet-data-file_descriptor_02_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+02.\+c}, \hyperlink{eet-data-nested_8c-example}{eet-\/data-\/nested.\+c}, \hyperlink{eet-data-simple_8c-example}{eet-\/data-\/simple.\+c}, and \hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE, eet\+\_\+sync(), E\+I\+N\+A\+\_\+\+F\+A\+L\+SE, eina\+\_\+file\+\_\+close(), eina\+\_\+file\+\_\+map\+\_\+all(), eina\+\_\+file\+\_\+open(), E\+I\+N\+A\+\_\+\+F\+I\+L\+E\+\_\+\+S\+E\+Q\+U\+E\+N\+T\+I\+AL, eina\+\_\+file\+\_\+size\+\_\+get(), eina\+\_\+stringshare\+\_\+add\+\_\+length(), and E\+I\+N\+A\+\_\+\+T\+R\+UE.



Referenced by edje\+\_\+edit\+\_\+clean\+\_\+save\+\_\+as(), edje\+\_\+edit\+\_\+full\+\_\+source\+\_\+generate(), edje\+\_\+edit\+\_\+group\+\_\+copy(), edje\+\_\+edit\+\_\+group\+\_\+del(), edje\+\_\+edit\+\_\+sound\+\_\+tone\+\_\+del(), and edje\+\_\+edit\+\_\+without\+\_\+source\+\_\+save().

\mbox{\Hypertarget{group__Eet__File__Group_ga56037051d2338fb69b4f1ce2d7365246}\label{group__Eet__File__Group_ga56037051d2338fb69b4f1ce2d7365246}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+mmap@{eet\+\_\+mmap}}
\index{eet\+\_\+mmap@{eet\+\_\+mmap}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+mmap()}{eet\_mmap()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File}$\ast$ eet\+\_\+mmap (\begin{DoxyParamCaption}\item[{const \hyperlink{group__Eina__File__Group_ga20697123547cbc937c6c9dd845af0403}{Eina\+\_\+\+File} $\ast$}]{file }\end{DoxyParamCaption})}



Open an eet file on disk from an Eina\+\_\+\+File handle, and returns a handle to it. 


\begin{DoxyParams}{Parameters}
{\em file} & The Eina\+\_\+\+File handle to map to an eet file. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An opened eet file handle.
\end{DoxyReturn}
This function will open an exiting eet file for reading, and build the directory table in memory and return a handle to the file, if it exists and can be read, and no memory errors occur on the way, otherwise N\+U\+LL will be returned.

This function can\textquotesingle{}t open file for writing only read only mode is supported for now.

If the same file is opened multiple times, then the same file handle will be returned as eet maintains an internal list of all currently open files. That means opening a file for read only looks in the read only set, and returns a handle to that file handle and increments its reference count. You need to close an eet file handle as many times as it has been opened to maintain correct reference counts.

\begin{DoxySince}{Since}
1.\+8.\+0 
\end{DoxySince}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, eet\+\_\+sync(), eina\+\_\+file\+\_\+dup(), eina\+\_\+file\+\_\+filename\+\_\+get(), eina\+\_\+file\+\_\+map\+\_\+all(), E\+I\+N\+A\+\_\+\+F\+I\+L\+E\+\_\+\+S\+E\+Q\+U\+E\+N\+T\+I\+AL, eina\+\_\+file\+\_\+size\+\_\+get(), eina\+\_\+stringshare\+\_\+add(), and E\+I\+N\+A\+\_\+\+T\+R\+UE.



Referenced by edje\+\_\+audio\+\_\+channel\+\_\+mute\+\_\+get().

\mbox{\Hypertarget{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}\label{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+memopen\+\_\+read@{eet\+\_\+memopen\+\_\+read}}
\index{eet\+\_\+memopen\+\_\+read@{eet\+\_\+memopen\+\_\+read}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+memopen\+\_\+read()}{eet\_memopen\_read()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File}$\ast$ eet\+\_\+memopen\+\_\+read (\begin{DoxyParamCaption}\item[{const void $\ast$}]{data,  }\item[{size\+\_\+t}]{size }\end{DoxyParamCaption})}



Open an eet file directly from a memory location. 

The data is not copied, so you must keep it around as long as the eet file is open. There is currently no cache for this kind of Eet\+\_\+\+File, so it\textquotesingle{}s reopened every time you use eet\+\_\+memopen\+\_\+read. 
\begin{DoxyParams}{Parameters}
{\em data} & Address of file in memory. \\
\hline
{\em size} & Size of memory to be read. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A handle to the file.
\end{DoxyReturn}
Files opened this way will always be in read-\/only mode.

\begin{DoxySince}{Since}
1.\+1.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, and E\+I\+N\+A\+\_\+\+F\+A\+L\+SE.

\mbox{\Hypertarget{group__Eet__File__Group_ga806f64e7ad3463cd40337c5022c7e83c}\label{group__Eet__File__Group_ga806f64e7ad3463cd40337c5022c7e83c}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+mode\+\_\+get@{eet\+\_\+mode\+\_\+get}}
\index{eet\+\_\+mode\+\_\+get@{eet\+\_\+mode\+\_\+get}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+mode\+\_\+get()}{eet\_mode\_get()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_gace4c717b4aadfe603183524c18951572}{Eet\+\_\+\+File\+\_\+\+Mode} eet\+\_\+mode\+\_\+get (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Get the mode an Eet\+\_\+\+File was opened with. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The mode ef was opened with.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\mbox{\Hypertarget{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}\label{group__Eet__File__Group_ga1675fef1f6012c1e02ae313d13dc3e03}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+close@{eet\+\_\+close}}
\index{eet\+\_\+close@{eet\+\_\+close}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+close()}{eet\_close()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__Group_gab002b16c58e2a62fc7981581647a0092}{Eet\+\_\+\+Error} eet\+\_\+close (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Close an eet file handle and flush pending writes. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An eet error identifier.
\end{DoxyReturn}
This function will flush any pending writes to disk if the eet file was opened for write, and free all data associated with the file handle and file, and close the file. If it was opened for read (or read/write), the file handle may still be held open internally for caching purposes. To flush speculatively held eet file handles use \hyperlink{group__Eet__Group_ga5b3f70f4842551426befbff648e4094b}{eet\+\_\+clearcache()}.

If the eet file handle is not valid nothing will be done.

\begin{DoxySince}{Since}
1.\+0.\+0
\end{DoxySince}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Eet__Group_ga5b3f70f4842551426befbff648e4094b}{eet\+\_\+clearcache()} 
\end{DoxySeeAlso}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-basic_8c-example}{eet-\/basic.\+c}, \hyperlink{eet-data-cipher_decipher_8c-example}{eet-\/data-\/cipher\+\_\+decipher.\+c}, \hyperlink{eet-data-file_descriptor_01_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+01.\+c}, \hyperlink{eet-data-file_descriptor_02_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+02.\+c}, \hyperlink{eet-data-nested_8c-example}{eet-\/data-\/nested.\+c}, \hyperlink{eet-data-simple_8c-example}{eet-\/data-\/simple.\+c}, and \hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+SE.



Referenced by edje\+\_\+audio\+\_\+channel\+\_\+mute\+\_\+get(), edje\+\_\+edit\+\_\+clean\+\_\+save\+\_\+as(), edje\+\_\+edit\+\_\+full\+\_\+source\+\_\+generate(), edje\+\_\+edit\+\_\+group\+\_\+copy(), edje\+\_\+edit\+\_\+group\+\_\+del(), edje\+\_\+edit\+\_\+sound\+\_\+tone\+\_\+del(), edje\+\_\+edit\+\_\+without\+\_\+source\+\_\+save(), and emotion\+\_\+shutdown().

\mbox{\Hypertarget{group__Eet__File__Group_gaf343f344180955ed898aa86b90ebefda}\label{group__Eet__File__Group_gaf343f344180955ed898aa86b90ebefda}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+sync@{eet\+\_\+sync}}
\index{eet\+\_\+sync@{eet\+\_\+sync}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+sync()}{eet\_sync()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__Group_gab002b16c58e2a62fc7981581647a0092}{Eet\+\_\+\+Error} eet\+\_\+sync (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Sync content of an eet file handle, flushing pending writes. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An eet error identifier.
\end{DoxyReturn}
This function will flush any pending writes to disk. The eet file must be opened for write.

If the eet file handle is not valid nothing will be done.

\begin{DoxySince}{Since}
1.\+2.\+4 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+E\+R\+R\+O\+R\+\_\+\+B\+A\+D\+\_\+\+O\+B\+J\+E\+CT, E\+E\+T\+\_\+\+E\+R\+R\+O\+R\+\_\+\+N\+O\+NE, E\+E\+T\+\_\+\+E\+R\+R\+O\+R\+\_\+\+N\+O\+T\+\_\+\+W\+R\+I\+T\+A\+B\+LE, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE, and E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE.



Referenced by eet\+\_\+clearcache(), eet\+\_\+mmap(), and eet\+\_\+open().

\mbox{\Hypertarget{group__Eet__File__Group_gab45ad39596d2fb54a88fda93e7fa0b0f}\label{group__Eet__File__Group_gab45ad39596d2fb54a88fda93e7fa0b0f}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+dictionary\+\_\+get@{eet\+\_\+dictionary\+\_\+get}}
\index{eet\+\_\+dictionary\+\_\+get@{eet\+\_\+dictionary\+\_\+get}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+dictionary\+\_\+get()}{eet\_dictionary\_get()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary}$\ast$ eet\+\_\+dictionary\+\_\+get (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Return a handle to the shared string dictionary of the Eet file. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A handle to the dictionary of the file
\end{DoxyReturn}
This function returns a handle to the dictionary of an Eet file whose handle is {\ttfamily ef}, if a dictionary exists. N\+U\+LL is returned otherwise or if the file handle is known to be invalid.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Eet__File__Group_ga53290da52edb929b85e51f25e79d27c8}{eet\+\_\+dictionary\+\_\+string\+\_\+check()} to know if given string came from the dictionary or it was dynamically allocated using the \hyperlink{group__Eet__Data__Group_gace5d1ff83e06ad08d15aadef3916082f}{Eet\+\_\+\+Data\+\_\+\+Descriptor\+\_\+\+Class} instructions.
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-data-file_descriptor_01_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+01.\+c}, and \hyperlink{eet-data-file_descriptor_02_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+02.\+c}.\end{Desc}


Referenced by eet\+\_\+data\+\_\+node\+\_\+read\+\_\+cipher(), eet\+\_\+data\+\_\+node\+\_\+write\+\_\+cipher(), eet\+\_\+data\+\_\+read\+\_\+cipher(), eet\+\_\+data\+\_\+read\+\_\+cipher\+\_\+buffer(), and eet\+\_\+data\+\_\+undump\+\_\+cipher().

\mbox{\Hypertarget{group__Eet__File__Group_ga53290da52edb929b85e51f25e79d27c8}\label{group__Eet__File__Group_ga53290da52edb929b85e51f25e79d27c8}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+dictionary\+\_\+string\+\_\+check@{eet\+\_\+dictionary\+\_\+string\+\_\+check}}
\index{eet\+\_\+dictionary\+\_\+string\+\_\+check@{eet\+\_\+dictionary\+\_\+string\+\_\+check}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+dictionary\+\_\+string\+\_\+check()}{eet\_dictionary\_string\_check()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int eet\+\_\+dictionary\+\_\+string\+\_\+check (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary} $\ast$}]{ed,  }\item[{const char $\ast$}]{string }\end{DoxyParamCaption})}



Check if a given string comes from a given dictionary. 


\begin{DoxyParams}{Parameters}
{\em ed} & A valid dictionary handle \\
\hline
{\em string} & A valid 0 byte terminated C string \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
1 if it is in the dictionary, 0 otherwise
\end{DoxyReturn}
This checks the given dictionary to see if the given string is actually inside that dictionary (i.\+e. comes from it) and returns 1 if it does. If the dictionary handle is invalid, the string is N\+U\+LL or the string is not in the dictionary, 0 is returned.

\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-data-file_descriptor_01_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+01.\+c}, and \hyperlink{eet-data-file_descriptor_02_8c-example}{eet-\/data-\/file\+\_\+descriptor\+\_\+02.\+c}.\end{Desc}


References eina\+\_\+spinlock\+\_\+release(), and eina\+\_\+spinlock\+\_\+take().

\mbox{\Hypertarget{group__Eet__File__Group_ga1cadbf9178be9abf9578e429f93bc0a6}\label{group__Eet__File__Group_ga1cadbf9178be9abf9578e429f93bc0a6}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+dictionary\+\_\+count@{eet\+\_\+dictionary\+\_\+count}}
\index{eet\+\_\+dictionary\+\_\+count@{eet\+\_\+dictionary\+\_\+count}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+dictionary\+\_\+count()}{eet\_dictionary\_count()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int eet\+\_\+dictionary\+\_\+count (\begin{DoxyParamCaption}\item[{const \hyperlink{group__Eet__File__Group_gaf0984c8280699ca5a3c4966f5580324c}{Eet\+\_\+\+Dictionary} $\ast$}]{ed }\end{DoxyParamCaption})}



Return the number of strings inside a dictionary. 


\begin{DoxyParams}{Parameters}
{\em ed} & A valid dictionary handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the number of strings inside a dictionary
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+6.\+0 
\end{DoxySince}


References eina\+\_\+convert\+\_\+atod(), eina\+\_\+convert\+\_\+atofp(), E\+I\+N\+A\+\_\+\+F\+A\+L\+SE, eina\+\_\+hash\+\_\+add(), eina\+\_\+hash\+\_\+find(), eina\+\_\+hash\+\_\+int32\+\_\+new(), eina\+\_\+spinlock\+\_\+release(), eina\+\_\+spinlock\+\_\+take(), eina\+\_\+stringshare\+\_\+add(), and E\+I\+N\+A\+\_\+\+T\+R\+UE.

\mbox{\Hypertarget{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}\label{group__Eet__File__Group_gac13cdf7782d1e513f5b1abcc529962f4}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+read@{eet\+\_\+read}}
\index{eet\+\_\+read@{eet\+\_\+read}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+read()}{eet\_read()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} void$\ast$ eet\+\_\+read (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{name,  }\item[{int $\ast$}]{size\+\_\+ret }\end{DoxyParamCaption})}



Read a specified entry from an eet file and return data. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for reading. \\
\hline
{\em name} & Name of the entry. eg\+: \char`\"{}/base/file\+\_\+i\+\_\+want\char`\"{}. \\
\hline
{\em size\+\_\+ret} & Number of bytes read from entry and returned. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The data stored in that entry in the eet file.
\end{DoxyReturn}
This function finds an entry in the eet file that is stored under the name specified, and returns that data, decompressed, if successful. N\+U\+LL is returned if the lookup fails or if memory errors are encountered. It is the job of the calling program to call free() on the returned data. The number of bytes in the returned data chunk are placed in size\+\_\+ret.

If the eet file handle is not valid N\+U\+LL is returned and size\+\_\+ret is filled with 0.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Eet__File__Cipher__Group_gafde124ec4aa3d6ad934e7cc43c24ae3a}{eet\+\_\+read\+\_\+cipher()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-basic_8c-example}{eet-\/basic.\+c}, and \hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References eet\+\_\+read\+\_\+cipher().



Referenced by edje\+\_\+edit\+\_\+clean\+\_\+save\+\_\+as(), and edje\+\_\+edit\+\_\+group\+\_\+copy().

\mbox{\Hypertarget{group__Eet__File__Group_ga73852ab3d1276c2913715b3716cf4a04}\label{group__Eet__File__Group_ga73852ab3d1276c2913715b3716cf4a04}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+read\+\_\+direct@{eet\+\_\+read\+\_\+direct}}
\index{eet\+\_\+read\+\_\+direct@{eet\+\_\+read\+\_\+direct}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+read\+\_\+direct()}{eet\_read\_direct()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} const void$\ast$ eet\+\_\+read\+\_\+direct (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{name,  }\item[{int $\ast$}]{size\+\_\+ret }\end{DoxyParamCaption})}



Read a specified entry from an eet file and return data. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for reading. \\
\hline
{\em name} & Name of the entry. eg\+: \char`\"{}/base/file\+\_\+i\+\_\+want\char`\"{}. \\
\hline
{\em size\+\_\+ret} & Number of bytes read from entry and returned. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The data stored in that entry in the eet file.
\end{DoxyReturn}
This function finds an entry in the eet file that is stored under the name specified, and returns that data if not compressed and successful. N\+U\+LL is returned if the lookup fails or if memory errors are encountered or if the data is compressed. The calling program must never call free() on the returned data. The number of bytes in the returned data chunk are placed in size\+\_\+ret.

If the eet file handle is not valid N\+U\+LL is returned and size\+\_\+ret is filled with 0.

\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE, eina\+\_\+binbuf\+\_\+free(), eina\+\_\+binbuf\+\_\+length\+\_\+get(), eina\+\_\+binbuf\+\_\+string\+\_\+get(), and emile\+\_\+decompress().



Referenced by edje\+\_\+audio\+\_\+channel\+\_\+mute\+\_\+get(), edje\+\_\+edit\+\_\+clean\+\_\+save\+\_\+as(), eet\+\_\+data\+\_\+image\+\_\+colorspace\+\_\+get(), eet\+\_\+data\+\_\+image\+\_\+header\+\_\+read\+\_\+cipher(), eet\+\_\+data\+\_\+image\+\_\+read\+\_\+cipher(), eet\+\_\+data\+\_\+image\+\_\+read\+\_\+to\+\_\+cspace\+\_\+surface\+\_\+cipher(), eet\+\_\+data\+\_\+node\+\_\+read\+\_\+cipher(), eet\+\_\+data\+\_\+read\+\_\+cipher(), and eet\+\_\+data\+\_\+read\+\_\+cipher\+\_\+buffer().

\mbox{\Hypertarget{group__Eet__File__Group_ga682d04715f0e11380c460814c4a9bd21}\label{group__Eet__File__Group_ga682d04715f0e11380c460814c4a9bd21}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+write@{eet\+\_\+write}}
\index{eet\+\_\+write@{eet\+\_\+write}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+write()}{eet\_write()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int eet\+\_\+write (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{name,  }\item[{const void $\ast$}]{data,  }\item[{int}]{size,  }\item[{int}]{compress }\end{DoxyParamCaption})}



Write a specified entry to an eet file handle. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for writing. \\
\hline
{\em name} & Name of the entry. eg\+: \char`\"{}/base/file\+\_\+i\+\_\+want\char`\"{}. \\
\hline
{\em data} & Pointer to the data to be stored. \\
\hline
{\em size} & Length in bytes in the data to be stored. \\
\hline
{\em compress} & Compression flags (1 == compress, 0 = don\textquotesingle{}t compress). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
bytes written on successful write, 0 on failure.
\end{DoxyReturn}
This function will write the specified chunk of data to the eet file and return greater than 0 on success. 0 will be returned on failure.

The eet file handle must be a valid file handle for an eet file opened for writing. If it is not, 0 will be returned and no action will be performed.

Name, and data must not be N\+U\+LL, and size must be $>$ 0. If these conditions are not met, 0 will be returned.

The data will be copied (and optionally compressed) in ram, pending a flush to disk (it will stay in ram till the eet file handle is closed though).

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Eet__File__Cipher__Group_ga0c08a5881d6fd3474a8cbe03a445aff3}{eet\+\_\+write\+\_\+cipher()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-basic_8c-example}{eet-\/basic.\+c}, and \hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References eet\+\_\+write\+\_\+cipher().



Referenced by edje\+\_\+edit\+\_\+clean\+\_\+save\+\_\+as(), edje\+\_\+edit\+\_\+full\+\_\+source\+\_\+generate(), and edje\+\_\+edit\+\_\+group\+\_\+copy().

\mbox{\Hypertarget{group__Eet__File__Group_gaa8a980d684123dfbaf12e7efefdb57f5}\label{group__Eet__File__Group_gaa8a980d684123dfbaf12e7efefdb57f5}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+delete@{eet\+\_\+delete}}
\index{eet\+\_\+delete@{eet\+\_\+delete}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+delete()}{eet\_delete()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int eet\+\_\+delete (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Delete a specified entry from an Eet file being written or re-\/written. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for writing. \\
\hline
{\em name} & Name of the entry. eg\+: \char`\"{}/base/file\+\_\+i\+\_\+want\char`\"{}. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Success or failure of the delete.
\end{DoxyReturn}
This function will delete the specified chunk of data from the eet file and return greater than 0 on success. 0 will be returned on failure.

The eet file handle must be a valid file handle for an eet file opened for writing. If it is not, 0 will be returned and no action will be performed.

Name, must not be N\+U\+LL, otherwise 0 will be returned.

\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD.



Referenced by edje\+\_\+edit\+\_\+full\+\_\+source\+\_\+generate(), and edje\+\_\+edit\+\_\+group\+\_\+del().

\mbox{\Hypertarget{group__Eet__File__Group_ga8b73391dcfad6b71ae1cabe90a020f03}\label{group__Eet__File__Group_ga8b73391dcfad6b71ae1cabe90a020f03}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+alias@{eet\+\_\+alias}}
\index{eet\+\_\+alias@{eet\+\_\+alias}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+alias()}{eet\_alias()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} eet\+\_\+alias (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{name,  }\item[{const char $\ast$}]{destination,  }\item[{int}]{compress }\end{DoxyParamCaption})}



Alias a specific section to another one. 

Destination may exist or not, no checks are done. 
\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for writing. \\
\hline
{\em name} & Name of the new entry. eg\+: \char`\"{}/base/file\+\_\+i\+\_\+want\char`\"{}. \\
\hline
{\em destination} & Actual source of the aliased entry eg\+: \char`\"{}/base/the\+\_\+real\+\_\+stuff\+\_\+i\+\_\+want\char`\"{}. \\
\hline
{\em compress} & Compression flags (1 == compress, 0 = don\textquotesingle{}t compress). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+UE on success, E\+I\+N\+A\+\_\+\+F\+A\+L\+SE on failure.
\end{DoxyReturn}
Name and Destination must not be N\+U\+LL, otherwise E\+I\+N\+A\+\_\+\+F\+A\+L\+SE will be returned. The equivalent of this would be calling \textquotesingle{}ln -\/s destination name\textquotesingle{}

\begin{DoxySince}{Since}
1.\+3.\+3 
\end{DoxySince}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE, eina\+\_\+binbuf\+\_\+manage\+\_\+new(), E\+I\+N\+A\+\_\+\+F\+A\+L\+SE, E\+I\+N\+A\+\_\+\+T\+R\+UE, and emile\+\_\+compress().

\mbox{\Hypertarget{group__Eet__File__Group_gae6d5a64ad113443dd781fdf3ef57d4a5}\label{group__Eet__File__Group_gae6d5a64ad113443dd781fdf3ef57d4a5}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+file\+\_\+get@{eet\+\_\+file\+\_\+get}}
\index{eet\+\_\+file\+\_\+get@{eet\+\_\+file\+\_\+get}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+file\+\_\+get()}{eet\_file\_get()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} const char$\ast$ eet\+\_\+file\+\_\+get (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Retrieve the filename of an Eet\+\_\+\+File. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for writing. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The stringshared file string opened with \hyperlink{group__Eet__File__Group_ga5f55956b860aa2c77af9b1a880c4c256}{eet\+\_\+open()}, or N\+U\+LL on error
\end{DoxyReturn}
\begin{DoxyNote}{Note}
This function will return N\+U\+LL for files opened with \hyperlink{group__Eet__File__Group_gac514fa1812cfe27f0b7c0ff5fc13af45}{eet\+\_\+memopen\+\_\+read()}
\end{DoxyNote}
\begin{DoxySince}{Since}
1.\+6 
\end{DoxySince}
\mbox{\Hypertarget{group__Eet__File__Group_ga06908aef2f65f1270839534e28b304b0}\label{group__Eet__File__Group_ga06908aef2f65f1270839534e28b304b0}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+alias\+\_\+get@{eet\+\_\+alias\+\_\+get}}
\index{eet\+\_\+alias\+\_\+get@{eet\+\_\+alias\+\_\+get}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+alias\+\_\+get()}{eet\_alias\_get()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} const char$\ast$ eet\+\_\+alias\+\_\+get (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Retrieve the destination name of an alias. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle opened for writing \\
\hline
{\em name} & Name of the entry. eg\+: \char`\"{}/base/file\+\_\+i\+\_\+want\char`\"{} \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Destination of the alias. eg\+: \char`\"{}/base/the\+\_\+real\+\_\+stuff\+\_\+i\+\_\+want\char`\"{}, N\+U\+LL on failure
\end{DoxyReturn}
Name must not be N\+U\+LL, otherwise N\+U\+LL will be returned.

\begin{DoxySince}{Since}
1.\+5 
\end{DoxySince}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE, eina\+\_\+binbuf\+\_\+free(), eina\+\_\+binbuf\+\_\+length\+\_\+get(), eina\+\_\+binbuf\+\_\+string\+\_\+get(), eina\+\_\+binbuf\+\_\+string\+\_\+steal(), eina\+\_\+stringshare\+\_\+add(), and emile\+\_\+decompress().

\mbox{\Hypertarget{group__Eet__File__Group_ga6700a425f59086e7c8a945d6923874d3}\label{group__Eet__File__Group_ga6700a425f59086e7c8a945d6923874d3}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+list@{eet\+\_\+list}}
\index{eet\+\_\+list@{eet\+\_\+list}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+list()}{eet\_list()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} char$\ast$$\ast$ eet\+\_\+list (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef,  }\item[{const char $\ast$}]{glob,  }\item[{int $\ast$}]{count\+\_\+ret }\end{DoxyParamCaption})}



List all entries in eet file matching shell glob. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
{\em glob} & A shell glob to match against. \\
\hline
{\em count\+\_\+ret} & Number of entries found to match. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Pointer to an array of strings.
\end{DoxyReturn}
This function will list all entries in the eet file matching the supplied shell glob and return an allocated list of their names, if there are any, and if no memory errors occur.

The eet file handle must be valid and glob must not be N\+U\+LL, or N\+U\+LL will be returned and count\+\_\+ret will be filled with 0.

The calling program must call free() on the array returned, but N\+OT on the string pointers in the array. They are taken as read-\/only internals from the eet file handle. They are only valid as long as the file handle is not closed. When it is closed those pointers in the array are now not valid and should not be used.

On success the array returned will have a list of string pointers that are the names of the entries that matched, and count\+\_\+ret will have the number of entries in this array placed in it.

Hint\+: an easy way to list all entries in an eet file is to use a glob value of \char`\"{}$\ast$\char`\"{}.

\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, and E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE.



Referenced by edje\+\_\+edit\+\_\+clean\+\_\+save\+\_\+as(), edje\+\_\+edit\+\_\+group\+\_\+copy(), and edje\+\_\+edit\+\_\+group\+\_\+del().

\mbox{\Hypertarget{group__Eet__File__Group_ga117c6d9d1c78d1791478b549118521ea}\label{group__Eet__File__Group_ga117c6d9d1c78d1791478b549118521ea}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+list\+\_\+entries@{eet\+\_\+list\+\_\+entries}}
\index{eet\+\_\+list\+\_\+entries@{eet\+\_\+list\+\_\+entries}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+list\+\_\+entries()}{eet\_list\_entries()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} \hyperlink{group__Eina__Iterator__Group_ga15b975bb881d955249ce13d4ebc96948}{Eina\+\_\+\+Iterator}$\ast$ eet\+\_\+list\+\_\+entries (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Return an iterator that will describe each entry of an Eet\+\_\+\+File. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An interator of Eet\+\_\+\+Entry.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8.\+0 
\end{DoxySince}


References eina\+\_\+binbuf\+\_\+manage\+\_\+new(), E\+I\+N\+A\+\_\+\+F\+A\+L\+SE, E\+I\+N\+A\+\_\+\+M\+A\+G\+I\+C\+\_\+\+S\+ET, E\+I\+N\+A\+\_\+\+T\+R\+UE, F\+U\+N\+C\+\_\+\+I\+T\+E\+R\+A\+T\+O\+R\+\_\+\+F\+R\+EE, F\+U\+N\+C\+\_\+\+I\+T\+E\+R\+A\+T\+O\+R\+\_\+\+G\+E\+T\+\_\+\+C\+O\+N\+T\+A\+I\+N\+ER, F\+U\+N\+C\+\_\+\+I\+T\+E\+R\+A\+T\+O\+R\+\_\+\+L\+O\+CK, and F\+U\+N\+C\+\_\+\+I\+T\+E\+R\+A\+T\+O\+R\+\_\+\+N\+E\+XT.

\mbox{\Hypertarget{group__Eet__File__Group_ga53bf1cf96267787aa93a99a0fe7ba8f7}\label{group__Eet__File__Group_ga53bf1cf96267787aa93a99a0fe7ba8f7}} 
\index{Eet File Main Functions@{Eet File Main Functions}!eet\+\_\+num\+\_\+entries@{eet\+\_\+num\+\_\+entries}}
\index{eet\+\_\+num\+\_\+entries@{eet\+\_\+num\+\_\+entries}!Eet File Main Functions@{Eet File Main Functions}}
\subsubsection{\texorpdfstring{eet\+\_\+num\+\_\+entries()}{eet\_num\_entries()}}
{\footnotesize\ttfamily \hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+PI} int eet\+\_\+num\+\_\+entries (\begin{DoxyParamCaption}\item[{\hyperlink{group__Eet__File__Group_ga8d9779184a9870c1a225f1f40c76e8a7}{Eet\+\_\+\+File} $\ast$}]{ef }\end{DoxyParamCaption})}



Return the number of entries in the specified eet file. 


\begin{DoxyParams}{Parameters}
{\em ef} & A valid eet file handle. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Number of entries in ef or -\/1 if the number of entries cannot be read due to open mode restrictions.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+0.\+0 
\end{DoxySince}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{eet-file_8c-example}{eet-\/file.\+c}.\end{Desc}


References E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD, E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+A\+D\+\_\+\+W\+R\+I\+TE, E\+I\+N\+A\+\_\+\+F\+A\+L\+SE, and E\+I\+N\+A\+\_\+\+T\+R\+UE.

