\chapter{list\+Load}
\hypertarget{md_docs_2list_2list_load}{}\label{md_docs_2list_2list_load}\index{listLoad@{listLoad}}
\hypertarget{md_docs_2list_2list_load_autotoc_md386}{}\doxysubsection{\texorpdfstring{autotoc\+\_\+md386}{autotoc\+\_\+md386}}\label{md_docs_2list_2list_load_autotoc_md386}
title\+: Arma\+RAMDb -\/ List Load icon\+: mdi\+:file-\/text-\/outline \hypertarget{md_docs_2list_2list_load_autotoc_md387}{}\doxysubsection{\texorpdfstring{excerpt\+: Get all elements of a list stored at a key from RAMDb.}{excerpt\+: Get all elements of a list stored at a key from RAMDb.}}\label{md_docs_2list_2list_load_autotoc_md387}
\hypertarget{md_docs_2list_2list_load_autotoc_md388}{}\doxysection{\texorpdfstring{ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Load}{ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Load}}\label{md_docs_2list_2list_load_autotoc_md388}
\hypertarget{md_docs_2list_2list_load_autotoc_md389}{}\doxysubsection{\texorpdfstring{Description}{Description}}\label{md_docs_2list_2list_load_autotoc_md389}
Retrieves all elements of a list stored at a specified key from the RAMDb database. This function is useful when you need to access the complete list data rather than individual elements, allowing operations on the entire dataset. The retrieved data is passed to a callback function for processing.\hypertarget{md_docs_2list_2list_load_autotoc_md390}{}\doxysubsection{\texorpdfstring{Syntax}{Syntax}}\label{md_docs_2list_2list_load_autotoc_md390}

\begin{DoxyCode}{0}
\DoxyCodeLine{[\_key,\ \_function,\ \_call,\ \_netId]\ call\ ramdb\_db\_fnc\_listLoad}

\end{DoxyCode}
\hypertarget{md_docs_2list_2list_load_autotoc_md391}{}\doxysubsection{\texorpdfstring{Parameters}{Parameters}}\label{md_docs_2list_2list_load_autotoc_md391}
\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
\+\_\+key   &String   &The key identifying the list to be retrieved   &"{}"{}    \\\cline{1-4}
\+\_\+function   &String   &The name of the function that will receive the retrieved data   &"{}"{}    \\\cline{1-4}
\+\_\+call   &Boolean   &Whether to call the function in an unscheduled environment   &false    \\\cline{1-4}
\+\_\+net\+Id   &String   &The Net\+ID of the target to return data from the function (multiplayer only)   &"{}"{}   \\\cline{1-4}
\end{longtabu}
\hypertarget{md_docs_2list_2list_load_autotoc_md392}{}\doxysubsection{\texorpdfstring{Return Value}{Return Value}}\label{md_docs_2list_2list_load_autotoc_md392}
No value is returned directly. The retrieved list data is passed to the specified callback function asynchronously.\hypertarget{md_docs_2list_2list_load_autotoc_md393}{}\doxysubsection{\texorpdfstring{Examples}{Examples}}\label{md_docs_2list_2list_load_autotoc_md393}
{\bfseries{Retrieve all event logs\+:}} 
\begin{DoxyCode}{0}
\DoxyCodeLine{["{}events"{},\ "{}myProject\_fnc\_processEventLogs"{}]\ call\ ramdb\_db\_fnc\_listLoad;}

\end{DoxyCode}


{\bfseries{Retrieve a player list with synchronous callback\+:}} 
\begin{DoxyCode}{0}
\DoxyCodeLine{["{}playerList"{},\ "{}myProject\_fnc\_processPlayerList"{},\ true]\ call\ ramdb\_db\_fnc\_listLoad;}

\end{DoxyCode}


{\bfseries{Send mission data to a specific client\+:}} 
\begin{DoxyCode}{0}
\DoxyCodeLine{["{}missionData"{},\ "{}myProject\_fnc\_processMissionData"{},\ false,\ netId\ player]\ remoteExecCall\ ["{}ramdb\_db\_fnc\_listLoad"{},\ 2,\ false];}

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

\begin{DoxyItemize}
\item This function retrieves the entire list stored at the specified key, making it useful when you need to process multiple elements together.
\item Both the {\ttfamily \+\_\+key} and {\ttfamily \+\_\+function} parameters are required. The function will exit without action if either is empty.
\item The retrieved data is processed asynchronously through the scheduler system and passed to the specified callback function.
\item For multiplayer scenarios, you can specify a target client using the {\ttfamily \+\_\+net\+Id} parameter to send the retrieved data to that specific client.
\item The {\ttfamily \+\_\+call} parameter determines whether the callback function is executed in an unscheduled environment (true) or scheduled environment (false).
\item This function uses the underlying "{}listrng"{} extension with a range from 0 to -\/1, which retrieves all elements in the list.
\item All list operations are logged for debugging purposes.
\end{DoxyItemize}\hypertarget{md_docs_2list_2list_load_autotoc_md395}{}\doxysubsection{\texorpdfstring{Related Functions}{Related Functions}}\label{md_docs_2list_2list_load_autotoc_md395}

\begin{DoxyItemize}
\item {\ttfamily ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Add}\+: Adds an element to a list
\item {\ttfamily ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Get}\+: Retrieves a specific element from a list
\item {\ttfamily ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Set}\+: Replaces a specific element in a list
\item {\ttfamily ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Remove}\+: Removes a specific element from a list
\item {\ttfamily ramdb\+\_\+db\+\_\+fnc\+\_\+list\+Delete}\+: Deletes an entire list
\item {\ttfamily ramdb\+\_\+db\+\_\+fnc\+\_\+scheduler}\+: Processes the callback from the database extension
\end{DoxyItemize}\hypertarget{md_docs_2list_2list_load_autotoc_md396}{}\doxysubsection{\texorpdfstring{Links}{Links}}\label{md_docs_2list_2list_load_autotoc_md396}
\doxysectlink{md_docs_2list_2list_add}{List Add}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md_docs_2list_2list_delete}{List Delete}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md_docs_2list_2list_get}{List Get}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md_docs_2list_2list_load}{List Load}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md_docs_2list_2list_remove}{List Remove}{0} \texorpdfstring{$\vert$}{|} \doxysectlink{md_docs_2list_2list_set}{List Set}{0} 