<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.11"/>
<title>libini_config: Flags used in add_xxx_value functions</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { init_search(); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">libini_config
 <span id="projectnumber">0.5.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#enum-members">Enumerations</a> </div>
<div class="headertitle">
<div class="title">Flags used in add_xxx_value functions</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>These flags control the behavior of the add_xxx_value functions. Use these flags to specify how you want to process the key. Do you want the function to replace an existing key? Or may be you want to generate an error when function sees that there is a duplicate key? Or may be you do not want to check anything and just add the key to the section?</p>
<p>Individual values provide more details about use. </p>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a class="anchor" id="gabc989a2e29215dea6f5143605afcda53"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__insflags.html#gabc989a2e29215dea6f5143605afcda53">INI_VA</a></td>
</tr>
</table>
</div><div class="memdoc">
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53a2a157b262ef6ae48d3b00f0cabd3ba6b"></a>INI_VA_NOCHECK </td><td class="fielddoc">
<p>No check. </p>
<p>This is the default mode. Function will not perform any checks for duplicates and will just add a key. </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53aad2dc64d645fdc7c48b10c71ca205121"></a>INI_VA_MOD </td><td class="fielddoc">
<p>Update a specific value (best effort). </p>
<p>Value of the index is used to determine which one of the duplicates needs to be updated. Index is 0-based. If the index is out of range the function will do best effort and return the last instance of the key. For example if you have five duplicates and you are searching for the tenth the function will find and return the fifth instance. </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53ae9bb42b35daf27929de89a499f2800d0"></a>INI_VA_MOD_E </td><td class="fielddoc">
<p>Update a specific value (with error). </p>
<p>Value of the index is used to determine which one of the duplicates needs to be updated. Index is 0-based. If the value is not found or the index is out of range the function returns ENOENT. For example if you have five duplicates and you are searching for the tenth the error ENOENT will be returned. </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53a3cf72becf2a90deae5a98f88f4e48857"></a>INI_VA_MODADD </td><td class="fielddoc">
<p>Update or add if not found (best effort). </p>
<p>Function will check for duplicates and would overwrite the specified key if found. Value of the index is used to determine which one of the duplicates needs to be updated. Index is 0-based. If the value is not found the new value will be added following other position related arguments. This option performs best effort search. For example if you have five duplicates and you are searching for the tenth the function will find and return fifth instance. </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53a10a4d5dbab19546f9966c2666ae17920"></a>INI_VA_MODADD_E </td><td class="fielddoc">
<p>Update or add if not found (with error). </p>
<p>Function will check for duplicates and would overwrite the specified key if found. Value of the index is used to determine which one of the duplicates needs to be updated. Index is 0-based. If the value is not found the new value will be added following other position related arguments. This option performs an exact search. For example if you have five duplicates and you are searching for tenth the error ENOENT will be returned. </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53a8ce04ba08522192a29335b3d349be92a"></a>INI_VA_CLEAN </td><td class="fielddoc">
<p>Clean all duplicates. </p>
<p>Find all instances of the specific key and remove them first. Then add the new key respecting the position related arguments. </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="ggabc989a2e29215dea6f5143605afcda53acf284536a47191be03f1dae1ccb5433b"></a>INI_VA_DUPERROR </td><td class="fielddoc">
<p>Error if duplicate. </p>
<p>Return error EEXIST if an entry with the same key exists. </p>
</td></tr>
</table>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.11
</small></address>
</body>
</html>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-release
>
by-pkgid
>
f1fdcdb82c21d8820a1f9ab48439717f
>
files
>
35
