\chapter{list\+Add}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add}{}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add}\index{listAdd@{listAdd}}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md279}{}\doxysubsection{\texorpdfstring{autotoc\+\_\+md279}{autotoc\+\_\+md279}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md279}
title\+: Arma\+Dragonfly\+Client -\/ List Add icon\+: mdi\+:file-\/text-\/outline \hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md280}{}\doxysubsection{\texorpdfstring{excerpt\+: Add element to list stored at key from Dragonfly\+Client.}{excerpt\+: Add element to list stored at key from Dragonfly\+Client.}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md280}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md281}{}\doxysection{\texorpdfstring{dragonfly\+\_\+db\+\_\+fnc\+\_\+list\+Add}{dragonfly\+\_\+db\+\_\+fnc\+\_\+list\+Add}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md281}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md282}{}\doxysubsection{\texorpdfstring{Description}{Description}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md282}
Adds an element to a list stored in the database under the specified key. This function appends values to an existing list or creates a new list if it doesn\textquotesingle{}t exist. It\textquotesingle{}s particularly useful for logging, event tracking, or maintaining collections of data that grow over time.\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md283}{}\doxysubsection{\texorpdfstring{Syntax}{Syntax}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md283}

\begin{DoxyCode}{0}
\DoxyCodeLine{[\_key,\ \_data]\ call\ dragonfly\_db\_fnc\_listAdd}

\end{DoxyCode}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md284}{}\doxysubsection{\texorpdfstring{Parameters}{Parameters}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md284}
\tabulinesep=1mm
\begin{longtabu}spread 0pt [c]{*{4}{|X[-1]}|}
\hline
\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Parameter   }&\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Type   }&\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Description   }&\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Default    }\\\cline{1-4}
\endfirsthead
\hline
\endfoot
\hline
\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Parameter   }&\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Type   }&\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Description   }&\PBS\centering \cellcolor{\tableheadbgcolor}\textbf{ Default    }\\\cline{1-4}
\endhead
{\ttfamily \+\_\+key}   &String   &Name of the list to add the element to   &"{}"{}    \\\cline{1-4}
{\ttfamily \+\_\+data}   &Array, String, Number, or Boolean   &The value to insert into the list   &\mbox{[}\mbox{]}   \\\cline{1-4}
\end{longtabu}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md285}{}\doxysubsection{\texorpdfstring{Return Value}{Return Value}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md285}
None. The operation runs synchronously to add the element to the list.\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md286}{}\doxysubsection{\texorpdfstring{Examples}{Examples}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md286}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md287}{}\doxysubsubsection{\texorpdfstring{Add an event log entry\+:}{Add an event log entry\+:}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md287}

\begin{DoxyCode}{0}
\DoxyCodeLine{["{}events"{},\ ["{}Server\ state\ saved\ to\ DB\ "{}\ +\ systemTimeUTC]]\ call\ dragonfly\_db\_fnc\_listAdd;}

\end{DoxyCode}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md288}{}\doxysubsubsection{\texorpdfstring{Add a player message\+:}{Add a player message\+:}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md288}

\begin{DoxyCode}{0}
\DoxyCodeLine{["{}messages"{},\ [name\ player\ +\ "{}:\ "{}\ +\ \_messageText]]\ call\ dragonfly\_db\_fnc\_listAdd;}

\end{DoxyCode}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md289}{}\doxysubsubsection{\texorpdfstring{Add data from a client\+:}{Add data from a client\+:}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md289}

\begin{DoxyCode}{0}
\DoxyCodeLine{["{}playerActions"{},\ [getPlayerUID\ player,\ name\ player,\ "{}logged\ in"{}]]\ remoteExecCall\ ["{}dragonfly\_db\_fnc\_listAdd"{},\ 2,\ false];}

\end{DoxyCode}
\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md290}{}\doxysubsection{\texorpdfstring{Notes}{Notes}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md290}

\begin{DoxyItemize}
\item Elements are added to the end of the list in the order they are inserted
\item If the list doesn\textquotesingle{}t exist, it will be created automatically
\item Both the key and data parameters are required and validated
\item Lists can store various data types (arrays, strings, numbers, or booleans)
\item Useful for maintaining a history of events, logs, or sequential data
\item The operation is executed immediately and synchronously
\item New elements are always added to the end of the list
\item All operations are logged for debugging purposes
\end{DoxyItemize}\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md291}{}\doxysubsection{\texorpdfstring{Related Functions}{Related Functions}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md291}

\begin{DoxyItemize}
\item {\ttfamily dragonfly\+\_\+db\+\_\+fnc\+\_\+list\+Get}\+: Retrieves a specific element from a list
\item {\ttfamily dragonfly\+\_\+db\+\_\+fnc\+\_\+list\+Load}\+: Retrieves a range of elements from a list
\item {\ttfamily dragonfly\+\_\+db\+\_\+fnc\+\_\+list\+Set}\+: Replaces a specific element in a list
\item {\ttfamily dragonfly\+\_\+db\+\_\+fnc\+\_\+list\+Remove}\+: Removes a specific element from a list
\item {\ttfamily dragonfly\+\_\+db\+\_\+fnc\+\_\+scheduler}\+: Processes the callback from the database extension
\end{DoxyItemize}\hypertarget{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md292}{}\doxysubsection{\texorpdfstring{Links}{Links}}\label{md__g_1_2ids_2dragonfly_2docs_2list_2list_add_autotoc_md292}
\doxysectlink{md__g_1_2ids_2dragonfly_2docs_2list_2list_add}{List Add}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md__g_1_2ids_2dragonfly_2docs_2list_2list_get}{List Get}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md__g_1_2ids_2dragonfly_2docs_2list_2list_load}{List Load}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md__g_1_2ids_2dragonfly_2docs_2list_2list_remove}{List Remove}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md__g_1_2ids_2dragonfly_2docs_2list_2list_set}{List Set}{0} 