dragonfly/api/docbook/dir_1d1eabba2c636e67297dc8cee9bc9944.xml
Jacob Schmidt c8d81ba3bb
All checks were successful
Build / Build (push) Successful in 39s
docs: Update README.md with detailed documentation
This commit significantly enhances the `README.md` file, providing comprehensive documentation for the ArmaDragonflyClient.

Key changes:

*   **Detailed Function Categories:** Categorized functions for better organization (Core, Basic Data Operations, Hash Operations, List Operations).
*   **Usage Examples:** Added clear and concise usage examples for basic operations, hash operations (context and ID-specific), and list operations.
*   **Function Documentation Structure:** Outlined the structure for individual function documentation.
*   **License Information:** Updated the license information.
2025-03-30 17:15:35 -05:00

65 lines
3.3 KiB
XML

<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="_dir_1d1eabba2c636e67297dc8cee9bc9944" xml:lang="en-US">
<title>G:/ids/dragonfly/docs/hash Directory Reference</title>
<indexterm><primary>G:/ids/dragonfly/docs/hash Directory Reference</primary></indexterm>
<section>
<title>Detailed Description</title>
<para>This section contains documentation for the hash operations of ArmaDragonflyClient that allow for working with hash tables (key-value pairs within a namespace).</para>
<section xml:id="_README.md_1autotoc_md276">
<title>Available Functions</title>
<para><itemizedlist>
<listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_get">hashGet</link> - Get a field from a hash</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_get_all">hashGetAll</link> - Get all fields from a hash</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_get_all_id">hashGetAllId</link> - Get all fields from a hash for a specific ID</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_get_id">hashGetId</link> - Get a field from a hash for a specific ID</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_set">hashSet</link> - Set a field in a hash</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_set_bulk">hashSetBulk</link> - Set multiple fields in a hash in one operation</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_set_id">hashSetId</link> - Set a field in a hash for a specific ID</para>
</listitem><listitem>
<para><link linkend="_md__g_1_2ids_2dragonfly_2docs_2hash_2hash_set_id_bulk">hashSetIdBulk</link> - Set multiple fields in a hash for a specific ID in one operation</para>
</listitem></itemizedlist>
</para>
</section>
<section xml:id="_README.md_1autotoc_md277">
<title>Example Usage</title>
<para><literallayout><computeroutput>//&#32;Context&#32;mode&#32;examples
[&quot;myField&quot;,&#32;[myValue]]&#32;call&#32;dragonfly_db_fnc_hashSet;
[&quot;myField&quot;,&#32;&quot;myFunction&quot;]&#32;call&#32;dragonfly_db_fnc_hashGet;
[&quot;myFunction&quot;]&#32;call&#32;dragonfly_db_fnc_hashGetAll;
//&#32;Set&#32;multiple&#32;hash&#32;fields&#32;in&#32;one&#32;operation
[[
&#32;&#32;&#32;&#32;&quot;loadout&quot;,&#32;[getUnitLoadout&#32;player],
&#32;&#32;&#32;&#32;&quot;position&quot;,&#32;[getPosASL&#32;player],
&#32;&#32;&#32;&#32;&quot;direction&quot;,&#32;[getDir&#32;player]
]]&#32;call&#32;dragonfly_db_fnc_hashSetBulk;
//&#32;ID-specific&#32;examples
[&quot;myHash&quot;,&#32;&quot;myField&quot;,&#32;[myValue]]&#32;call&#32;dragonfly_db_fnc_hashSetId;
[&quot;myHash&quot;,&#32;&quot;myField&quot;,&#32;&quot;myFunction&quot;]&#32;call&#32;dragonfly_db_fnc_hashGetId;
[&quot;myHash&quot;]&#32;call&#32;dragonfly_db_fnc_hashGetAllId;
</computeroutput></literallayout></para>
</section>
<section xml:id="_README.md_1autotoc_md278">
<title>Related Categories</title>
<para><itemizedlist>
<listitem>
<para>Core Functions</para>
</listitem><listitem>
<para>Basic Data Operations</para>
</listitem><listitem>
<para>List Operations </para>
</listitem></itemizedlist>
</para>
</section>
</section>
</section>