\hypertarget{group__liblolowlevel}{\section{Low-\/level O\+S\+C A\+P\+I}
\label{group__liblolowlevel}\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef long double \hyperlink{group__liblolowlevel_ga0062385786b0375d4b6954ba1fb8d52b}{lo\+\_\+hires}
\begin{DoxyCompactList}\small\item\em Type used to represent numerical values in conversions between O\+S\+C types. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
int \hyperlink{group__liblolowlevel_ga175a13c6d81adf5c346cdca9bbdcf225}{lo\+\_\+send\+\_\+message} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} targ, const char $\ast$path, \hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} msg)
\begin{DoxyCompactList}\small\item\em Send a lo\+\_\+message object to target targ. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga9d1aa7c1ee1ce60fe0cf7e3f1e5a6822}{lo\+\_\+send\+\_\+message\+\_\+from} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} targ, \hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} serv, const char $\ast$path, \hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} msg)
\begin{DoxyCompactList}\small\item\em Send a lo\+\_\+message object to target targ from address of serv. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gad1138d0f777693ae0321e3da65aee53e}{lo\+\_\+send\+\_\+bundle} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} targ, \hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Send a lo\+\_\+bundle object to address targ. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gab5de220b7d6d7c2bf6b0ca4316a54b7a}{lo\+\_\+send\+\_\+bundle\+\_\+from} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} targ, \hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} serv, \hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Send a lo\+\_\+bundle object to address targ from address of serv. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} \hyperlink{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}{lo\+\_\+message\+\_\+new} ()
\begin{DoxyCompactList}\small\item\em Create a new lo\+\_\+message object. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gae4007dd073375b8448a0c8efcb39da52}{lo\+\_\+message\+\_\+incref} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Add one to a message's reference count. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} \hyperlink{group__liblolowlevel_ga8cf4889aa1b479e3b6eaf8847c3b9e4f}{lo\+\_\+message\+\_\+clone} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Create a new lo\+\_\+message object by cloning an already existing one. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_ga93d3687e77ae20167b82830c917a3e50}{lo\+\_\+message\+\_\+free} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Free memory allocated by \hyperlink{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}{lo\+\_\+message\+\_\+new()} and any subsequent \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32} lo\+\_\+message\+\_\+add$\ast$() calls. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga4e7a6d91a06e795ded9676d089abea24}{lo\+\_\+message\+\_\+add} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, const char $\ast$types,...)
\begin{DoxyCompactList}\small\item\em Append a number of arguments to a message. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga9cd98b0c6ad5468692fd0b1936bd093f}{lo\+\_\+message\+\_\+add\+\_\+varargs} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, const char $\ast$types, va\+\_\+list ap)
\begin{DoxyCompactList}\small\item\em Append a varargs list to a message. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, int32\+\_\+t a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga42815097ea691fd1ec0798beca7f8e5e}{lo\+\_\+message\+\_\+add\+\_\+float} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, float a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga4ff414b1b3d87454668dfd728b830888}{lo\+\_\+message\+\_\+add\+\_\+string} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, const char $\ast$a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gac0ae2fc81d2a48fe63b0803637997fd4}{lo\+\_\+message\+\_\+add\+\_\+blob} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, \hyperlink{lo__types_8h_a8e780f8c09e3e4dd737fe249f11d16fc}{lo\+\_\+blob} a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga282ef81387abab0ce18f7479a4a817b5}{lo\+\_\+message\+\_\+add\+\_\+int64} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, int64\+\_\+t a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga03f8eafa4ba598c545f30e17b23d1c89}{lo\+\_\+message\+\_\+add\+\_\+timetag} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, \hyperlink{structlo__timetag}{lo\+\_\+timetag} a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gadd3a8441ad5a749c43694e77594cf47b}{lo\+\_\+message\+\_\+add\+\_\+double} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, double a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga90e4dab46ecaabab4e34214429d622a7}{lo\+\_\+message\+\_\+add\+\_\+symbol} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, const char $\ast$a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gab2423db077dea59c4049103819d2810b}{lo\+\_\+message\+\_\+add\+\_\+char} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, char a)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gaaea6ac25787de608199a988dc214f32e}{lo\+\_\+message\+\_\+add\+\_\+midi} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, uint8\+\_\+t a\mbox{[}4\mbox{]})
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga9da3df4838126910171a8e45ea34e9ec}{lo\+\_\+message\+\_\+add\+\_\+true} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga1c8a136e87e3d2befeb466e0a8a5a4ad}{lo\+\_\+message\+\_\+add\+\_\+false} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gabd3cd7f86137ae1a180e33c3bc5c9644}{lo\+\_\+message\+\_\+add\+\_\+nil} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga4cbd7d3834a67446b15f53acf316a72a}{lo\+\_\+message\+\_\+add\+\_\+infinitum} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} \hyperlink{group__liblolowlevel_ga1f4e07e4f8b67edc98f4b300412a3dbb}{lo\+\_\+message\+\_\+get\+\_\+source} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Returns the source (lo\+\_\+address) of an incoming message. \end{DoxyCompactList}\item 
\hyperlink{structlo__timetag}{lo\+\_\+timetag} \hyperlink{group__liblolowlevel_ga164e068064afa94454eb6515b9b1748d}{lo\+\_\+message\+\_\+get\+\_\+timestamp} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Returns the timestamp (\hyperlink{structlo__timetag}{lo\+\_\+timetag} $\ast$) of a bundled incoming message. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_gad3c1a312fd90bb4c35a4c1fac2d0b25d}{lo\+\_\+message\+\_\+get\+\_\+types} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Return the message type tag string. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga5b391362eda2c6019011f3db55049db3}{lo\+\_\+message\+\_\+get\+\_\+argc} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Return the message argument count. \end{DoxyCompactList}\item 
\hyperlink{unionlo__arg}{lo\+\_\+arg} $\ast$$\ast$ \hyperlink{group__liblolowlevel_gab28b48cdbefb60eb7e57557ae9d23171}{lo\+\_\+message\+\_\+get\+\_\+argv} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Return the message arguments. Do not free the returned data. \end{DoxyCompactList}\item 
size\+\_\+t \hyperlink{group__liblolowlevel_ga0855039d071b7031727213272857c27e}{lo\+\_\+message\+\_\+length} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, const char $\ast$path)
\begin{DoxyCompactList}\small\item\em Return the length of a message in bytes. \end{DoxyCompactList}\item 
void $\ast$ \hyperlink{group__liblolowlevel_ga5a14045edea33d63792e9a4c82e13b02}{lo\+\_\+message\+\_\+serialise} (\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m, const char $\ast$path, void $\ast$to, size\+\_\+t $\ast$size)
\begin{DoxyCompactList}\small\item\em Serialise the lo\+\_\+message object to an area of memory and return a pointer to the serialised form. Opposite of \hyperlink{group__liblolowlevel_ga2f4644b2a1aae0d0eee456fe93ac158e}{lo\+\_\+message\+\_\+deserialise()}. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} \hyperlink{group__liblolowlevel_ga2f4644b2a1aae0d0eee456fe93ac158e}{lo\+\_\+message\+\_\+deserialise} (void $\ast$data, size\+\_\+t size, int $\ast$result)
\begin{DoxyCompactList}\small\item\em Deserialise a raw O\+S\+C message and return a new lo\+\_\+message object. Opposite of \hyperlink{group__liblolowlevel_ga5a14045edea33d63792e9a4c82e13b02}{lo\+\_\+message\+\_\+serialise()}. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga9e96445401c94c3751de27f8db1a0b50}{lo\+\_\+server\+\_\+dispatch\+\_\+data} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, void $\ast$data, size\+\_\+t size)
\begin{DoxyCompactList}\small\item\em Dispatch a raw block of memory containing an O\+S\+C message. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__liblolowlevel_ga7dbaa4a6dfc9d7369cfbca195809be3c}{lo\+\_\+address\+\_\+get\+\_\+hostname} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} a)
\begin{DoxyCompactList}\small\item\em Return the hostname of a lo\+\_\+address object. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__liblolowlevel_ga75bc15ab78de049c0e0d7e24a0d6d0c1}{lo\+\_\+address\+\_\+get\+\_\+port} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} a)
\begin{DoxyCompactList}\small\item\em Return the port/service name of a lo\+\_\+address object. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gaaae09ebb4cf42e92504fe9aa7e7b2184}{lo\+\_\+address\+\_\+get\+\_\+protocol} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} a)
\begin{DoxyCompactList}\small\item\em Return the protocol of a lo\+\_\+address object. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_ga85d7101e9e3a3339544445b539e3a5d2}{lo\+\_\+address\+\_\+get\+\_\+url} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} a)
\begin{DoxyCompactList}\small\item\em Return a U\+R\+L representing an O\+S\+C address. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gacd72097b92411db148844d89071fd281}{lo\+\_\+address\+\_\+set\+\_\+ttl} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} t, int ttl)
\begin{DoxyCompactList}\small\item\em Set the Time-\/to-\/\+Live value for a given target address. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga3652ba694ba3c153dc96917e7321131c}{lo\+\_\+address\+\_\+get\+\_\+ttl} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} t)
\begin{DoxyCompactList}\small\item\em Get the Time-\/to-\/\+Live value for a given target address. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga734c5864de14a04c9e58f82d6efe4624}{lo\+\_\+address\+\_\+set\+\_\+iface} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} t, const char $\ast$iface, const char $\ast$ip)
\begin{DoxyCompactList}\small\item\em Set the network interface to use for a given target address. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__liblolowlevel_ga2bf32a3899bd51e1054532af727a8024}{lo\+\_\+address\+\_\+get\+\_\+iface} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} t)
\begin{DoxyCompactList}\small\item\em Get the name of the network interface assigned to an O\+S\+C address. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga9d73ff7267077cc69f632cbfeb30a23e}{lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} t, int enable)
\begin{DoxyCompactList}\small\item\em Set the T\+C\+P\+\_\+\+N\+O\+D\+E\+L\+A\+Y flag on outgoing T\+C\+P connections. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga6034e180b4f6c64097d9ec1fd3d8872e}{lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip} (\hyperlink{lo__types_8h_abf9b53223467de596b89e1377b0f3f3d}{lo\+\_\+address} t, int enable)
\begin{DoxyCompactList}\small\item\em Set outgoing stream connections (e.\+g., T\+C\+P) to be transmitted using the S\+L\+I\+P packetizing protocol. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} \hyperlink{group__liblolowlevel_ga330a4a4e6227b185b3ec6219ff3e2859}{lo\+\_\+bundle\+\_\+new} (\hyperlink{structlo__timetag}{lo\+\_\+timetag} tt)
\begin{DoxyCompactList}\small\item\em Create a new bundle object. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gaef50603d58b7d9b9dfe77fabb426a528}{lo\+\_\+bundle\+\_\+incref} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Add one to a bundle's reference count. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga1cc5e2eb20ce567a694f343764e25bb7}{lo\+\_\+bundle\+\_\+add\+\_\+message} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b, const char $\ast$path, \hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} m)
\begin{DoxyCompactList}\small\item\em Adds an O\+S\+C message to an existing bundle. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gad28eb5916f4d5c153069a56c1252f482}{lo\+\_\+bundle\+\_\+add\+\_\+bundle} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b, \hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} n)
\begin{DoxyCompactList}\small\item\em Adds an O\+S\+C bundle to an existing bundle. \end{DoxyCompactList}\item 
size\+\_\+t \hyperlink{group__liblolowlevel_gaa105f1c5b97a16beabdb6b4ab7af2b46}{lo\+\_\+bundle\+\_\+length} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Return the length of a bundle in bytes. \end{DoxyCompactList}\item 
unsigned int \hyperlink{group__liblolowlevel_ga78f875268636e2f8d794b80d3ac10716}{lo\+\_\+bundle\+\_\+count} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Return the number of top-\/level elements in a bundle. \end{DoxyCompactList}\item 
\hyperlink{group__liblo_ga08432d01f2b8f4a32ffa58992a821f28}{lo\+\_\+element\+\_\+type} \hyperlink{group__liblolowlevel_ga8c0a37924636ab24666246a3c595e959}{lo\+\_\+bundle\+\_\+get\+\_\+type} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b, int index)
\begin{DoxyCompactList}\small\item\em Gets the element type contained within a bundle. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} \hyperlink{group__liblolowlevel_gaafb86e502cd5f9b0a0f834409e0a8e6a}{lo\+\_\+bundle\+\_\+get\+\_\+bundle} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b, int index)
\begin{DoxyCompactList}\small\item\em Gets a nested bundle contained within a bundle. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_ad126083c98d941f00eb72d1690b38d63}{lo\+\_\+message} \hyperlink{group__liblolowlevel_ga18eef47e89f323e18027ce05f350833b}{lo\+\_\+bundle\+\_\+get\+\_\+message} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b, int index, const char $\ast$$\ast$path)
\begin{DoxyCompactList}\small\item\em Gets a message contained within a bundle. \end{DoxyCompactList}\item 
\hyperlink{structlo__timetag}{lo\+\_\+timetag} \hyperlink{group__liblolowlevel_gaeea3d61d6a4ae9efbd476f16d2758817}{lo\+\_\+bundle\+\_\+get\+\_\+timestamp} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Get the timestamp associated with a bundle. \end{DoxyCompactList}\item 
void $\ast$ \hyperlink{group__liblolowlevel_gaea61bc73c281efe4e2f95456e4d0f9f5}{lo\+\_\+bundle\+\_\+serialise} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b, void $\ast$to, size\+\_\+t $\ast$size)
\begin{DoxyCompactList}\small\item\em Serialise the bundle object to an area of memory and return a pointer to the serialised form. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_ga2ba37901788d863d08a2b7d6ca4250e6}{lo\+\_\+bundle\+\_\+free} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Frees the memory taken by a bundle object. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_ga8ec7b8729ab98094619285ebe11f0d00}{lo\+\_\+bundle\+\_\+free\+\_\+recursive} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Frees the memory taken by a bundle object and its messages and nested bundles recursively. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_ga2773611a57270837fff398b716fa8459}{lo\+\_\+bundle\+\_\+free\+\_\+messages} (\hyperlink{lo__types_8h_a96254950ad34e9cfbf8a6613fc74025b}{lo\+\_\+bundle} b)
\begin{DoxyCompactList}\small\item\em Obsolete, use lo\+\_\+bundle\+\_\+free\+\_\+recursive instead. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gace222e42c35d0256f115e00b84e8f853}{lo\+\_\+is\+\_\+numerical\+\_\+type} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} a)
\begin{DoxyCompactList}\small\item\em Return true if the type specified has a numerical value, such as L\+O\+\_\+\+I\+N\+T32, L\+O\+\_\+\+F\+L\+O\+A\+T etc. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gaeb9f59d9f7bf8d50f21809e44889eee7}{lo\+\_\+is\+\_\+string\+\_\+type} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} a)
\begin{DoxyCompactList}\small\item\em Return true if the type specified has a textual value, such as L\+O\+\_\+\+S\+T\+R\+I\+N\+G or L\+O\+\_\+\+S\+Y\+M\+B\+O\+L. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gaf85d7a54ab80e1b2a3d17c4cfef38402}{lo\+\_\+coerce} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} type\+\_\+to, \hyperlink{unionlo__arg}{lo\+\_\+arg} $\ast$to, \hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} type\+\_\+from, \hyperlink{unionlo__arg}{lo\+\_\+arg} $\ast$from)
\begin{DoxyCompactList}\small\item\em Attempt to convert one O\+S\+C type to another. \end{DoxyCompactList}\item 
\hyperlink{group__liblolowlevel_ga0062385786b0375d4b6954ba1fb8d52b}{lo\+\_\+hires} \hyperlink{group__liblolowlevel_gafb7036664581480c9f2e898e57704c1b}{lo\+\_\+hires\+\_\+val} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} type, \hyperlink{unionlo__arg}{lo\+\_\+arg} $\ast$p)
\begin{DoxyCompactList}\small\item\em Return the numerical value of the given argument with the maximum native system precision. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} \hyperlink{group__liblolowlevel_ga78cfb23346e44465695293d4393447ae}{lo\+\_\+server\+\_\+new} (const char $\ast$port, \hyperlink{lo__types_8h_aa5d2e4aa0ff9d4459fcc76e7ed5839fc}{lo\+\_\+err\+\_\+handler} err\+\_\+h)
\begin{DoxyCompactList}\small\item\em Create a new server instance. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} \hyperlink{group__liblolowlevel_ga4afa474b11ed0d4511857ae79c56aaa1}{lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto} (const char $\ast$port, int proto, \hyperlink{lo__types_8h_aa5d2e4aa0ff9d4459fcc76e7ed5839fc}{lo\+\_\+err\+\_\+handler} err\+\_\+h)
\begin{DoxyCompactList}\small\item\em Create a new server instance, specifying protocol. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} \hyperlink{group__liblolowlevel_ga849f4517a29ad850069cf8f2976a9284}{lo\+\_\+server\+\_\+new\+\_\+multicast} (const char $\ast$group, const char $\ast$port, \hyperlink{lo__types_8h_aa5d2e4aa0ff9d4459fcc76e7ed5839fc}{lo\+\_\+err\+\_\+handler} err\+\_\+h)
\begin{DoxyCompactList}\small\item\em Create a new server instance, and join a U\+D\+P multicast group. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} \hyperlink{group__liblolowlevel_gadec49f210324f499f2e9593df20128cb}{lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface} (const char $\ast$group, const char $\ast$port, const char $\ast$iface, const char $\ast$ip, \hyperlink{lo__types_8h_aa5d2e4aa0ff9d4459fcc76e7ed5839fc}{lo\+\_\+err\+\_\+handler} err\+\_\+h)
\begin{DoxyCompactList}\small\item\em Create a new server instance, and join a U\+D\+P multicast group, optionally specifying which network interface to use. Note that usually only one of iface or ip are specified. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} \hyperlink{group__liblolowlevel_ga1246a1f4a2ba967d31017452a32daf2a}{lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url} (const char $\ast$url, \hyperlink{lo__types_8h_aa5d2e4aa0ff9d4459fcc76e7ed5839fc}{lo\+\_\+err\+\_\+handler} err\+\_\+h)
\begin{DoxyCompactList}\small\item\em Create a new server instance, taking port and the optional multicast group I\+P from an U\+R\+L string. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga175ef81fc2d695895967bfc30a495b2a}{lo\+\_\+server\+\_\+enable\+\_\+coercion} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} server, int enable)
\begin{DoxyCompactList}\small\item\em Enables or disables type coercion during message dispatch. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gad3dc9193e1eef0d71a4b046242b64216}{lo\+\_\+server\+\_\+free} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Free up memory used by the lo\+\_\+server object. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga33cdcfbab89d58f82175386a76698822}{lo\+\_\+server\+\_\+wait} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, int timeout)
\begin{DoxyCompactList}\small\item\em Wait for an O\+S\+C message to be received. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga784a257252d05cc0e7210f4691f0661b}{lo\+\_\+server\+\_\+recv\+\_\+noblock} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, int timeout)
\begin{DoxyCompactList}\small\item\em Look for an O\+S\+C message waiting to be received. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gaebef3611d24e4b5f60f16cce76a9e271}{lo\+\_\+server\+\_\+recv} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Block, waiting for an O\+S\+C message to be received. \end{DoxyCompactList}\item 
\hyperlink{lo__types_8h_a66faedf5da13231d8c0166870477dce5}{lo\+\_\+method} \hyperlink{group__liblolowlevel_ga0c183cabaac67eb9aad3265ae1efa580}{lo\+\_\+server\+\_\+add\+\_\+method} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, const char $\ast$path, const char $\ast$typespec, \hyperlink{lo__types_8h_a3b1c86c0925d05e13b5438ce8fe80a6c}{lo\+\_\+method\+\_\+handler} h, void $\ast$user\+\_\+data)
\begin{DoxyCompactList}\small\item\em Add an O\+S\+C method to the specifed server. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gaf834a6d62de7dcceaede62325e74c763}{lo\+\_\+server\+\_\+del\+\_\+method} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, const char $\ast$path, const char $\ast$typespec)
\begin{DoxyCompactList}\small\item\em Delete an O\+S\+C method from the specifed server. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga1411fdb0c8037a4dd3ab19af35df50ac}{lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, \hyperlink{lo__types_8h_a40484ab2ebc1413ffe465558a638d329}{lo\+\_\+bundle\+\_\+start\+\_\+handler} sh, \hyperlink{lo__types_8h_a3074807a4e7379c1b101c303567b7e42}{lo\+\_\+bundle\+\_\+end\+\_\+handler} eh, void $\ast$user\+\_\+data)
\begin{DoxyCompactList}\small\item\em Add bundle notification handlers to the specified server. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gae11ca5a5b4ec2943d5a04642ba5052ae}{lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Return the file descriptor of the server socket. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga532ef6e1b8675b23e65dd19eeb648c1d}{lo\+\_\+server\+\_\+get\+\_\+port} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Return the port number that the server has bound to. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gab40a599fe8440512b18479dac333e89f}{lo\+\_\+server\+\_\+get\+\_\+protocol} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Return the protocol that the server is using. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_ga33df48c641833d330a8ba6704caf4977}{lo\+\_\+server\+\_\+get\+\_\+url} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Return an O\+S\+C U\+R\+L that can be used to contact the server. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga3e23b9b6027042e136f344d001431ac6}{lo\+\_\+server\+\_\+enable\+\_\+queue} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s, int queue\+\_\+enabled, int dispatch\+\_\+remaining)
\begin{DoxyCompactList}\small\item\em Toggle event queue. If queueing is enabled, timetagged messages that are sent in advance of the current time will be put on an internal queue, and they will be dispatched at the indicated time. By default, queueing is enabled. Use this function to disable it, if it is desired to have a server process messages immediately. In that case, use \hyperlink{group__liblolowlevel_ga164e068064afa94454eb6515b9b1748d}{lo\+\_\+message\+\_\+get\+\_\+timestamp()} to get the message timestamp from within a method handler. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga04feb1063c3f4df6fec41405b28dd99a}{lo\+\_\+server\+\_\+events\+\_\+pending} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Return true if there are scheduled events (eg. from bundles) waiting to be dispatched by the server. \end{DoxyCompactList}\item 
double \hyperlink{group__liblolowlevel_ga750076fdd75e2a7d3e442f6bd5968fb9}{lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay} (\hyperlink{lo__types_8h_a59067bf50cf8abb4371da6f03c9036c9}{lo\+\_\+server} s)
\begin{DoxyCompactList}\small\item\em Return the time in seconds until the next scheduled event. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_ga58266d3085b73fc4dc5e1913de810b22}{lo\+\_\+url\+\_\+get\+\_\+protocol} (const char $\ast$url)
\begin{DoxyCompactList}\small\item\em Return the protocol portion of an O\+S\+C U\+R\+L, eg. udp, tcp. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_ga0550cc91417b530c26a360b10072a3cb}{lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id} (const char $\ast$url)
\begin{DoxyCompactList}\small\item\em Return the protocol I\+D of an O\+S\+C U\+R\+L. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_gab1b7df7061a0b2cd0db31d3fca1b399b}{lo\+\_\+url\+\_\+get\+\_\+hostname} (const char $\ast$url)
\begin{DoxyCompactList}\small\item\em Return the hostname portion of an O\+S\+C U\+R\+L. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_ga488fb8e96fb86320590c1a8ca389593d}{lo\+\_\+url\+\_\+get\+\_\+port} (const char $\ast$url)
\begin{DoxyCompactList}\small\item\em Return the port portion of an O\+S\+C U\+R\+L. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_ga617d046cc702a2c5ab8539659381ef18}{lo\+\_\+url\+\_\+get\+\_\+path} (const char $\ast$url)
\begin{DoxyCompactList}\small\item\em Return the path portion of an O\+S\+C U\+R\+L. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gae62aa870bad161e4507f6338820ac243}{lo\+\_\+strsize} (const char $\ast$s)
\begin{DoxyCompactList}\small\item\em A function to calculate the amount of O\+S\+C message space required by a C char $\ast$. \end{DoxyCompactList}\item 
uint32\+\_\+t \hyperlink{group__liblolowlevel_ga2315f71c3832c365bce25d9b21726043}{lo\+\_\+blobsize} (\hyperlink{lo__types_8h_a8e780f8c09e3e4dd737fe249f11d16fc}{lo\+\_\+blob} b)
\begin{DoxyCompactList}\small\item\em A function to calculate the amount of O\+S\+C message space required by a lo\+\_\+blob object. \end{DoxyCompactList}\item 
int \hyperlink{group__liblolowlevel_gac26f3d15dbd23f34d4f9e4f6f0b81bbb}{lo\+\_\+pattern\+\_\+match} (const char $\ast$str, const char $\ast$p)
\begin{DoxyCompactList}\small\item\em Test a string against an O\+S\+C pattern glob. \end{DoxyCompactList}\item 
double \hyperlink{group__liblolowlevel_ga9937fce1bfce695b01cd3289ead8b919}{lo\+\_\+timetag\+\_\+diff} (\hyperlink{structlo__timetag}{lo\+\_\+timetag} a, \hyperlink{structlo__timetag}{lo\+\_\+timetag} b)
\begin{DoxyCompactList}\small\item\em Find the time difference between two timetags. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gad687e21ed611e68748e962502ae63d8e}{lo\+\_\+timetag\+\_\+now} (\hyperlink{structlo__timetag}{lo\+\_\+timetag} $\ast$t)
\begin{DoxyCompactList}\small\item\em Return a timetag for the current time. \end{DoxyCompactList}\item 
size\+\_\+t \hyperlink{group__liblolowlevel_gaf793bbd32346a91d7d680d91ae68d1bd}{lo\+\_\+arg\+\_\+size} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} type, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Return the storage size, in bytes, of the given argument. \end{DoxyCompactList}\item 
char $\ast$ \hyperlink{group__liblolowlevel_gad38872ce4270bbfed9d62a655a4facab}{lo\+\_\+get\+\_\+path} (void $\ast$data, ssize\+\_\+t size)
\begin{DoxyCompactList}\small\item\em Given a raw O\+S\+C message, return the message path. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_ga29fc246595334f29d97d11b0186b17bd}{lo\+\_\+arg\+\_\+host\+\_\+endian} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} type, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Convert the specified argument to host byte order where necessary. \end{DoxyCompactList}\item 
void \hyperlink{group__liblolowlevel_gad775da1d9ef1feaf1b76077143dc3e96}{lo\+\_\+arg\+\_\+network\+\_\+endian} (\hyperlink{group__liblo_ga11838c576b0197c255ce805fd7434736}{lo\+\_\+type} type, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Convert the specified argument to network byte order where necessary. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Use these functions if you require more precise control over O\+S\+C message contruction or handling that what is provided in the high-\/level functions described in liblo. 

\subsection{Typedef Documentation}
\hypertarget{group__liblolowlevel_ga0062385786b0375d4b6954ba1fb8d52b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+hires@{lo\+\_\+hires}}
\index{lo\+\_\+hires@{lo\+\_\+hires}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+hires}]{\setlength{\rightskip}{0pt plus 5cm}typedef long double {\bf lo\+\_\+hires}}}\label{group__liblolowlevel_ga0062385786b0375d4b6954ba1fb8d52b}


Type used to represent numerical values in conversions between O\+S\+C types. 



\subsection{Function Documentation}
\hypertarget{group__liblolowlevel_ga7dbaa4a6dfc9d7369cfbca195809be3c}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+get\+\_\+hostname@{lo\+\_\+address\+\_\+get\+\_\+hostname}}
\index{lo\+\_\+address\+\_\+get\+\_\+hostname@{lo\+\_\+address\+\_\+get\+\_\+hostname}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+get\+\_\+hostname}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ lo\+\_\+address\+\_\+get\+\_\+hostname (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga7dbaa4a6dfc9d7369cfbca195809be3c}


Return the hostname of a lo\+\_\+address object. 

Returned value must not be modified or free'd. Value will be a dotted quad, colon'd I\+P\+V6 address, or resolvable name. \hypertarget{group__liblolowlevel_ga2bf32a3899bd51e1054532af727a8024}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+get\+\_\+iface@{lo\+\_\+address\+\_\+get\+\_\+iface}}
\index{lo\+\_\+address\+\_\+get\+\_\+iface@{lo\+\_\+address\+\_\+get\+\_\+iface}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+get\+\_\+iface}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ lo\+\_\+address\+\_\+get\+\_\+iface (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{t}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga2bf32a3899bd51e1054532af727a8024}


Get the name of the network interface assigned to an O\+S\+C address. 


\begin{DoxyParams}{Parameters}
{\em t} & An O\+S\+C address. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A string pointer or 0 if no interface has been assigned. Caller should not modify the provided string. It is a legal pointer until the next call to lo\+\_\+address\+\_\+set\+\_\+iface or lo\+\_\+address\+\_\+free. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga75bc15ab78de049c0e0d7e24a0d6d0c1}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+get\+\_\+port@{lo\+\_\+address\+\_\+get\+\_\+port}}
\index{lo\+\_\+address\+\_\+get\+\_\+port@{lo\+\_\+address\+\_\+get\+\_\+port}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+get\+\_\+port}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ lo\+\_\+address\+\_\+get\+\_\+port (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga75bc15ab78de049c0e0d7e24a0d6d0c1}


Return the port/service name of a lo\+\_\+address object. 

Returned value must not be modified or free'd. Value will be a service name or A\+S\+C\+I\+I representation of the port number. \hypertarget{group__liblolowlevel_gaaae09ebb4cf42e92504fe9aa7e7b2184}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+get\+\_\+protocol@{lo\+\_\+address\+\_\+get\+\_\+protocol}}
\index{lo\+\_\+address\+\_\+get\+\_\+protocol@{lo\+\_\+address\+\_\+get\+\_\+protocol}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+get\+\_\+protocol}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+address\+\_\+get\+\_\+protocol (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaaae09ebb4cf42e92504fe9aa7e7b2184}


Return the protocol of a lo\+\_\+address object. 

Returned value will be one of L\+O\+\_\+\+U\+D\+P, L\+O\+\_\+\+T\+C\+P or L\+O\+\_\+\+U\+N\+I\+X. \hypertarget{group__liblolowlevel_ga3652ba694ba3c153dc96917e7321131c}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+get\+\_\+ttl@{lo\+\_\+address\+\_\+get\+\_\+ttl}}
\index{lo\+\_\+address\+\_\+get\+\_\+ttl@{lo\+\_\+address\+\_\+get\+\_\+ttl}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+get\+\_\+ttl}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+address\+\_\+get\+\_\+ttl (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{t}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga3652ba694ba3c153dc96917e7321131c}


Get the Time-\/to-\/\+Live value for a given target address. 


\begin{DoxyParams}{Parameters}
{\em t} & An O\+S\+C address. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An integer specifying the scope of a multicast U\+D\+P message. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga85d7101e9e3a3339544445b539e3a5d2}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+get\+\_\+url@{lo\+\_\+address\+\_\+get\+\_\+url}}
\index{lo\+\_\+address\+\_\+get\+\_\+url@{lo\+\_\+address\+\_\+get\+\_\+url}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+get\+\_\+url}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+address\+\_\+get\+\_\+url (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga85d7101e9e3a3339544445b539e3a5d2}


Return a U\+R\+L representing an O\+S\+C address. 

Returned value must be free'd. \hypertarget{group__liblolowlevel_ga734c5864de14a04c9e58f82d6efe4624}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+set\+\_\+iface@{lo\+\_\+address\+\_\+set\+\_\+iface}}
\index{lo\+\_\+address\+\_\+set\+\_\+iface@{lo\+\_\+address\+\_\+set\+\_\+iface}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+set\+\_\+iface}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+address\+\_\+set\+\_\+iface (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{t, }
\item[{const char $\ast$}]{iface, }
\item[{const char $\ast$}]{ip}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga734c5864de14a04c9e58f82d6efe4624}


Set the network interface to use for a given target address. 

The caller should specify either the iface or ip variable. The I\+P, if specified, should match the same network family as the O\+S\+C address. (That is, should correctly correspond to I\+Pv4 or I\+Pv6.) Typically the assigned network interface will only be used in the case of sending multicast messages. It is recommended to use the if\+\_\+nameindex P\+O\+S\+I\+X function to get a list of network interface names.


\begin{DoxyParams}{Parameters}
{\em t} & An O\+S\+C address. \\
\hline
{\em iface} & The name of a network interface on the local system. \\
\hline
{\em ip} & The I\+P address of a network interface on the local system. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
0 if the interface was successfully identified, or non-\/zero otherwise. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga6034e180b4f6c64097d9ec1fd3d8872e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip@{lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip}}
\index{lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip@{lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+address\+\_\+set\+\_\+stream\+\_\+slip (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{t, }
\item[{int}]{enable}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga6034e180b4f6c64097d9ec1fd3d8872e}


Set outgoing stream connections (e.\+g., T\+C\+P) to be transmitted using the S\+L\+I\+P packetizing protocol. 


\begin{DoxyParams}{Parameters}
{\em t} & The address to set this flag for. \\
\hline
{\em enable} & Non-\/zero to set the flag, zero to unset it. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the previous value of this flag. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga9d73ff7267077cc69f632cbfeb30a23e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay@{lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay}}
\index{lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay@{lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+address\+\_\+set\+\_\+tcp\+\_\+nodelay (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{t, }
\item[{int}]{enable}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga9d73ff7267077cc69f632cbfeb30a23e}


Set the T\+C\+P\+\_\+\+N\+O\+D\+E\+L\+A\+Y flag on outgoing T\+C\+P connections. 


\begin{DoxyParams}{Parameters}
{\em t} & The address to set this flag for. \\
\hline
{\em enable} & Non-\/zero to set the flag, zero to unset it. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the previous value of this flag. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gacd72097b92411db148844d89071fd281}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+address\+\_\+set\+\_\+ttl@{lo\+\_\+address\+\_\+set\+\_\+ttl}}
\index{lo\+\_\+address\+\_\+set\+\_\+ttl@{lo\+\_\+address\+\_\+set\+\_\+ttl}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+address\+\_\+set\+\_\+ttl}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+address\+\_\+set\+\_\+ttl (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{t, }
\item[{int}]{ttl}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gacd72097b92411db148844d89071fd281}


Set the Time-\/to-\/\+Live value for a given target address. 

This is required for sending multicast U\+D\+P messages. A value of 1 (the usual case) keeps the message within the subnet, while 255 means a global, unrestricted scope.


\begin{DoxyParams}{Parameters}
{\em t} & An O\+S\+C address. \\
\hline
{\em ttl} & An integer specifying the scope of a multicast U\+D\+P message. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga29fc246595334f29d97d11b0186b17bd}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+arg\+\_\+host\+\_\+endian@{lo\+\_\+arg\+\_\+host\+\_\+endian}}
\index{lo\+\_\+arg\+\_\+host\+\_\+endian@{lo\+\_\+arg\+\_\+host\+\_\+endian}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+arg\+\_\+host\+\_\+endian}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+arg\+\_\+host\+\_\+endian (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{type, }
\item[{void $\ast$}]{data}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga29fc246595334f29d97d11b0186b17bd}


Convert the specified argument to host byte order where necessary. 


\begin{DoxyParams}{Parameters}
{\em type} & The O\+S\+C type of the data item (eg. L\+O\+\_\+\+F\+L\+O\+A\+T). \\
\hline
{\em data} & A pointer to the data item to be converted. It is changed in-\/place. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gad775da1d9ef1feaf1b76077143dc3e96}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+arg\+\_\+network\+\_\+endian@{lo\+\_\+arg\+\_\+network\+\_\+endian}}
\index{lo\+\_\+arg\+\_\+network\+\_\+endian@{lo\+\_\+arg\+\_\+network\+\_\+endian}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+arg\+\_\+network\+\_\+endian}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+arg\+\_\+network\+\_\+endian (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{type, }
\item[{void $\ast$}]{data}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad775da1d9ef1feaf1b76077143dc3e96}


Convert the specified argument to network byte order where necessary. 


\begin{DoxyParams}{Parameters}
{\em type} & The O\+S\+C type of the data item (eg. L\+O\+\_\+\+F\+L\+O\+A\+T). \\
\hline
{\em data} & A pointer to the data item to be converted. It is changed in-\/place. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gaf793bbd32346a91d7d680d91ae68d1bd}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+arg\+\_\+size@{lo\+\_\+arg\+\_\+size}}
\index{lo\+\_\+arg\+\_\+size@{lo\+\_\+arg\+\_\+size}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+arg\+\_\+size}]{\setlength{\rightskip}{0pt plus 5cm}size\+\_\+t lo\+\_\+arg\+\_\+size (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{type, }
\item[{void $\ast$}]{data}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaf793bbd32346a91d7d680d91ae68d1bd}


Return the storage size, in bytes, of the given argument. 

\hypertarget{group__liblolowlevel_ga2315f71c3832c365bce25d9b21726043}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+blobsize@{lo\+\_\+blobsize}}
\index{lo\+\_\+blobsize@{lo\+\_\+blobsize}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+blobsize}]{\setlength{\rightskip}{0pt plus 5cm}uint32\+\_\+t lo\+\_\+blobsize (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+blob}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga2315f71c3832c365bce25d9b21726043}


A function to calculate the amount of O\+S\+C message space required by a lo\+\_\+blob object. 

Returns the storage size in bytes, which will always be a multiple of four. \hypertarget{group__liblolowlevel_gad28eb5916f4d5c153069a56c1252f482}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+add\+\_\+bundle@{lo\+\_\+bundle\+\_\+add\+\_\+bundle}}
\index{lo\+\_\+bundle\+\_\+add\+\_\+bundle@{lo\+\_\+bundle\+\_\+add\+\_\+bundle}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+add\+\_\+bundle}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+bundle\+\_\+add\+\_\+bundle (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b, }
\item[{{\bf lo\+\_\+bundle}}]{n}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad28eb5916f4d5c153069a56c1252f482}


Adds an O\+S\+C bundle to an existing bundle. 

The child bundle passed is appended to the list of child bundles$\vert$messages in the parent bundle to be dispatched.

\begin{DoxyReturn}{Returns}
0 if successful, less than 0 otherwise. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga1cc5e2eb20ce567a694f343764e25bb7}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+add\+\_\+message@{lo\+\_\+bundle\+\_\+add\+\_\+message}}
\index{lo\+\_\+bundle\+\_\+add\+\_\+message@{lo\+\_\+bundle\+\_\+add\+\_\+message}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+add\+\_\+message}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+bundle\+\_\+add\+\_\+message (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b, }
\item[{const char $\ast$}]{path, }
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga1cc5e2eb20ce567a694f343764e25bb7}


Adds an O\+S\+C message to an existing bundle. 

The message passed is appended to the list of messages in the bundle to be dispatched to 'path'.

\begin{DoxyReturn}{Returns}
0 if successful, less than 0 otherwise. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga78f875268636e2f8d794b80d3ac10716}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+count@{lo\+\_\+bundle\+\_\+count}}
\index{lo\+\_\+bundle\+\_\+count@{lo\+\_\+bundle\+\_\+count}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+count}]{\setlength{\rightskip}{0pt plus 5cm}unsigned int lo\+\_\+bundle\+\_\+count (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga78f875268636e2f8d794b80d3ac10716}


Return the number of top-\/level elements in a bundle. 


\begin{DoxyParams}{Parameters}
{\em b} & The bundle to be counted. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga2ba37901788d863d08a2b7d6ca4250e6}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+free@{lo\+\_\+bundle\+\_\+free}}
\index{lo\+\_\+bundle\+\_\+free@{lo\+\_\+bundle\+\_\+free}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+free}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+bundle\+\_\+free (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga2ba37901788d863d08a2b7d6ca4250e6}


Frees the memory taken by a bundle object. 


\begin{DoxyParams}{Parameters}
{\em b} & The bundle to be freed. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga2773611a57270837fff398b716fa8459}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+free\+\_\+messages@{lo\+\_\+bundle\+\_\+free\+\_\+messages}}
\index{lo\+\_\+bundle\+\_\+free\+\_\+messages@{lo\+\_\+bundle\+\_\+free\+\_\+messages}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+free\+\_\+messages}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+bundle\+\_\+free\+\_\+messages (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga2773611a57270837fff398b716fa8459}


Obsolete, use lo\+\_\+bundle\+\_\+free\+\_\+recursive instead. 


\begin{DoxyParams}{Parameters}
{\em b} & The bundle, which may contain messages and nested bundles, to be freed. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga8ec7b8729ab98094619285ebe11f0d00}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+free\+\_\+recursive@{lo\+\_\+bundle\+\_\+free\+\_\+recursive}}
\index{lo\+\_\+bundle\+\_\+free\+\_\+recursive@{lo\+\_\+bundle\+\_\+free\+\_\+recursive}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+free\+\_\+recursive}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+bundle\+\_\+free\+\_\+recursive (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga8ec7b8729ab98094619285ebe11f0d00}


Frees the memory taken by a bundle object and its messages and nested bundles recursively. 


\begin{DoxyParams}{Parameters}
{\em b} & The bundle, which may contain messages and nested bundles, to be freed. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gaafb86e502cd5f9b0a0f834409e0a8e6a}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+get\+\_\+bundle@{lo\+\_\+bundle\+\_\+get\+\_\+bundle}}
\index{lo\+\_\+bundle\+\_\+get\+\_\+bundle@{lo\+\_\+bundle\+\_\+get\+\_\+bundle}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+get\+\_\+bundle}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+bundle} lo\+\_\+bundle\+\_\+get\+\_\+bundle (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b, }
\item[{int}]{index}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaafb86e502cd5f9b0a0f834409e0a8e6a}


Gets a nested bundle contained within a bundle. 

Returns a lo\+\_\+bundle at a given index within a bundle.

\begin{DoxyReturn}{Returns}
The requested lo\+\_\+bundle if successful, otherwise 0. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga18eef47e89f323e18027ce05f350833b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+get\+\_\+message@{lo\+\_\+bundle\+\_\+get\+\_\+message}}
\index{lo\+\_\+bundle\+\_\+get\+\_\+message@{lo\+\_\+bundle\+\_\+get\+\_\+message}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+get\+\_\+message}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+message} lo\+\_\+bundle\+\_\+get\+\_\+message (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b, }
\item[{int}]{index, }
\item[{const char $\ast$$\ast$}]{path}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga18eef47e89f323e18027ce05f350833b}


Gets a message contained within a bundle. 

Returns a lo\+\_\+message at a given index within a bundle, and optionally the path associated with that message.

\begin{DoxyReturn}{Returns}
The requested lo\+\_\+message if successful, otherwise 0. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gaeea3d61d6a4ae9efbd476f16d2758817}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+get\+\_\+timestamp@{lo\+\_\+bundle\+\_\+get\+\_\+timestamp}}
\index{lo\+\_\+bundle\+\_\+get\+\_\+timestamp@{lo\+\_\+bundle\+\_\+get\+\_\+timestamp}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+get\+\_\+timestamp}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+timetag} lo\+\_\+bundle\+\_\+get\+\_\+timestamp (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaeea3d61d6a4ae9efbd476f16d2758817}


Get the timestamp associated with a bundle. 


\begin{DoxyParams}{Parameters}
{\em b} & The bundle for which the timestamp should be returned.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The timestamp of the bundle as a \hyperlink{structlo__timetag}{lo\+\_\+timetag}. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga8c0a37924636ab24666246a3c595e959}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+get\+\_\+type@{lo\+\_\+bundle\+\_\+get\+\_\+type}}
\index{lo\+\_\+bundle\+\_\+get\+\_\+type@{lo\+\_\+bundle\+\_\+get\+\_\+type}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+get\+\_\+type}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+element\+\_\+type} lo\+\_\+bundle\+\_\+get\+\_\+type (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b, }
\item[{int}]{index}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga8c0a37924636ab24666246a3c595e959}


Gets the element type contained within a bundle. 

Returns a lo\+\_\+element\+\_\+type at a given index within a bundle.

\begin{DoxyReturn}{Returns}
The requested lo\+\_\+element\+\_\+type if successful, otherwise 0. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gaef50603d58b7d9b9dfe77fabb426a528}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+incref@{lo\+\_\+bundle\+\_\+incref}}
\index{lo\+\_\+bundle\+\_\+incref@{lo\+\_\+bundle\+\_\+incref}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+incref}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+bundle\+\_\+incref (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaef50603d58b7d9b9dfe77fabb426a528}


Add one to a bundle's reference count. 

Bundles are reference counted. If a bundle is multiply referenced, the bundle's counter should be incremented. It is automatically decremented by lo\+\_\+bundle\+\_\+free lo\+\_\+bundle\+\_\+free\+\_\+recursive, with lo\+\_\+bundle\+\_\+free\+\_\+recursive being the preferable method. \hypertarget{group__liblolowlevel_gaa105f1c5b97a16beabdb6b4ab7af2b46}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+length@{lo\+\_\+bundle\+\_\+length}}
\index{lo\+\_\+bundle\+\_\+length@{lo\+\_\+bundle\+\_\+length}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+length}]{\setlength{\rightskip}{0pt plus 5cm}size\+\_\+t lo\+\_\+bundle\+\_\+length (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaa105f1c5b97a16beabdb6b4ab7af2b46}


Return the length of a bundle in bytes. 

Includes the marker and typetag length.


\begin{DoxyParams}{Parameters}
{\em b} & The bundle to be sized \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga330a4a4e6227b185b3ec6219ff3e2859}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+new@{lo\+\_\+bundle\+\_\+new}}
\index{lo\+\_\+bundle\+\_\+new@{lo\+\_\+bundle\+\_\+new}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+new}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+bundle} lo\+\_\+bundle\+\_\+new (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+timetag}}]{tt}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga330a4a4e6227b185b3ec6219ff3e2859}


Create a new bundle object. 

O\+S\+C Bundles encapsulate one or more O\+S\+C messages and may include a timestamp indicating when the bundle should be dispatched.


\begin{DoxyParams}{Parameters}
{\em tt} & The timestamp when the bundle should be handled by the receiver. Pass L\+O\+\_\+\+T\+T\+\_\+\+I\+M\+M\+E\+D\+I\+A\+T\+E if you want the receiving server to dispatch the bundle as soon as it receives it. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gaea61bc73c281efe4e2f95456e4d0f9f5}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+bundle\+\_\+serialise@{lo\+\_\+bundle\+\_\+serialise}}
\index{lo\+\_\+bundle\+\_\+serialise@{lo\+\_\+bundle\+\_\+serialise}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+bundle\+\_\+serialise}]{\setlength{\rightskip}{0pt plus 5cm}void$\ast$ lo\+\_\+bundle\+\_\+serialise (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+bundle}}]{b, }
\item[{void $\ast$}]{to, }
\item[{size\+\_\+t $\ast$}]{size}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaea61bc73c281efe4e2f95456e4d0f9f5}


Serialise the bundle object to an area of memory and return a pointer to the serialised form. 


\begin{DoxyParams}{Parameters}
{\em b} & The bundle to be serialised \\
\hline
{\em to} & The address to serialise to, memory will be allocated if to is N\+U\+L\+L. \\
\hline
{\em size} & If this pointer is non-\/\+N\+U\+L\+L the size of the memory area will be written here\\
\hline
\end{DoxyParams}
The returned form is suitable to be sent over a low level O\+S\+C transport, having the correct endianess and bit-\/packed structure. \hypertarget{group__liblolowlevel_gaf85d7a54ab80e1b2a3d17c4cfef38402}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+coerce@{lo\+\_\+coerce}}
\index{lo\+\_\+coerce@{lo\+\_\+coerce}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+coerce}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+coerce (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{type\+\_\+to, }
\item[{{\bf lo\+\_\+arg} $\ast$}]{to, }
\item[{{\bf lo\+\_\+type}}]{type\+\_\+from, }
\item[{{\bf lo\+\_\+arg} $\ast$}]{from}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaf85d7a54ab80e1b2a3d17c4cfef38402}


Attempt to convert one O\+S\+C type to another. 

Numerical types (eg L\+O\+\_\+\+I\+N\+T32, L\+O\+\_\+\+F\+L\+O\+A\+T etc.) may be converted to other numerical types and string types (L\+O\+\_\+\+S\+T\+R\+I\+N\+G and L\+O\+\_\+\+S\+Y\+M\+B\+O\+L) may be converted to the other type. This is done automatically if a received message matches the path, but not the exact types, and is coercible (ie. all numerical types in numerical positions).

On failure no translation occurs and false is returned.


\begin{DoxyParams}{Parameters}
{\em type\+\_\+to} & The type of the destination variable. \\
\hline
{\em to} & A pointer to the destination variable. \\
\hline
{\em type\+\_\+from} & The type of the source variable. \\
\hline
{\em from} & A pointer to the source variable. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gad38872ce4270bbfed9d62a655a4facab}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+get\+\_\+path@{lo\+\_\+get\+\_\+path}}
\index{lo\+\_\+get\+\_\+path@{lo\+\_\+get\+\_\+path}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+get\+\_\+path}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+get\+\_\+path (
\begin{DoxyParamCaption}
\item[{void $\ast$}]{data, }
\item[{ssize\+\_\+t}]{size}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad38872ce4270bbfed9d62a655a4facab}


Given a raw O\+S\+C message, return the message path. 


\begin{DoxyParams}{Parameters}
{\em data} & A pointer to the raw O\+S\+C message data. \\
\hline
{\em size} & The size of data in bytes (total buffer bytes).\\
\hline
\end{DoxyParams}
Returns the message path or N\+U\+L\+L if an error occurs. Do not free() the returned pointer. \hypertarget{group__liblolowlevel_gafb7036664581480c9f2e898e57704c1b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+hires\+\_\+val@{lo\+\_\+hires\+\_\+val}}
\index{lo\+\_\+hires\+\_\+val@{lo\+\_\+hires\+\_\+val}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+hires\+\_\+val}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+hires} lo\+\_\+hires\+\_\+val (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{type, }
\item[{{\bf lo\+\_\+arg} $\ast$}]{p}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gafb7036664581480c9f2e898e57704c1b}


Return the numerical value of the given argument with the maximum native system precision. 

\hypertarget{group__liblolowlevel_gace222e42c35d0256f115e00b84e8f853}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+is\+\_\+numerical\+\_\+type@{lo\+\_\+is\+\_\+numerical\+\_\+type}}
\index{lo\+\_\+is\+\_\+numerical\+\_\+type@{lo\+\_\+is\+\_\+numerical\+\_\+type}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+is\+\_\+numerical\+\_\+type}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+is\+\_\+numerical\+\_\+type (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gace222e42c35d0256f115e00b84e8f853}


Return true if the type specified has a numerical value, such as L\+O\+\_\+\+I\+N\+T32, L\+O\+\_\+\+F\+L\+O\+A\+T etc. 


\begin{DoxyParams}{Parameters}
{\em a} & The type to be tested. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gaeb9f59d9f7bf8d50f21809e44889eee7}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+is\+\_\+string\+\_\+type@{lo\+\_\+is\+\_\+string\+\_\+type}}
\index{lo\+\_\+is\+\_\+string\+\_\+type@{lo\+\_\+is\+\_\+string\+\_\+type}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+is\+\_\+string\+\_\+type}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+is\+\_\+string\+\_\+type (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+type}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaeb9f59d9f7bf8d50f21809e44889eee7}


Return true if the type specified has a textual value, such as L\+O\+\_\+\+S\+T\+R\+I\+N\+G or L\+O\+\_\+\+S\+Y\+M\+B\+O\+L. 


\begin{DoxyParams}{Parameters}
{\em a} & The type to be tested. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga4e7a6d91a06e795ded9676d089abea24}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add@{lo\+\_\+message\+\_\+add}}
\index{lo\+\_\+message\+\_\+add@{lo\+\_\+message\+\_\+add}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{const char $\ast$}]{types, }
\item[{}]{...}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga4e7a6d91a06e795ded9676d089abea24}


Append a number of arguments to a message. 

The data will be added in O\+S\+C byteorder (bigendian).


\begin{DoxyParams}{Parameters}
{\em m} & The message to be extended. \\
\hline
{\em types} & The types of the data items in the message, types are defined in lo\+\_\+types\+\_\+common.\+h \\
\hline
{\em ...} & The data values to be transmitted. The types of the arguments passed here must agree with the types specified in the type parameter.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gac0ae2fc81d2a48fe63b0803637997fd4}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+blob@{lo\+\_\+message\+\_\+add\+\_\+blob}}
\index{lo\+\_\+message\+\_\+add\+\_\+blob@{lo\+\_\+message\+\_\+add\+\_\+blob}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+blob}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+blob (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{{\bf lo\+\_\+blob}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gac0ae2fc81d2a48fe63b0803637997fd4}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gab2423db077dea59c4049103819d2810b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+char@{lo\+\_\+message\+\_\+add\+\_\+char}}
\index{lo\+\_\+message\+\_\+add\+\_\+char@{lo\+\_\+message\+\_\+add\+\_\+char}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+char}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+char (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{char}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gab2423db077dea59c4049103819d2810b}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gadd3a8441ad5a749c43694e77594cf47b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+double@{lo\+\_\+message\+\_\+add\+\_\+double}}
\index{lo\+\_\+message\+\_\+add\+\_\+double@{lo\+\_\+message\+\_\+add\+\_\+double}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+double}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+double (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{double}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gadd3a8441ad5a749c43694e77594cf47b}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga1c8a136e87e3d2befeb466e0a8a5a4ad}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+false@{lo\+\_\+message\+\_\+add\+\_\+false}}
\index{lo\+\_\+message\+\_\+add\+\_\+false@{lo\+\_\+message\+\_\+add\+\_\+false}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+false}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+false (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga1c8a136e87e3d2befeb466e0a8a5a4ad}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga42815097ea691fd1ec0798beca7f8e5e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+float@{lo\+\_\+message\+\_\+add\+\_\+float}}
\index{lo\+\_\+message\+\_\+add\+\_\+float@{lo\+\_\+message\+\_\+add\+\_\+float}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+float}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+float (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{float}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga42815097ea691fd1ec0798beca7f8e5e}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga4cbd7d3834a67446b15f53acf316a72a}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+infinitum@{lo\+\_\+message\+\_\+add\+\_\+infinitum}}
\index{lo\+\_\+message\+\_\+add\+\_\+infinitum@{lo\+\_\+message\+\_\+add\+\_\+infinitum}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+infinitum}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+infinitum (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga4cbd7d3834a67446b15f53acf316a72a}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+int32@{lo\+\_\+message\+\_\+add\+\_\+int32}}
\index{lo\+\_\+message\+\_\+add\+\_\+int32@{lo\+\_\+message\+\_\+add\+\_\+int32}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+int32}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+int32 (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{int32\+\_\+t}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}


Append a data item and typechar of the specified type to a message. 

The data will be added in O\+S\+C byteorder (bigendian).


\begin{DoxyParams}{Parameters}
{\em m} & The message to be extended. \\
\hline
{\em a} & The data item.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga282ef81387abab0ce18f7479a4a817b5}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+int64@{lo\+\_\+message\+\_\+add\+\_\+int64}}
\index{lo\+\_\+message\+\_\+add\+\_\+int64@{lo\+\_\+message\+\_\+add\+\_\+int64}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+int64}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+int64 (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{int64\+\_\+t}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga282ef81387abab0ce18f7479a4a817b5}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gaaea6ac25787de608199a988dc214f32e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+midi@{lo\+\_\+message\+\_\+add\+\_\+midi}}
\index{lo\+\_\+message\+\_\+add\+\_\+midi@{lo\+\_\+message\+\_\+add\+\_\+midi}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+midi}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+midi (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{uint8\+\_\+t}]{a\mbox{[}4\mbox{]}}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaaea6ac25787de608199a988dc214f32e}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_gabd3cd7f86137ae1a180e33c3bc5c9644}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+nil@{lo\+\_\+message\+\_\+add\+\_\+nil}}
\index{lo\+\_\+message\+\_\+add\+\_\+nil@{lo\+\_\+message\+\_\+add\+\_\+nil}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+nil}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+nil (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gabd3cd7f86137ae1a180e33c3bc5c9644}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga4ff414b1b3d87454668dfd728b830888}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+string@{lo\+\_\+message\+\_\+add\+\_\+string}}
\index{lo\+\_\+message\+\_\+add\+\_\+string@{lo\+\_\+message\+\_\+add\+\_\+string}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+string}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+string (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{const char $\ast$}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga4ff414b1b3d87454668dfd728b830888}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga90e4dab46ecaabab4e34214429d622a7}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+symbol@{lo\+\_\+message\+\_\+add\+\_\+symbol}}
\index{lo\+\_\+message\+\_\+add\+\_\+symbol@{lo\+\_\+message\+\_\+add\+\_\+symbol}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+symbol}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+symbol (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{const char $\ast$}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga90e4dab46ecaabab4e34214429d622a7}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga03f8eafa4ba598c545f30e17b23d1c89}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+timetag@{lo\+\_\+message\+\_\+add\+\_\+timetag}}
\index{lo\+\_\+message\+\_\+add\+\_\+timetag@{lo\+\_\+message\+\_\+add\+\_\+timetag}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+timetag}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+timetag (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{{\bf lo\+\_\+timetag}}]{a}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga03f8eafa4ba598c545f30e17b23d1c89}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga9da3df4838126910171a8e45ea34e9ec}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+true@{lo\+\_\+message\+\_\+add\+\_\+true}}
\index{lo\+\_\+message\+\_\+add\+\_\+true@{lo\+\_\+message\+\_\+add\+\_\+true}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+true}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+true (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga9da3df4838126910171a8e45ea34e9ec}


Append a data item and typechar of the specified type to a message. See \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32()} for details. 

\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga9cd98b0c6ad5468692fd0b1936bd093f}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+add\+\_\+varargs@{lo\+\_\+message\+\_\+add\+\_\+varargs}}
\index{lo\+\_\+message\+\_\+add\+\_\+varargs@{lo\+\_\+message\+\_\+add\+\_\+varargs}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+add\+\_\+varargs}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+add\+\_\+varargs (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{const char $\ast$}]{types, }
\item[{va\+\_\+list}]{ap}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga9cd98b0c6ad5468692fd0b1936bd093f}


Append a varargs list to a message. 

The data will be added in O\+S\+C byteorder (bigendian). I\+M\+P\+O\+R\+T\+A\+N\+T\+: args list must be terminated with L\+O\+\_\+\+A\+R\+G\+S\+\_\+\+E\+N\+D, or this call will fail. This is used to do simple error checking on the sizes of parameters passed.


\begin{DoxyParams}{Parameters}
{\em m} & The message to be extended. \\
\hline
{\em types} & The types of the data items in the message, types are defined in lo\+\_\+types\+\_\+common.\+h \\
\hline
{\em ap} & The va\+\_\+list created by a C function declared with an ellipsis (...) argument, and pre-\/initialised with \char`\"{}va\+\_\+start(ap)\char`\"{}. The types of the arguments passed here must agree with the types specified in the type parameter.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Less than 0 on failure, 0 on success. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga8cf4889aa1b479e3b6eaf8847c3b9e4f}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+clone@{lo\+\_\+message\+\_\+clone}}
\index{lo\+\_\+message\+\_\+clone@{lo\+\_\+message\+\_\+clone}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+clone}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+message} lo\+\_\+message\+\_\+clone (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga8cf4889aa1b479e3b6eaf8847c3b9e4f}


Create a new lo\+\_\+message object by cloning an already existing one. 

\hypertarget{group__liblolowlevel_ga2f4644b2a1aae0d0eee456fe93ac158e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+deserialise@{lo\+\_\+message\+\_\+deserialise}}
\index{lo\+\_\+message\+\_\+deserialise@{lo\+\_\+message\+\_\+deserialise}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+deserialise}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+message} lo\+\_\+message\+\_\+deserialise (
\begin{DoxyParamCaption}
\item[{void $\ast$}]{data, }
\item[{size\+\_\+t}]{size, }
\item[{int $\ast$}]{result}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga2f4644b2a1aae0d0eee456fe93ac158e}


Deserialise a raw O\+S\+C message and return a new lo\+\_\+message object. Opposite of \hyperlink{group__liblolowlevel_ga5a14045edea33d63792e9a4c82e13b02}{lo\+\_\+message\+\_\+serialise()}. 


\begin{DoxyParams}{Parameters}
{\em data} & Pointer to the raw O\+S\+C message data in network transmission form (network byte order where appropriate). \\
\hline
{\em size} & The size of data in bytes \\
\hline
{\em result} & If this pointer is non-\/\+N\+U\+L\+L, the result or error code will be written here.\\
\hline
\end{DoxyParams}
Returns a new lo\+\_\+message, or N\+U\+L\+L if deserialisation fails. Use \hyperlink{group__liblolowlevel_ga93d3687e77ae20167b82830c917a3e50}{lo\+\_\+message\+\_\+free()} to free the resulting object. \hypertarget{group__liblolowlevel_ga93d3687e77ae20167b82830c917a3e50}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+free@{lo\+\_\+message\+\_\+free}}
\index{lo\+\_\+message\+\_\+free@{lo\+\_\+message\+\_\+free}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+free}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+message\+\_\+free (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga93d3687e77ae20167b82830c917a3e50}


Free memory allocated by \hyperlink{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}{lo\+\_\+message\+\_\+new()} and any subsequent \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add\+\_\+int32} lo\+\_\+message\+\_\+add$\ast$() calls. 

\hypertarget{group__liblolowlevel_ga5b391362eda2c6019011f3db55049db3}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+get\+\_\+argc@{lo\+\_\+message\+\_\+get\+\_\+argc}}
\index{lo\+\_\+message\+\_\+get\+\_\+argc@{lo\+\_\+message\+\_\+get\+\_\+argc}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+get\+\_\+argc}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+message\+\_\+get\+\_\+argc (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga5b391362eda2c6019011f3db55049db3}


Return the message argument count. 

The result is valid until further data is added with lo\+\_\+message\+\_\+add$\ast$(). \hypertarget{group__liblolowlevel_gab28b48cdbefb60eb7e57557ae9d23171}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+get\+\_\+argv@{lo\+\_\+message\+\_\+get\+\_\+argv}}
\index{lo\+\_\+message\+\_\+get\+\_\+argv@{lo\+\_\+message\+\_\+get\+\_\+argv}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+get\+\_\+argv}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+arg}$\ast$$\ast$ lo\+\_\+message\+\_\+get\+\_\+argv (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gab28b48cdbefb60eb7e57557ae9d23171}


Return the message arguments. Do not free the returned data. 

The result is valid until further data is added with lo\+\_\+message\+\_\+add$\ast$(). \hypertarget{group__liblolowlevel_ga1f4e07e4f8b67edc98f4b300412a3dbb}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+get\+\_\+source@{lo\+\_\+message\+\_\+get\+\_\+source}}
\index{lo\+\_\+message\+\_\+get\+\_\+source@{lo\+\_\+message\+\_\+get\+\_\+source}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+get\+\_\+source}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+address} lo\+\_\+message\+\_\+get\+\_\+source (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga1f4e07e4f8b67edc98f4b300412a3dbb}


Returns the source (lo\+\_\+address) of an incoming message. 

Returns N\+U\+L\+L if the message is outgoing. Do not free the returned address. \hypertarget{group__liblolowlevel_ga164e068064afa94454eb6515b9b1748d}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+get\+\_\+timestamp@{lo\+\_\+message\+\_\+get\+\_\+timestamp}}
\index{lo\+\_\+message\+\_\+get\+\_\+timestamp@{lo\+\_\+message\+\_\+get\+\_\+timestamp}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+get\+\_\+timestamp}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+timetag} lo\+\_\+message\+\_\+get\+\_\+timestamp (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga164e068064afa94454eb6515b9b1748d}


Returns the timestamp (\hyperlink{structlo__timetag}{lo\+\_\+timetag} $\ast$) of a bundled incoming message. 

Returns L\+O\+\_\+\+T\+T\+\_\+\+I\+M\+M\+E\+D\+I\+A\+T\+E if the message is outgoing, or did not arrive contained in a bundle. Do not free the returned timetag. \hypertarget{group__liblolowlevel_gad3c1a312fd90bb4c35a4c1fac2d0b25d}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+get\+\_\+types@{lo\+\_\+message\+\_\+get\+\_\+types}}
\index{lo\+\_\+message\+\_\+get\+\_\+types@{lo\+\_\+message\+\_\+get\+\_\+types}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+get\+\_\+types}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+message\+\_\+get\+\_\+types (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad3c1a312fd90bb4c35a4c1fac2d0b25d}


Return the message type tag string. 

The result is valid until further data is added with lo\+\_\+message\+\_\+add$\ast$(). \hypertarget{group__liblolowlevel_gae4007dd073375b8448a0c8efcb39da52}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+incref@{lo\+\_\+message\+\_\+incref}}
\index{lo\+\_\+message\+\_\+incref@{lo\+\_\+message\+\_\+incref}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+incref}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+message\+\_\+incref (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gae4007dd073375b8448a0c8efcb39da52}


Add one to a message's reference count. 

Messages are reference counted. If a message is multiply referenced, the message's counter should be incremented. It is automatically decremented by lo\+\_\+message\+\_\+free lo\+\_\+message\+\_\+free\+\_\+recursive, with lo\+\_\+message\+\_\+free\+\_\+recursive being the preferable method. \hypertarget{group__liblolowlevel_ga0855039d071b7031727213272857c27e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+length@{lo\+\_\+message\+\_\+length}}
\index{lo\+\_\+message\+\_\+length@{lo\+\_\+message\+\_\+length}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+length}]{\setlength{\rightskip}{0pt plus 5cm}size\+\_\+t lo\+\_\+message\+\_\+length (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{const char $\ast$}]{path}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga0855039d071b7031727213272857c27e}


Return the length of a message in bytes. 


\begin{DoxyParams}{Parameters}
{\em m} & The message to be sized \\
\hline
{\em path} & The path the message will be sent to \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+new@{lo\+\_\+message\+\_\+new}}
\index{lo\+\_\+message\+\_\+new@{lo\+\_\+message\+\_\+new}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+new}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+message} lo\+\_\+message\+\_\+new (
\begin{DoxyParamCaption}
{}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}


Create a new lo\+\_\+message object. 

\hypertarget{group__liblolowlevel_ga5a14045edea33d63792e9a4c82e13b02}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+message\+\_\+serialise@{lo\+\_\+message\+\_\+serialise}}
\index{lo\+\_\+message\+\_\+serialise@{lo\+\_\+message\+\_\+serialise}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+message\+\_\+serialise}]{\setlength{\rightskip}{0pt plus 5cm}void$\ast$ lo\+\_\+message\+\_\+serialise (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+message}}]{m, }
\item[{const char $\ast$}]{path, }
\item[{void $\ast$}]{to, }
\item[{size\+\_\+t $\ast$}]{size}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga5a14045edea33d63792e9a4c82e13b02}


Serialise the lo\+\_\+message object to an area of memory and return a pointer to the serialised form. Opposite of \hyperlink{group__liblolowlevel_ga2f4644b2a1aae0d0eee456fe93ac158e}{lo\+\_\+message\+\_\+deserialise()}. 


\begin{DoxyParams}{Parameters}
{\em m} & The message to be serialised \\
\hline
{\em path} & The path the message will be sent to \\
\hline
{\em to} & The address to serialise to, memory will be allocated if to is N\+U\+L\+L. \\
\hline
{\em size} & If this pointer is non-\/\+N\+U\+L\+L the size of the memory area will be written here\\
\hline
\end{DoxyParams}
The returned form is suitable to be sent over a low level O\+S\+C transport, having the correct endianess and bit-\/packed structure. \hypertarget{group__liblolowlevel_gac26f3d15dbd23f34d4f9e4f6f0b81bbb}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+pattern\+\_\+match@{lo\+\_\+pattern\+\_\+match}}
\index{lo\+\_\+pattern\+\_\+match@{lo\+\_\+pattern\+\_\+match}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+pattern\+\_\+match}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+pattern\+\_\+match (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{str, }
\item[{const char $\ast$}]{p}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gac26f3d15dbd23f34d4f9e4f6f0b81bbb}


Test a string against an O\+S\+C pattern glob. 


\begin{DoxyParams}{Parameters}
{\em str} & The string to test \\
\hline
{\em p} & The pattern to test against \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gad1138d0f777693ae0321e3da65aee53e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+send\+\_\+bundle@{lo\+\_\+send\+\_\+bundle}}
\index{lo\+\_\+send\+\_\+bundle@{lo\+\_\+send\+\_\+bundle}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+send\+\_\+bundle}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+send\+\_\+bundle (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{targ, }
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad1138d0f777693ae0321e3da65aee53e}


Send a lo\+\_\+bundle object to address targ. 

Bundles are constructed with the \hyperlink{group__liblolowlevel_ga330a4a4e6227b185b3ec6219ff3e2859}{lo\+\_\+bundle\+\_\+new()} and \hyperlink{group__liblolowlevel_ga1cc5e2eb20ce567a694f343764e25bb7}{lo\+\_\+bundle\+\_\+add\+\_\+message()} functions. \hypertarget{group__liblolowlevel_gab5de220b7d6d7c2bf6b0ca4316a54b7a}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+send\+\_\+bundle\+\_\+from@{lo\+\_\+send\+\_\+bundle\+\_\+from}}
\index{lo\+\_\+send\+\_\+bundle\+\_\+from@{lo\+\_\+send\+\_\+bundle\+\_\+from}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+send\+\_\+bundle\+\_\+from}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+send\+\_\+bundle\+\_\+from (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{targ, }
\item[{{\bf lo\+\_\+server}}]{serv, }
\item[{{\bf lo\+\_\+bundle}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gab5de220b7d6d7c2bf6b0ca4316a54b7a}


Send a lo\+\_\+bundle object to address targ from address of serv. 

Bundles are constructed with the \hyperlink{group__liblolowlevel_ga330a4a4e6227b185b3ec6219ff3e2859}{lo\+\_\+bundle\+\_\+new()} and \hyperlink{group__liblolowlevel_ga1cc5e2eb20ce567a694f343764e25bb7}{lo\+\_\+bundle\+\_\+add\+\_\+message()} functions.


\begin{DoxyParams}{Parameters}
{\em targ} & The address to send the bundle to \\
\hline
{\em serv} & The server socket to send the bundle from (can be N\+U\+L\+L to use new socket) \\
\hline
{\em b} & The bundle itself \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga175a13c6d81adf5c346cdca9bbdcf225}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+send\+\_\+message@{lo\+\_\+send\+\_\+message}}
\index{lo\+\_\+send\+\_\+message@{lo\+\_\+send\+\_\+message}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+send\+\_\+message}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+send\+\_\+message (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{targ, }
\item[{const char $\ast$}]{path, }
\item[{{\bf lo\+\_\+message}}]{msg}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga175a13c6d81adf5c346cdca9bbdcf225}


Send a lo\+\_\+message object to target targ. 

This is slightly more efficient than \hyperlink{group__liblo_gafa4253874f97c2c16254ac57d2b7c987}{lo\+\_\+send()} if you want to send a lot of similar messages. The messages are constructed with the \hyperlink{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}{lo\+\_\+message\+\_\+new()} and \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add$\ast$()} functions. \hypertarget{group__liblolowlevel_ga9d1aa7c1ee1ce60fe0cf7e3f1e5a6822}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+send\+\_\+message\+\_\+from@{lo\+\_\+send\+\_\+message\+\_\+from}}
\index{lo\+\_\+send\+\_\+message\+\_\+from@{lo\+\_\+send\+\_\+message\+\_\+from}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+send\+\_\+message\+\_\+from}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+send\+\_\+message\+\_\+from (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+address}}]{targ, }
\item[{{\bf lo\+\_\+server}}]{serv, }
\item[{const char $\ast$}]{path, }
\item[{{\bf lo\+\_\+message}}]{msg}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga9d1aa7c1ee1ce60fe0cf7e3f1e5a6822}


Send a lo\+\_\+message object to target targ from address of serv. 

This is slightly more efficient than \hyperlink{group__liblo_gafa4253874f97c2c16254ac57d2b7c987}{lo\+\_\+send()} if you want to send a lot of similar messages. The messages are constructed with the \hyperlink{group__liblolowlevel_ga2cce2e97452e3e9d6b5d3af33bb1d153}{lo\+\_\+message\+\_\+new()} and \hyperlink{group__liblolowlevel_ga7c9df1bd975a32fb6c8105e6fe327149}{lo\+\_\+message\+\_\+add$\ast$()} functions.


\begin{DoxyParams}{Parameters}
{\em targ} & The address to send the message to \\
\hline
{\em serv} & The server socket to send the message from (can be N\+U\+L\+L to use new socket) \\
\hline
{\em path} & The path to send the message to \\
\hline
{\em msg} & The bundle itself \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga1411fdb0c8037a4dd3ab19af35df50ac}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers@{lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers}}
\index{lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers@{lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+add\+\_\+bundle\+\_\+handlers (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{{\bf lo\+\_\+bundle\+\_\+start\+\_\+handler}}]{sh, }
\item[{{\bf lo\+\_\+bundle\+\_\+end\+\_\+handler}}]{eh, }
\item[{void $\ast$}]{user\+\_\+data}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga1411fdb0c8037a4dd3ab19af35df50ac}


Add bundle notification handlers to the specified server. 


\begin{DoxyParams}{Parameters}
{\em s} & The server the method is to be added to. \\
\hline
{\em sh} & The callback function that will be called before the messages of a bundle are dispatched \\
\hline
{\em eh} & The callback function that will be called after the messages of a bundle are dispatched \\
\hline
{\em user\+\_\+data} & A value that will be passed to the user\+\_\+data parameter of both callback functions. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga0c183cabaac67eb9aad3265ae1efa580}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+add\+\_\+method@{lo\+\_\+server\+\_\+add\+\_\+method}}
\index{lo\+\_\+server\+\_\+add\+\_\+method@{lo\+\_\+server\+\_\+add\+\_\+method}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+add\+\_\+method}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+method} lo\+\_\+server\+\_\+add\+\_\+method (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{const char $\ast$}]{path, }
\item[{const char $\ast$}]{typespec, }
\item[{{\bf lo\+\_\+method\+\_\+handler}}]{h, }
\item[{void $\ast$}]{user\+\_\+data}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga0c183cabaac67eb9aad3265ae1efa580}


Add an O\+S\+C method to the specifed server. 


\begin{DoxyParams}{Parameters}
{\em s} & The server the method is to be added to. \\
\hline
{\em path} & The O\+S\+C path to register the method to. If N\+U\+L\+L is passed the method will match all paths. \\
\hline
{\em typespec} & The typespec the method accepts. Incoming messages with similar typespecs (e.\+g. ones with numerical types in the same position) will be coerced to the typespec given here. \\
\hline
{\em h} & The method handler callback function that will be called if a matching message is received \\
\hline
{\em user\+\_\+data} & A value that will be passed to the callback function, h, when its invoked matching from this method. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gaf834a6d62de7dcceaede62325e74c763}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+del\+\_\+method@{lo\+\_\+server\+\_\+del\+\_\+method}}
\index{lo\+\_\+server\+\_\+del\+\_\+method@{lo\+\_\+server\+\_\+del\+\_\+method}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+del\+\_\+method}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+server\+\_\+del\+\_\+method (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{const char $\ast$}]{path, }
\item[{const char $\ast$}]{typespec}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaf834a6d62de7dcceaede62325e74c763}


Delete an O\+S\+C method from the specifed server. 


\begin{DoxyParams}{Parameters}
{\em s} & The server the method is to be removed from. \\
\hline
{\em path} & The O\+S\+C path of the method to delete. If N\+U\+L\+L is passed the method will match the generic handler. \\
\hline
{\em typespec} & The typespec the method accepts. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga9e96445401c94c3751de27f8db1a0b50}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+dispatch\+\_\+data@{lo\+\_\+server\+\_\+dispatch\+\_\+data}}
\index{lo\+\_\+server\+\_\+dispatch\+\_\+data@{lo\+\_\+server\+\_\+dispatch\+\_\+data}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+dispatch\+\_\+data}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+dispatch\+\_\+data (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{void $\ast$}]{data, }
\item[{size\+\_\+t}]{size}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga9e96445401c94c3751de27f8db1a0b50}


Dispatch a raw block of memory containing an O\+S\+C message. 

This is useful when a raw block of memory is available that is structured as O\+S\+C, and you wish to use liblo to dispatch the message to a handler function as if it had been received over the network.


\begin{DoxyParams}{Parameters}
{\em s} & The lo\+\_\+server to use for dispatching. \\
\hline
{\em data} & Pointer to the raw O\+S\+C message data in network transmission form (network byte order where appropriate). \\
\hline
{\em size} & The size of data in bytes\\
\hline
\end{DoxyParams}
Returns the number of bytes used if successful, or less than 0 otherwise. \hypertarget{group__liblolowlevel_ga175ef81fc2d695895967bfc30a495b2a}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+enable\+\_\+coercion@{lo\+\_\+server\+\_\+enable\+\_\+coercion}}
\index{lo\+\_\+server\+\_\+enable\+\_\+coercion@{lo\+\_\+server\+\_\+enable\+\_\+coercion}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+enable\+\_\+coercion}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+enable\+\_\+coercion (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{server, }
\item[{int}]{enable}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga175ef81fc2d695895967bfc30a495b2a}


Enables or disables type coercion during message dispatch. 


\begin{DoxyParams}{Parameters}
{\em server} & The server to toggle this option for. \\
\hline
{\em enable} & Non-\/zero to enable, or zero to disable type coercion. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The previous value of this option. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga3e23b9b6027042e136f344d001431ac6}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+enable\+\_\+queue@{lo\+\_\+server\+\_\+enable\+\_\+queue}}
\index{lo\+\_\+server\+\_\+enable\+\_\+queue@{lo\+\_\+server\+\_\+enable\+\_\+queue}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+enable\+\_\+queue}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+enable\+\_\+queue (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{int}]{queue\+\_\+enabled, }
\item[{int}]{dispatch\+\_\+remaining}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga3e23b9b6027042e136f344d001431ac6}


Toggle event queue. If queueing is enabled, timetagged messages that are sent in advance of the current time will be put on an internal queue, and they will be dispatched at the indicated time. By default, queueing is enabled. Use this function to disable it, if it is desired to have a server process messages immediately. In that case, use \hyperlink{group__liblolowlevel_ga164e068064afa94454eb6515b9b1748d}{lo\+\_\+message\+\_\+get\+\_\+timestamp()} to get the message timestamp from within a method handler. 


\begin{DoxyParams}{Parameters}
{\em s} & A liblo server \\
\hline
{\em queue\+\_\+enabled} & Zero to disable queue, non-\/zero to enable. \\
\hline
{\em dispatch\+\_\+remaining} & If non-\/zero, previously queued messages will be immediately dispatched when queue is disabled. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The previous state of queue behaviour. Zero if queueing was previously disabled, non-\/zero otherwise. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga04feb1063c3f4df6fec41405b28dd99a}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+events\+\_\+pending@{lo\+\_\+server\+\_\+events\+\_\+pending}}
\index{lo\+\_\+server\+\_\+events\+\_\+pending@{lo\+\_\+server\+\_\+events\+\_\+pending}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+events\+\_\+pending}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+events\+\_\+pending (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga04feb1063c3f4df6fec41405b28dd99a}


Return true if there are scheduled events (eg. from bundles) waiting to be dispatched by the server. 

\hypertarget{group__liblolowlevel_gad3dc9193e1eef0d71a4b046242b64216}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+free@{lo\+\_\+server\+\_\+free}}
\index{lo\+\_\+server\+\_\+free@{lo\+\_\+server\+\_\+free}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+free}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+server\+\_\+free (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad3dc9193e1eef0d71a4b046242b64216}


Free up memory used by the lo\+\_\+server object. 

\hypertarget{group__liblolowlevel_ga532ef6e1b8675b23e65dd19eeb648c1d}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+get\+\_\+port@{lo\+\_\+server\+\_\+get\+\_\+port}}
\index{lo\+\_\+server\+\_\+get\+\_\+port@{lo\+\_\+server\+\_\+get\+\_\+port}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+get\+\_\+port}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+get\+\_\+port (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga532ef6e1b8675b23e65dd19eeb648c1d}


Return the port number that the server has bound to. 

Useful when N\+U\+L\+L is passed for the port number and you wish to know how to address the server. \hypertarget{group__liblolowlevel_gab40a599fe8440512b18479dac333e89f}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+get\+\_\+protocol@{lo\+\_\+server\+\_\+get\+\_\+protocol}}
\index{lo\+\_\+server\+\_\+get\+\_\+protocol@{lo\+\_\+server\+\_\+get\+\_\+protocol}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+get\+\_\+protocol}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+get\+\_\+protocol (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gab40a599fe8440512b18479dac333e89f}


Return the protocol that the server is using. 

Returned value will be one of L\+O\+\_\+\+U\+D\+P, L\+O\+\_\+\+T\+C\+P or L\+O\+\_\+\+U\+N\+I\+X. \hypertarget{group__liblolowlevel_gae11ca5a5b4ec2943d5a04642ba5052ae}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd@{lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd}}
\index{lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd@{lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+get\+\_\+socket\+\_\+fd (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gae11ca5a5b4ec2943d5a04642ba5052ae}


Return the file descriptor of the server socket. 

If the server protocol supports exposing the server's underlying receive mechanism for monitoring with select() or poll(), this function returns the file descriptor needed, otherwise, it returns -\/1.

W\+A\+R\+N\+I\+N\+G\+: when using this function beware that not all O\+S\+C packets that are received are dispatched immediately. \hyperlink{group__liblolowlevel_ga04feb1063c3f4df6fec41405b28dd99a}{lo\+\_\+server\+\_\+events\+\_\+pending()} and \hyperlink{group__liblolowlevel_ga750076fdd75e2a7d3e442f6bd5968fb9}{lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay()} can be used to tell if there are pending events and how long before you should attempt to receive them. \hypertarget{group__liblolowlevel_ga33df48c641833d330a8ba6704caf4977}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+get\+\_\+url@{lo\+\_\+server\+\_\+get\+\_\+url}}
\index{lo\+\_\+server\+\_\+get\+\_\+url@{lo\+\_\+server\+\_\+get\+\_\+url}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+get\+\_\+url}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+server\+\_\+get\+\_\+url (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga33df48c641833d330a8ba6704caf4977}


Return an O\+S\+C U\+R\+L that can be used to contact the server. 

The return value should be free()'d when it is no longer needed. \hypertarget{group__liblolowlevel_ga78cfb23346e44465695293d4393447ae}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+new@{lo\+\_\+server\+\_\+new}}
\index{lo\+\_\+server\+\_\+new@{lo\+\_\+server\+\_\+new}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+new}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+server} lo\+\_\+server\+\_\+new (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{port, }
\item[{{\bf lo\+\_\+err\+\_\+handler}}]{err\+\_\+h}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga78cfb23346e44465695293d4393447ae}


Create a new server instance. 

Using \hyperlink{group__liblolowlevel_gaebef3611d24e4b5f60f16cce76a9e271}{lo\+\_\+server\+\_\+recv()}, lo\+\_\+servers block until they receive O\+S\+C messages. If you want non-\/blocking behaviour see \hyperlink{group__liblolowlevel_ga784a257252d05cc0e7210f4691f0661b}{lo\+\_\+server\+\_\+recv\+\_\+noblock()} or the \hyperlink{lo__serverthread_8h_abe3e0c31189adfd7624de6c507b610ba}{lo\+\_\+server\+\_\+thread\+\_\+$\ast$} functions.


\begin{DoxyParams}{Parameters}
{\em port} & If N\+U\+L\+L is passed then an unused U\+D\+P port will be chosen by the system, its number may be retrieved with \hyperlink{lo__serverthread_8h_a22f4b18eeac41490647ab9fe2333f933}{lo\+\_\+server\+\_\+thread\+\_\+get\+\_\+port()} so it can be passed to clients. Otherwise a decimal port number, service name or U\+N\+I\+X domain socket path may be passed. \\
\hline
{\em err\+\_\+h} & An error callback function that will be called if there is an error in messge reception or server creation. Pass N\+U\+L\+L if you do not want error handling. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga1246a1f4a2ba967d31017452a32daf2a}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url@{lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url}}
\index{lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url@{lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+server} lo\+\_\+server\+\_\+new\+\_\+from\+\_\+url (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{url, }
\item[{{\bf lo\+\_\+err\+\_\+handler}}]{err\+\_\+h}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga1246a1f4a2ba967d31017452a32daf2a}


Create a new server instance, taking port and the optional multicast group I\+P from an U\+R\+L string. 


\begin{DoxyParams}{Parameters}
{\em url} & The U\+R\+L to specify the server parameters. \\
\hline
{\em err\+\_\+h} & An error callback function that will be called if there is an error in messge reception or server creation. Pass N\+U\+L\+L if you do not want error handling. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A new lo\+\_\+server instance. 
\end{DoxyReturn}
\hypertarget{group__liblolowlevel_ga849f4517a29ad850069cf8f2976a9284}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+new\+\_\+multicast@{lo\+\_\+server\+\_\+new\+\_\+multicast}}
\index{lo\+\_\+server\+\_\+new\+\_\+multicast@{lo\+\_\+server\+\_\+new\+\_\+multicast}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+new\+\_\+multicast}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+server} lo\+\_\+server\+\_\+new\+\_\+multicast (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{group, }
\item[{const char $\ast$}]{port, }
\item[{{\bf lo\+\_\+err\+\_\+handler}}]{err\+\_\+h}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga849f4517a29ad850069cf8f2976a9284}


Create a new server instance, and join a U\+D\+P multicast group. 


\begin{DoxyParams}{Parameters}
{\em group} & The multicast group to join. See documentation on I\+P multicast for the acceptable address range; e.\+g., \href{http://tldp.org/HOWTO/Multicast-HOWTO-2.html}{\tt http\+://tldp.\+org/\+H\+O\+W\+T\+O/\+Multicast-\/\+H\+O\+W\+T\+O-\/2.\+html} \\
\hline
{\em port} & If using U\+D\+P then N\+U\+L\+L may be passed to find an unused port. Otherwise a decimal port number or service name or may be passed. If using U\+N\+I\+X domain sockets then a socket path should be passed here. \\
\hline
{\em err\+\_\+h} & An error callback function that will be called if there is an error in messge reception or server creation. Pass N\+U\+L\+L if you do not want error handling. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_gadec49f210324f499f2e9593df20128cb}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface@{lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface}}
\index{lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface@{lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+server} lo\+\_\+server\+\_\+new\+\_\+multicast\+\_\+iface (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{group, }
\item[{const char $\ast$}]{port, }
\item[{const char $\ast$}]{iface, }
\item[{const char $\ast$}]{ip, }
\item[{{\bf lo\+\_\+err\+\_\+handler}}]{err\+\_\+h}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gadec49f210324f499f2e9593df20128cb}


Create a new server instance, and join a U\+D\+P multicast group, optionally specifying which network interface to use. Note that usually only one of iface or ip are specified. 


\begin{DoxyParams}{Parameters}
{\em group} & The multicast group to join. See documentation on I\+P multicast for the acceptable address range; e.\+g., \href{http://tldp.org/HOWTO/Multicast-HOWTO-2.html}{\tt http\+://tldp.\+org/\+H\+O\+W\+T\+O/\+Multicast-\/\+H\+O\+W\+T\+O-\/2.\+html} \\
\hline
{\em port} & If using U\+D\+P then N\+U\+L\+L may be passed to find an unused port. Otherwise a decimal port number or service name or may be passed. If using U\+N\+I\+X domain sockets then a socket path should be passed here. \\
\hline
{\em iface} & A string specifying the name of a network interface to use, or zero if not specified. \\
\hline
{\em ip} & A string specifying the I\+P address of a network interface to use, or zero if not specified. \\
\hline
{\em err\+\_\+h} & An error callback function that will be called if there is an error in messge reception or server creation. Pass N\+U\+L\+L if you do not want error handling. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga4afa474b11ed0d4511857ae79c56aaa1}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto@{lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto}}
\index{lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto@{lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto}]{\setlength{\rightskip}{0pt plus 5cm}{\bf lo\+\_\+server} lo\+\_\+server\+\_\+new\+\_\+with\+\_\+proto (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{port, }
\item[{int}]{proto, }
\item[{{\bf lo\+\_\+err\+\_\+handler}}]{err\+\_\+h}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga4afa474b11ed0d4511857ae79c56aaa1}


Create a new server instance, specifying protocol. 

Using \hyperlink{group__liblolowlevel_gaebef3611d24e4b5f60f16cce76a9e271}{lo\+\_\+server\+\_\+recv()}, lo\+\_\+servers block until they receive O\+S\+C messages. If you want non-\/blocking behaviour see \hyperlink{group__liblolowlevel_ga784a257252d05cc0e7210f4691f0661b}{lo\+\_\+server\+\_\+recv\+\_\+noblock()} or the \hyperlink{lo__serverthread_8h_abe3e0c31189adfd7624de6c507b610ba}{lo\+\_\+server\+\_\+thread\+\_\+$\ast$} functions.


\begin{DoxyParams}{Parameters}
{\em port} & If using U\+D\+P then N\+U\+L\+L may be passed to find an unused port. Otherwise a decimal port number orservice name or may be passed. If using U\+N\+I\+X domain sockets then a socket path should be passed here. \\
\hline
{\em proto} & The protocol to use, should be one of L\+O\+\_\+\+U\+D\+P, L\+O\+\_\+\+T\+C\+P or L\+O\+\_\+\+U\+N\+I\+X. \\
\hline
{\em err\+\_\+h} & An error callback function that will be called if there is an error in messge reception or server creation. Pass N\+U\+L\+L if you do not want error handling. \\
\hline
\end{DoxyParams}
\hypertarget{group__liblolowlevel_ga750076fdd75e2a7d3e442f6bd5968fb9}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay@{lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay}}
\index{lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay@{lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay}]{\setlength{\rightskip}{0pt plus 5cm}double lo\+\_\+server\+\_\+next\+\_\+event\+\_\+delay (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga750076fdd75e2a7d3e442f6bd5968fb9}


Return the time in seconds until the next scheduled event. 

If the delay is greater than 100 seconds then it will return 100.\+0. \hypertarget{group__liblolowlevel_gaebef3611d24e4b5f60f16cce76a9e271}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+recv@{lo\+\_\+server\+\_\+recv}}
\index{lo\+\_\+server\+\_\+recv@{lo\+\_\+server\+\_\+recv}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+recv}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+recv (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gaebef3611d24e4b5f60f16cce76a9e271}


Block, waiting for an O\+S\+C message to be received. 

The return value is the number of bytes in the received message. The message will be dispatched to a matching method if one is found. \hypertarget{group__liblolowlevel_ga784a257252d05cc0e7210f4691f0661b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+recv\+\_\+noblock@{lo\+\_\+server\+\_\+recv\+\_\+noblock}}
\index{lo\+\_\+server\+\_\+recv\+\_\+noblock@{lo\+\_\+server\+\_\+recv\+\_\+noblock}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+recv\+\_\+noblock}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+recv\+\_\+noblock (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{int}]{timeout}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga784a257252d05cc0e7210f4691f0661b}


Look for an O\+S\+C message waiting to be received. 


\begin{DoxyParams}{Parameters}
{\em s} & The server to wait for connections on. \\
\hline
{\em timeout} & A timeout in milliseconds to wait for the incoming packet. a value of 0 will return immediately.\\
\hline
\end{DoxyParams}
The return value is the number of bytes in the received message or 0 if there is no message. The message will be dispatched to a matching method if one is found. \hypertarget{group__liblolowlevel_ga33cdcfbab89d58f82175386a76698822}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+server\+\_\+wait@{lo\+\_\+server\+\_\+wait}}
\index{lo\+\_\+server\+\_\+wait@{lo\+\_\+server\+\_\+wait}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+server\+\_\+wait}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+server\+\_\+wait (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+server}}]{s, }
\item[{int}]{timeout}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga33cdcfbab89d58f82175386a76698822}


Wait for an O\+S\+C message to be received. 


\begin{DoxyParams}{Parameters}
{\em s} & The server to wait for connections on. \\
\hline
{\em timeout} & A timeout in milliseconds to wait for the incoming packet. a value of 0 will return immediately.\\
\hline
\end{DoxyParams}
The return value is 1 if there is a message waiting or 0 if there is no message. If there is a message waiting you can now call \hyperlink{group__liblolowlevel_gaebef3611d24e4b5f60f16cce76a9e271}{lo\+\_\+server\+\_\+recv()} to receive that message. \hypertarget{group__liblolowlevel_gae62aa870bad161e4507f6338820ac243}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+strsize@{lo\+\_\+strsize}}
\index{lo\+\_\+strsize@{lo\+\_\+strsize}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+strsize}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+strsize (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{s}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gae62aa870bad161e4507f6338820ac243}


A function to calculate the amount of O\+S\+C message space required by a C char $\ast$. 

Returns the storage size in bytes, which will always be a multiple of four. \hypertarget{group__liblolowlevel_ga9937fce1bfce695b01cd3289ead8b919}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+timetag\+\_\+diff@{lo\+\_\+timetag\+\_\+diff}}
\index{lo\+\_\+timetag\+\_\+diff@{lo\+\_\+timetag\+\_\+diff}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+timetag\+\_\+diff}]{\setlength{\rightskip}{0pt plus 5cm}double lo\+\_\+timetag\+\_\+diff (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+timetag}}]{a, }
\item[{{\bf lo\+\_\+timetag}}]{b}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga9937fce1bfce695b01cd3289ead8b919}


Find the time difference between two timetags. 

Returns a -\/ b in seconds. \hypertarget{group__liblolowlevel_gad687e21ed611e68748e962502ae63d8e}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+timetag\+\_\+now@{lo\+\_\+timetag\+\_\+now}}
\index{lo\+\_\+timetag\+\_\+now@{lo\+\_\+timetag\+\_\+now}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+timetag\+\_\+now}]{\setlength{\rightskip}{0pt plus 5cm}void lo\+\_\+timetag\+\_\+now (
\begin{DoxyParamCaption}
\item[{{\bf lo\+\_\+timetag} $\ast$}]{t}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gad687e21ed611e68748e962502ae63d8e}


Return a timetag for the current time. 

On exit the timetag pointed to by t is filled with the O\+S\+C representation of this instant in time. \hypertarget{group__liblolowlevel_gab1b7df7061a0b2cd0db31d3fca1b399b}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+url\+\_\+get\+\_\+hostname@{lo\+\_\+url\+\_\+get\+\_\+hostname}}
\index{lo\+\_\+url\+\_\+get\+\_\+hostname@{lo\+\_\+url\+\_\+get\+\_\+hostname}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+url\+\_\+get\+\_\+hostname}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+url\+\_\+get\+\_\+hostname (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{url}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_gab1b7df7061a0b2cd0db31d3fca1b399b}


Return the hostname portion of an O\+S\+C U\+R\+L. 

The return value should be free()'d when it is no longer needed. \hypertarget{group__liblolowlevel_ga617d046cc702a2c5ab8539659381ef18}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+url\+\_\+get\+\_\+path@{lo\+\_\+url\+\_\+get\+\_\+path}}
\index{lo\+\_\+url\+\_\+get\+\_\+path@{lo\+\_\+url\+\_\+get\+\_\+path}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+url\+\_\+get\+\_\+path}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+url\+\_\+get\+\_\+path (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{url}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga617d046cc702a2c5ab8539659381ef18}


Return the path portion of an O\+S\+C U\+R\+L. 

The return value should be free()'d when it is no longer needed. \hypertarget{group__liblolowlevel_ga488fb8e96fb86320590c1a8ca389593d}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+url\+\_\+get\+\_\+port@{lo\+\_\+url\+\_\+get\+\_\+port}}
\index{lo\+\_\+url\+\_\+get\+\_\+port@{lo\+\_\+url\+\_\+get\+\_\+port}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+url\+\_\+get\+\_\+port}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+url\+\_\+get\+\_\+port (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{url}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga488fb8e96fb86320590c1a8ca389593d}


Return the port portion of an O\+S\+C U\+R\+L. 

The return value should be free()'d when it is no longer needed. \hypertarget{group__liblolowlevel_ga58266d3085b73fc4dc5e1913de810b22}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+url\+\_\+get\+\_\+protocol@{lo\+\_\+url\+\_\+get\+\_\+protocol}}
\index{lo\+\_\+url\+\_\+get\+\_\+protocol@{lo\+\_\+url\+\_\+get\+\_\+protocol}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+url\+\_\+get\+\_\+protocol}]{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ lo\+\_\+url\+\_\+get\+\_\+protocol (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{url}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga58266d3085b73fc4dc5e1913de810b22}


Return the protocol portion of an O\+S\+C U\+R\+L, eg. udp, tcp. 

This library uses O\+S\+C U\+R\+Ls of the form\+: osc.\+prot\+://hostname\+:port/path if the prot part is missing, U\+D\+P is assumed.

The return value should be free()'d when it is no longer needed. \hypertarget{group__liblolowlevel_ga0550cc91417b530c26a360b10072a3cb}{\index{Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}!lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id@{lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id}}
\index{lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id@{lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id}!Low-\/level O\+S\+C A\+P\+I@{Low-\/level O\+S\+C A\+P\+I}}
\subsubsection[{lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id}]{\setlength{\rightskip}{0pt plus 5cm}int lo\+\_\+url\+\_\+get\+\_\+protocol\+\_\+id (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{url}
\end{DoxyParamCaption}
)}}\label{group__liblolowlevel_ga0550cc91417b530c26a360b10072a3cb}


Return the protocol I\+D of an O\+S\+C U\+R\+L. 

This library uses O\+S\+C U\+R\+Ls of the form\+: osc.\+prot\+://hostname\+:port/path if the prot part is missing, U\+D\+P is assumed. Returned value will be one of L\+O\+\_\+\+U\+D\+P, L\+O\+\_\+\+T\+C\+P, L\+O\+\_\+\+U\+N\+I\+X or -\/1.

\begin{DoxyReturn}{Returns}
An integer specifying the protocol. Return -\/1 when the protocol is not supported by liblo. 
\end{DoxyReturn}
