Contrats intelligents </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/topics/script.html#contract-structure" class="sidebar-link">Structure du contrat </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/topics/script.html#data-section" class="sidebar-link">Section des données </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#conditions-section" class="sidebar-link">Section des conditions </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#action-section" class="sidebar-link">Section d'action </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#variables" class="sidebar-link">Variables </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#nested-contracts" class="sidebar-link">Contrats imbriqués </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#file-upload" class="sidebar-link">Téléchargement de fichier </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#queries-in-json-format" class="sidebar-link">Requêtes au format JSON </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#queries-with-date-and-time-operations" class="sidebar-link">Requêtes avec des opérations de date et d'heure </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#needle-contract-language" class="sidebar-link">Langage du contrat NEEDLE </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/topics/script.html#basic-elements-and-structure" class="sidebar-link">Éléments de base et structure </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#data-types-and-variables" class="sidebar-link">Types de données et variables </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#array" class="sidebar-link">Tableau </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#if-and-while-statements" class="sidebar-link">If et While déclarations </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#functions" class="sidebar-link">Fonctions </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#needle-functions-classification" class="sidebar-link">Classification des fonctions Needle </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#needle-functions-reference" class="sidebar-link">Référence des fonctions Needle </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/topics/script.html#appparam" class="sidebar-link">AppParam </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbfind" class="sidebar-link">DBFind </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbrow" class="sidebar-link">DBRow </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbselectmetrics" class="sidebar-link">DBSelectMetrics </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#ecosysparam" class="sidebar-link">EcosysParam </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#gethistory" class="sidebar-link">GetHistory </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#gethistoryrow" class="sidebar-link">GetHistoryRow </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getcolumntype" class="sidebar-link">GetColumnType </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getdatafromxlsx" class="sidebar-link">GetDataFromXLSX </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getrowscountxlsx" class="sidebar-link">GetRowsCountXLSX </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#langres" class="sidebar-link">LangRes </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getblock" class="sidebar-link">GetBlock </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbinsert" class="sidebar-link">DBInsert </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbupdate" class="sidebar-link">DBUpdate </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbupdateext" class="sidebar-link">DBUpdateExt </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#delcolumn" class="sidebar-link">DelColumn </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#deltable" class="sidebar-link">DelTable </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#append" class="sidebar-link">Append </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#join" class="sidebar-link">Join </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#split" class="sidebar-link">Split </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#len" class="sidebar-link">Len </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#row" class="sidebar-link">Row </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#one" class="sidebar-link">One </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getmapkeys" class="sidebar-link">GetMapKeys </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#sortedkeys" class="sidebar-link">SortedKeys </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#callcontract" class="sidebar-link">CallContract </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#contractaccess" class="sidebar-link">ContractAccess </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#contractconditions" class="sidebar-link">ContractConditions </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#evalcondition" class="sidebar-link">EvalCondition </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getcontractbyid" class="sidebar-link">GetContractById </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getcontractbyname" class="sidebar-link">GetContractByName </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#roleaccess" class="sidebar-link">RoleAccess </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#transactioninfo" class="sidebar-link">TransactionInfo </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#throw" class="sidebar-link">Throw </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#validatecondition" class="sidebar-link">ValidateCondition </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#addresstoid" class="sidebar-link">AddressToId </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#idtoaddress" class="sidebar-link">IdToAddress </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#pubtoid" class="sidebar-link">PubToID </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#decodebase64" class="sidebar-link">DecodeBase64 </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#encodebase64" class="sidebar-link">EncodeBase64 </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#float" class="sidebar-link">Float </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#hextobytes" class="sidebar-link">HexToBytes </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#formatmoney" class="sidebar-link">FormatMoney </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#random" class="sidebar-link">Random </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#int" class="sidebar-link">Int </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#hash" class="sidebar-link">Hash </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#sha256" class="sidebar-link">Sha256 </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#str" class="sidebar-link">Str </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#jsonencode" class="sidebar-link">JSONEncode </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#jsonencodeindent" class="sidebar-link">JSONEncodeIndent </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#jsondecode" class="sidebar-link">JSONDecode </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#hasprefix" class="sidebar-link">HasPrefix </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#contains" class="sidebar-link">Contains </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#replace" class="sidebar-link">Remplacer </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#size" class="sidebar-link">Size </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#sprintf" class="sidebar-link">Sprintf </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#substr" class="sidebar-link">Substr </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#tolower" class="sidebar-link">ToLower </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#toupper" class="sidebar-link">ToUpper </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#trimspace" class="sidebar-link">TrimSpace </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#floor" class="sidebar-link">Floor </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#log" class="sidebar-link">Log </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#log10" class="sidebar-link">Log10 </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#pow" class="sidebar-link">Pow </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#round" class="sidebar-link">Round </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#sqrt" class="sidebar-link">Sqrt </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#stringtobytes" class="sidebar-link">StringToBytes </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#bytestostring" class="sidebar-link">BytesToString </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#sysparamstring" class="sidebar-link">SysParamString </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#sysparamint" class="sidebar-link">SysParamInt </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#dbupdatesysparam" class="sidebar-link">DBUpdateSysParam </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#updatenotifications" class="sidebar-link">UpdateNotifications </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#updaterolesnotifications" class="sidebar-link">UpdateRolesNotifications </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#httprequest" class="sidebar-link">HTTPRequest </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#httppostjson" class="sidebar-link">HTTPPostJSON </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#blocktime" class="sidebar-link">BlockTime </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#datetime" class="sidebar-link">DateTime </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#unixdatetime" class="sidebar-link">UnixDateTime </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#createobs" class="sidebar-link">CreateOBS </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#getobslist" class="sidebar-link">GetOBSList </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#runobs" class="sidebar-link">RunOBS </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#stopobs" class="sidebar-link">StopOBS </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#removeobs" class="sidebar-link">RemoveOBS </a></li></ul></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#system-contracts" class="sidebar-link">System Contracts </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newecosystem" class="sidebar-link">NewEcosystem </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editecosystemname" class="sidebar-link">EditEcosystemName </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newcontract" class="sidebar-link">NewContract </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editcontract" class="sidebar-link">EditContract </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#bindwallet" class="sidebar-link">BindWallet </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#unbindwallet" class="sidebar-link">UnbindWallet </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newparameter" class="sidebar-link">NewParameter </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editparameter" class="sidebar-link">EditParameter </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newmenu" class="sidebar-link">NewMenu </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editmenu" class="sidebar-link">EditMenu </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#appendmenu" class="sidebar-link">AppendMenu </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newpage" class="sidebar-link">NewPage </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editpage" class="sidebar-link">EditPage </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#appendpage" class="sidebar-link">AppendPage </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newblock" class="sidebar-link">NewBlock </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editblock" class="sidebar-link">EditBlock </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newtable" class="sidebar-link">NewTable </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#edittable" class="sidebar-link">EditTable </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newcolumn" class="sidebar-link">NewColumn </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editcolumn" class="sidebar-link">EditColumn </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newlang" class="sidebar-link">NewLang </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editlang" class="sidebar-link">EditLang </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#import" class="sidebar-link">Import </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#importupload" class="sidebar-link">ImportUpload </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newappparam" class="sidebar-link">NewAppParam </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editappparam" class="sidebar-link">EditAppParam </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#newdelayedcontract" class="sidebar-link">NewDelayedContract </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#editdelayedcontract" class="sidebar-link">EditDelayedContract </a></li><li class="sidebar-sub-header"><a href="/fr/topics/script.html#uploadbinary" class="sidebar-link">UploadBinary </a></li></ul></li></ul></li><li><a href="/fr/topics/templates2.html" class="sidebar-link">Langage de modèle </a></li><li><a href="/fr/topics/vm.html" class="sidebar-link">Compilateur et Machine Virtuelle </a></li><li><a href="/fr/topics/daemons.html" class="sidebar-link">Démon </a></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="smart-contracts"><a href="#smart-contracts" class="header-anchor">#</a> Contrats intelligents </h1> <ul><li><a href="#contract-structure">Structure du contrat</a> <ul><li><a href="#data-section">Section des données</a></li> <li><a href="#conditions-section">Section des conditions</a></li> <li><a href="#action-section">Section des actions</a></li></ul></li> <li><a href="#variables">Variables</a></li> <li><a href="#nested-contracts">Contrats imbriqués</a></li> <li><a href="#file-upload">Téléchargement de fichiers</a></li> <li><a href="#queries-in-json-format">Requêtes au format JSON</a></li> <li><a href="#queries-with-date-and-time-operations">Requêtes avec des opérations de date et d'heure</a></li> <li><a href="#needle-contract-language">Langage du contrat NEEDLE</a> <ul><li><a href="#basic-elements-and-structure">Éléments de base et structure</a></li> <li><a href="#data-types-and-variables">Types de données et variables</a></li> <li><a href="#array">Tableau</a></li> <li><a href="#if-and-while-statements">Instructions If et While</a></li></ul></li> <li><a href="#functions">Fonctions</a> <ul><li><a href="#function-declaration">Déclaration de fonction</a></li> <li><a href="#variable-length-parameters">Paramètres de longueur variable</a></li> <li><a href="#optional-parameters">Paramètres facultatifs</a></li></ul></li> <li><a href="#needle-functions-classification">Classification des fonctions Needle</a></li> <li><a href="#needle-functions-reference">Référence des fonctions Needle</a> <ul><li><a href="#appparam">AppParam</a></li> <li><a href="#dbfind">DBFind</a></li> <li><a href="#dbrow">DBRow</a></li> <li><a href="#dbselectmetrics">DBSelectMetrics</a></li> <li><a href="#ecosysparam">EcosysParam</a></li> <li><a href="#gethistory">GetHistory</a></li> <li><a href="#gethistoryrow">GetHistoryRow</a></li> <li><a href="#getcolumntype">GetColumnType</a></li> <li><a href="#getdatafromxlsx">GetDataFromXLSX</a></li> <li><a href="#getrowscountxlsx">GetRowsCountXLSX</a></li> <li><a href="#langres">LangRes</a></li> <li><a href="#getblock">GetBlock</a></li> <li><a href="#dbinsert">DBInsert</a></li> <li><a href="#dbupdate">DBUpdate</a></li> <li><a href="#dbupdateext">DBUpdateExt</a></li> <li><a href="#delcolumn">DelColumn</a></li> <li><a href="#deltable">DelTable</a></li> <li><a href="#append">Append</a></li> <li><a href="#join">Join</a></li> <li><a href="#split">Split</a></li> <li><a href="#len">Len</a></li> <li><a href="#row">Row</a></li> <li><a href="#one">One</a></li> <li><a href="#getmapkeys">GetMapKeys</a></li> <li><a href="#sortedkeys">SortedKeys</a></li> <li><a href="#callcontract">CallContract</a></li> <li><a href="#contractaccess">ContractAccess</a></li> <li><a href="#contractconditions">ContractConditions</a></li> <li><a href="#evalcondition">EvalCondition</a></li> <li><a href="#getcontractbyid">GetContractById</a></li> <li><a href="#getcontractbyname">GetContractByName</a></li> <li><a href="#roleaccess">RoleAccess</a></li> <li><a href="#transactioninfo">TransactionInfo</a></li> <li><a href="#throw">Throw</a></li> <li><a href="#validatecondition">ValidateCondition</a></li> <li><a href="#addresstoid">AddressToId</a></li> <li><a href="#idtoaddress">IdToAddress</a></li> <li><a href="#pubtoid">PubToID</a></li> <li><a href="#decodebase64">DecodeBase64</a></li> <li><a href="#encodebase64">EncodeBase64</a></li> <li><a href="#float">Float</a></li> <li><a href="#hextobytes">HexToBytes</a></li> <li><a href="#formatmoney">FormatMoney</a></li> <li><a href="#random">Random</a></li> <li><a href="#int">Int</a></li> <li><a href="#hash">Hash</a></li> <li><a href="#sha256">Sha256</a></li> <li><a href="#str">Str</a></li> <li><a href="#jsonencode">JSONEncode</a></li> <li><a href="#jsonencodeindent">JSONEncodeIndent</a></li> <li><a href="#jsondecode">JSONDecode</a></li> <li><a href="#hasprefix">HasPrefix</a></li> <li><a href="#contains">Contains</a></li> <li><a href="#replace">Replace</a></li> <li><a href="#size">Size</a></li> <li><a href="#sprintf">Sprintf</a></li> <li><a href="#substr">Substr</a></li> <li><a href="#tolower">ToLower</a></li> <li><a href="#toupper">ToUpper</a></li> <li><a href="#trimspace">TrimSpace</a></li> <li><a href="#floor">Floor</a></li> <li><a href="#log">Log</a></li> <li><a href="#log10">Log10</a></li> <li><a href="#pow">Pow</a></li> <li><a href="#round">Round</a></li> <li><a href="#sqrt">Sqrt</a></li> <li><a href="#stringtobytes">StringToBytes</a></li> <li><a href="#bytestostring">BytesToString</a></li> <li><a href="#sysparamstring">SysParamString</a></li> <li><a href="#sysparamint">SysParamInt</a></li> <li><a href="#dbupdatesysparam">DBUpdateSysParam</a></li> <li><a href="#updatenotifications">UpdateNotifications</a></li> <li><a href="#updaterolesnotifications">UpdateRolesNotifications</a></li> <li><a href="#httprequest">HTTPRequest</a></li> <li><a href="#httppostjson">HTTPPostJSON</a></li> <li><a href="#blocktime">BlockTime</a></li> <li><a href="#datetime">DateTime</a></li> <li><a href="#unixdatetime">UnixDateTime</a></li> <li><a href="#createobs">CreateOBS</a></li> <li><a href="#getobslist">GetOBSList</a></li> <li><a href="#runobs">RunOBS</a></li> <li><a href="#stopobs">StopOBS</a></li> <li><a href="#removeobs">RemoveOBS</a></li></ul></li> <li><a href="#system-contracts">Contrats intelligents du système</a> <ul><li><a href="#newecosystem">NewEcosystem</a></li> <li><a href="#editecosystemname">EditEcosystemName</a></li> <li><a href="#newcontract">NewContract</a></li> <li><a href="#editcontract">EditContract</a></li> <li><a href="#bindwallet">BindWallet</a></li> <li><a href="#unbindwallet">UnbindWallet</a></li> <li><a href="#newparameter">NewParameter</a></li> <li><a href="#editparameter">EditParameter</a></li> <li><a href="#newmenu">NewMenu</a></li> <li><a href="#editmenu">EditMenu</a></li> <li><a href="#appendmenu">AppendMenu</a></li> <li><a href="#newpage">NewPage</a></li> <li><a href="#editpage">EditPage</a></li> <li><a href="#appendpage">AppendPage</a></li> <li><a href="#newblock">NewBlock</a></li> <li><a href="#editblock">EditBlock</a></li> <li><a href="#newtable">NewTable</a></li> <li><a href="#edittable">EditTable</a></li> <li><a href="#newcolumn">NewColumn</a></li> <li><a href="#editcolumn">EditColumn</a></li> <li><a href="#newlang">NewLang</a></li> <li><a href="#editlang">EditLang</a></li> <li><a href="#import">Import</a></li> <li><a href="#importupload">ImportUpload</a></li> <li><a href="#newappparam">NewAppParam</a></li> <li><a href="#editappparam">EditAppParam</a></li> <li><a href="#newdelayedcontract">NewDelayedContract</a></li> <li><a href="#editdelayedcontract">EditDelayedContract</a></li> <li><a href="#uploadbinary">UploadBinary</a></li></ul></li></ul> <p>Le contrat intelligent (ci-après dénommé le contrat) est l'un des éléments de base d'une application. L'implémentation d'un contrat sur une page par l'utilisateur est généralement une opération unique dont le but est de mettre à jour ou de créer une entrée dans une base de données. Toutes les opérations de données d'une application forment un système de contrats, et ces contrats interagissent les uns avec les autres grâce aux fonctions de contenu de la base de données ou du contrat.</p> <h2 id="contract-structure"><a href="#contract-structure" class="header-anchor">#</a> Structure du contrat </h2> <p>Utilisez le mot-clé <code>contract</code> pour déclarer un contrat, suivi du nom du contrat, et le contenu du contrat doit être enclos entre des accolades. Un contrat se compose principalement de trois sections :</p> <ol><li><p><strong>data</strong> - <a href="#data-section">section des données</a>, où sont déclarées les variables des données d'entrée, y compris le nom de la variable et le type de la variable ;</p></li> <li><p><strong>conditions</strong> - <a href="#conditions-section">section des conditions</a>, où l'on vérifie la justesse des données ;</p></li> <li><p><strong>action</strong> - <a href="#action-section">section des actions</a>, où l'on définit les manipulations des données.</p></li></ol> <div class="language- extra-class"><pre class="language-text"><code>contract MyContract { data { FromId int ToId int Amount money } func conditions { ... } func action { ... } } </code></pre></div><h3 id="data-section"><a href="#data-section" class="header-anchor">#</a> Section des données </h3> <p>La section <code>data</code> décrit les entrées de données du contrat et les paramètres de formulaire reçus.</p> <p>La structure de chaque ligne par séquence :</p> <ul><li>Nom de la variable - ne reçoit que des variables, pas des tableaux ;</li> <li>Type de données de la variable - le <a href="#data-types-and-variables">type de données</a> de la variable ;</li> <li>optionnel - un paramètre facultatif qui n'a pas besoin d'être rempli dans l'élément de formulaire.</li></ul> <div class="language- extra-class"><pre class="language-text"><code>contract my { data { Name string RequestId int Photo file "optional" Amount money Private bytes } ... } </code></pre></div><h3 id="conditions-section"><a href="#conditions-section" class="header-anchor">#</a> Section des conditions </h3> <p>La section "conditions" décrit la validation des données reçues.</p> <p>Les commandes suivantes sont utilisées pour les avertissements d'erreur : erreurs graves <code>error</code>, erreurs avertissement <code>warning</code>, erreurs suggestives <code>info</code>. Ces trois commandes généreront une erreur qui mettra fin à l'exécution des contrats, et chaque erreur affichera un type différent d'informations de journal d'erreur. Par exemple :</p> <div class="language- extra-class"><pre class="language-text"><code>if fuel == 0 { error "fuel cannot be zero!" } if money < limit { warning Sprintf("You don't have enough money: %v <%v", money, limit) } if idexist > 0 { info "You have already been registered" } </code></pre></div><h3 id="action-section"><a href="#action-section" class="header-anchor">#</a> Section d'action </h3> <p>La section "action" décrit le code principal du contrat, qui récupère d'autres données et enregistre les valeurs de résultat dans des tables. Par exemple:</p> <div class="language- extra-class"><pre class="language-text"><code>action { DBUpdate("keys", $key_id, {"-amount": $amount}) DBUpdate("keys", $recipient, {"+amount": $amount, "pub": $Pub}) } </code></pre></div><h2 id="variables"><a href="#variables" class="header-anchor">#</a> Variables </h2> <p>Les variables déclarées dans la section des données sont transmises aux autres sections du contrat via le symbole <code>$</code> suivi du nom de la variable. Le symbole <code>$</code> peut également être utilisé pour déclarer d'autres variables qui ne se trouvent pas dans la section des données, et qui sont considérées comme des variables globales de ce contrat et de tous les contrats dans lesquels ce contrat est imbriqué.</p> <p>Des variables prédéfinies peuvent être utilisées dans les contrats, elles contiennent les données de transaction qui ont appelé le contrat :</p> <ul><li><code>$time</code> - horodatage de la transaction;</li> <li><code>$ecosystem_id</code> - ID de l'écosystème;</li> <li><code>$block</code> - ID du bloc contenant la transaction;</li> <li><code>$key_id</code> - adresse du compte ayant signé la transaction actuelle;</li> <li><code>$type</code> - ID du contrat dans la machine virtuelle;</li> <li><code>$block_key_id</code> - adresse du compte du nœud ayant généré le bloc;</li> <li><code>$block_time</code> - horodatage de génération du bloc;</li> <li><code>$original_contract</code> - nom du contrat qui a initialement traité la transaction. Cela signifie que le contrat est appelé lors de la validation de la transaction si la variable est une chaîne vide. Pour vérifier si le contrat est appelé par un autre contrat ou directement par la transaction, vous devez comparer les valeurs de $original_contract et $this_contract. Cela signifie que le contrat est appelé par la transaction s'ils sont égaux;</li> <li><code>$this_contract</code> - nom du contrat actuellement en cours d'exécution;</li> <li><code>$guest_key</code> - adresse du compte invité;</li> <li><code>$stack</code> - pile de tableaux de contrats avec un type de données de tableau, contenant tous les contrats exécutés. Le premier élément du tableau représente le nom du contrat actuellement en cours d'exécution, tandis que le dernier élément représente le nom du contrat qui a initialement traité la transaction;</li> <li><code>$node_position</code> - le numéro d'index du tableau de nœuds de vérification où se trouve le bloc;</li> <li><code>$txhash</code> - hachage de la transaction;</li> <li><code>$contract</code> - tableau de structure de contrat actuel.</li></ul> <p>Les variables prédéfinies peuvent être utilisées non seulement dans les contrats, mais aussi dans les champs de permission qui définissent les conditions d'accès des éléments de l'application. Lorsqu'elles sont utilisées dans les champs de permission, les variables prédéfinies pour les informations de bloc sont toujours égales à zéro, telles que <code>$time</code>, <code>$block</code>, etc.</p> <p>Une variable prédéfinie <code>$result</code> est assignée avec le résultat de retour du contrat.</p> <div class="language- extra-class"><pre class="language-text"><code>contract my { data { Name string Amount money } func conditions { if $Amount <= 0 { error "Amount cannot be 0" } $ownerId = 1232 } func action { var amount money amount = $Amount - 10 DBUpdate("mytable", $ownerId, {name: $Name,amount: amount}) DBUpdate("mytable2", $ownerId, {amount: 10}) } } </code></pre></div><h2 id="nested-contracts"><a href="#nested-contracts" class="header-anchor">#</a> Contrats imbriqués </h2> <p>Vous pouvez imbriquer des contrats dans les sections des conditions et des actions du contrat. Les contrats imbriqués peuvent être appelés directement, et les paramètres du contrat sont spécifiés entre parenthèses après le nom du contrat, par exemple, <code>@1NomContrat(Paramètres)</code>. Vous pouvez également appeler des contrats imbriqués avec la fonction <a href="#callcontract">CallContract</a>.</p> <h2 id="file-upload"><a href="#file-upload" class="header-anchor">#</a> Téléchargement de fichier </h2> <p>Pour télécharger un fichier en utilisant un formulaire au format <code>multipart/form-data</code>, le type de données du contrat doit être <code>file</code>.</p> <div class="language- extra-class"><pre class="language-text"><code>contract Upload { data { File file } ... } </code></pre></div><p>Le contrat <a href="#uploadbinary">UploadBinary</a> est utilisé pour télécharger et stocker des fichiers. Avec la fonction <a href="/fr/topics/templates2.html#binary">Binary</a> du langage Logicor dans l'éditeur de page, vous pouvez obtenir le lien de téléchargement du fichier.</p> <h2 id="queries-in-json-format"><a href="#queries-in-json-format" class="header-anchor">#</a> Requêtes au format JSON </h2> <p>Dans le langage du contrat, <strong>JSON</strong> peut être spécifié comme type de champ. Vous pouvez utiliser la syntaxe : <strong>columnname->fieldname</strong> pour traiter le champ d'entrée. La valeur obtenue est enregistrée dans <strong>columnname.fieldname</strong>. La syntaxe ci-dessus peut être utilisée dans les colonnes, les conditions et les clauses "Where" de la fonction <a href="#dbfind">DBFind</a>.</p> <div class="language- extra-class"><pre class="language-text"><code>var ret map var val str var list array ret = DBFind("mytable").Columns("myname,doc,doc->ind").WhereId($Id).Row() val = ret["doc.ind"] val = DBFind("mytable").Columns("myname,doc->type").WhereId($Id).One("doc->type") list = DBFind("mytable").Columns("myname,doc,doc->ind").Where("doc->ind = ?", "101") val = DBFind("mytable").WhereId($Id).One("doc->check") </code></pre></div><h2 id="queries-with-date-and-time-operations"><a href="#queries-with-date-and-time-operations" class="header-anchor">#</a> Requêtes avec des opérations de date et d'heure </h2> <p>Vous ne pouvez pas interroger directement et mettre à jour la date et l'heure avec les fonctions du langage de contrat, mais vous pouvez utiliser les fonctions et fonctionnalités de PostgreSQL dans la clause Where comme dans l'exemple ci-dessous. Par exemple, vous devez comparer le champ date_column avec l'heure actuelle. Si date_column est de type timestamp, l'expression devrait être <code>date_column < NOW()</code>; si date_column est de type Unix, l'expression devrait être <code>to_timestamp(date_column) > NOW()</code>.</p> <div class="language- extra-class"><pre class="language-text"><code>Where("to_timestamp(date_column)> NOW()") Where("date_column <NOW() - 30 * interval '1 day'") </code></pre></div><p>La fonction Needle suivante est utilisée pour traiter la date et l'heure au format SQL :</p> <ul><li><a href="#blocktime">BlockTime</a></li> <li><a href="#datetime">DateTime</a></li> <li><a href="#unixdatetime">UnixDateTime</a></li></ul> <h2 id="needle-contract-language"><a href="#needle-contract-language" class="header-anchor">#</a> Langage du contrat NEEDLE </h2> <p>Le langage du contrat comprend un ensemble de fonctions, d'opérateurs et de structures, qui permettent de réaliser le traitement algorithmique des données et les opérations de base de données.</p> <p>Le contenu du contrat peut être modifié si l'autorisation de modification du contrat n'est pas définie sur "fausse". L'historique complet des modifications du contrat est stocké dans la blockchain, ce qui est disponible dans Weaver.</p> <p>Les opérations de données dans la blockchain sont exécutées conformément à la dernière version du contrat.</p> <h3 id="basic-elements-and-structure"><a href="#basic-elements-and-structure" class="header-anchor">#</a> Éléments de base et structure </h3> <h3 id="data-types-and-variables"><a href="#data-types-and-variables" class="header-anchor">#</a> Types de données et variables </h3> <p>Le type de données doit être défini pour chaque variable. Normalement, les types de données sont convertis automatiquement. Les types de données suivants peuvent être utilisés :</p> <ul><li><code>bool</code> - Booléen, <code>true</code> ou <code>false</code>;</li> <li><code>bytes</code> - un format de byte;</li> <li><code>Int</code> - un entier sur 64 bits;</li> <li><code>Array</code> - un tableau de n'importe quel type;</li> <li><code>map</code> - un tableau d'objets;</li> <li><code>money</code> - un grand entier;</li> <li><code>float</code> - un nombre à virgule flottante sur 64 bits;</li> <li><code>string</code> - une chaîne de caractères doit être définie avec des guillemets doubles ou un format d'échappement : "Ceci est une chaîne de caractères" ou `Ceci est une chaîne de caractères`;</li> <li><code>file</code> - un tableau d'objets : <ul><li><code>Name</code> - nom du fichier, de type <code>string</code>;</li> <li><code>MimeType</code> - type MIME du fichier, de type <code>string</code>;</li> <li><code>Body</code> - contenu du fichier, de type <code>bytes</code>.</li></ul></li></ul> <p>Tous les identifiants, y compris les noms de variables, de fonctions et de contrats, sont sensibles à la casse (MyFunc et myFunc sont des noms différents).</p> <p>Utilisez le mot-clé <strong>var</strong> pour déclarer une variable, suivi du nom et du type de la variable. Les variables déclarées entre accolades doivent être utilisées dans la même paire d'accolades.</p> <p>La valeur par défaut de toute variable déclarée est zéro : la valeur zéro du type booléen est false, la valeur zéro de tous les types numériques est 0, et la valeur zéro pour les chaînes de caractères est une chaîne vide. Un exemple de déclaration de variable :</p> <div class="language- extra-class"><pre class="language-text"><code>func myfunc( val int) int { var mystr1 mystr2 string, mypar int var checked bool ... if checked { var temp int ... } } </code></pre></div><h3 id="array"><a href="#array" class="header-anchor">#</a> Tableau </h3> <p>Le langage du contrat prend en charge deux types de tableaux :</p> <ul><li><code>Array</code> - un tableau dont l'index commence à 0 ;</li> <li><code>map</code> - un tableau d'objets.</li></ul> <p>Lors de l'allocation et de la récupération des éléments d'un tableau, l'indice doit être placé entre crochets. Les index multiples ne sont pas pris en charge dans le tableau, et les éléments du tableau ne peuvent pas être traités comme myarr[i][j].</p> <div class="language- extra-class"><pre class="language-text"><code>var myarr array var mymap map var s string myarr[0] = 100 myarr[1] = "This is a line" mymap["value"] = 777 mymap["param"] = "Parameter" s = Sprintf("%v, %v, %v", myarr[0] + mymap["value"], myarr[1], mymap["param"]) // s = 877, This is a line, Parameter </code></pre></div><p>Vous pouvez également définir des tableaux de type tableau en spécifiant les éléments entre <code>[]</code>. Pour les tableaux de type map, veuillez utiliser <code>{}</code>.</p> <div class="language- extra-class"><pre class="language-text"><code>var my map my={"key1": "value1", key2: i, "key3": $Name} var mya array mya=["value1", {key2: i}, $Name] </code></pre></div><p>Vous pouvez utiliser cette initialisation dans les expressions. Par exemple, utilisez-la dans les paramètres de fonction.</p> <div class="language- extra-class"><pre class="language-text"><code>DBFind...Where({id: 1}) </code></pre></div><p>Pour un tableau d'objets, vous devez spécifier une clé. Les clés sont spécifiées en tant que chaînes de caractères entre guillemets doubles (<code>""</code>). Si le nom de la clé est limité aux lettres, aux chiffres et aux underscores, vous pouvez omettre les guillemets doubles.</p> <div class="language- extra-class"><pre class="language-text"><code>{key1: "value1", key2: "value2"} </code></pre></div><p>Un tableau peut contenir des chaînes de caractères, des nombres, des noms de variables de n'importe quel type, et des noms de variables avec le symbole <code>$</code>. Il prend en charge les tableaux imbriqués. Vous pouvez spécifier différentes cartes ou tableaux en tant que valeurs.</p> <p>Les expressions ne peuvent pas être utilisées comme éléments de tableau. Utilisez une variable pour stocker le résultat de l'expression et spécifiez cette variable en tant qu'élément de tableau.</p> <div class="language- extra-class"><pre class="language-text"><code>[1+2, myfunc(), name["param"]] // don't do this [1, 3.4, mystr, "string", $ext, myarr, mymap, {"ids": [1,2, i], company: {"Name": "MyCompany"}} ] // this is ok var val string val = my["param"] MyFunc({key: val, sub: {name: "My name", "color": "Red"}}) </code></pre></div><h3 id="if-and-while-statements"><a href="#if-and-while-statements" class="header-anchor">#</a> If et While déclarations </h3> <p>Le langage du contrat prend en charge les déclarations conditionnelles standard <strong>if</strong> et les boucles <strong>while</strong>, qui peuvent être utilisées dans les contrats et les fonctions. Ces déclarations peuvent être imbriquées les unes dans les autres.</p> <p>Les déclarations <strong>if</strong> et <strong>while</strong> doivent être suivies d'une déclaration conditionnelle. Si la déclaration conditionnelle renvoie un nombre, elle est considérée comme fausse lorsque sa valeur est 0.</p> <p>val == 0 est équivalent à !val, val != 0 est équivalent à val. L'instruction <strong>if</strong> peut avoir un bloc de code <strong>else</strong>, et le <strong>else</strong> est exécuté lorsque la déclaration conditionnelle <strong>if</strong> est fausse.</p> <p>Les opérateurs de comparaison suivants peuvent être utilisés dans les déclarations conditionnelles : <code><, >, >=, <=, ==, !=, ||, &&</code></p> <div class="language- extra-class"><pre class="language-text"><code>if val> 10 || id != $block_key_id { ... } else { ... } </code></pre></div><p>Le bloc de code est exécuté lorsque la condition de l'instruction <strong>while</strong> est vraie. <strong>break</strong> signifie terminer la boucle du bloc de code. Si vous souhaitez recommencer une boucle depuis le début, utilisez <strong>continue</strong>.</p> <div class="language- extra-class"><pre class="language-text"><code>var i int while true { if i > 100 { break } ... if i == 50 { continue } ... i = i + 1 } </code></pre></div><p>En plus des instructions conditionnelles, Needle prend également en charge les opérations arithmétiques standard : <code>+</code>, <code>-</code>, <code>*</code>, <code>/</code>.</p> <p>Les variables de type chaîne de caractères et octets peuvent être utilisées comme condition. Si la longueur du type est supérieure à zéro, la condition est vraie, sinon elle est fausse.</p> <h3 id="functions"><a href="#functions" class="header-anchor">#</a> Fonctions </h3> <p>Les fonctions peuvent effectuer des opérations sur les données reçues par la <a href="#data-section">section de données</a> d'un contrat : lire et écrire des données dans la base de données, convertir le type de valeur et établir l'interaction entre les contrats.</p> <h4 id="function-declaration"><a href="#function-declaration" class="header-anchor">#</a> Déclaration de fonction </h4> <p>Utilisez le mot-clé <code>func</code> pour déclarer une fonction, suivi du nom et de la liste des paramètres qui lui sont passés ainsi que de leurs types. Tous les paramètres sont enclos entre parenthèses et séparés par des virgules. Après les parenthèses, le type de données de la valeur renvoyée par la fonction doit être déclaré. Le corps de la fonction doit être enclos entre accolades. Si la fonction n'a pas de paramètres, les accolades peuvent être omises. Pour renvoyer une valeur à partir d'une fonction, utilisez le mot-clé <code>return</code>.</p> <div class="language- extra-class"><pre class="language-text"><code>func myfunc(left int, right int) int { return left*right + left - right } func test int { return myfunc(10, 30) + myfunc(20, 50) } func ooops { error "Ooops..." } </code></pre></div><p>La fonction ne renvoie pas d'erreurs, car toutes les vérifications d'erreur sont effectuées automatiquement. Si une erreur se produit dans n'importe quelle fonction, le contrat mettra fin à son fonctionnement et affichera la description de l'erreur dans une fenêtre.</p> <h4 id="variable-length-parameters"><a href="#variable-length-parameters" class="header-anchor">#</a> Paramètres de longueur variable </h4> <p>Les fonctions peuvent définir des paramètres de longueur variable, utilisez le symbole <code>...</code> comme dernier type de paramètre de la fonction pour indiquer des paramètres de longueur variable, avec un type de données <code>array</code>. Les paramètres de longueur variable incluent toutes les variables à partir du moment où le paramètre est passé dans l'appel. Tous les types de variables peuvent être passés, mais vous devez gérer les conflits de types de données incompatibles.</p> <div class="language- extra-class"><pre class="language-text"><code>func sum(out string, values ...) { var i, res int while i <Len(values) { res = res + values[i] i = i + 1 } Println(out, res) } func main() { sum("Sum:", 10, 20, 30, 40) } </code></pre></div><h4 id="optional-parameters"><a href="#optional-parameters" class="header-anchor">#</a> Paramètres optionnels </h4> <p>Une fonction a de nombreux paramètres, mais nous n'avons besoin que de certains d'entre eux lors de son appel. Dans ce cas, vous pouvez déclarer des paramètres optionnels de la manière suivante : <code>func myfunc(name string).Param1(param string).Param2(param2 int) {...}</code>, puis vous pouvez appeler les paramètres spécifiés dans n'importe quel ordre : <code>myfunc("nom").Param2(100)</code>.</p> <p>Dans le corps de la fonction, vous pouvez manipuler ces variables normalement. Si aucun paramètre optionnel spécifié n'est appelé, leurs valeurs par défaut sont zéro. Vous pouvez également utiliser ... pour spécifier un paramètre de longueur variable : <code>func DBFind(table string).Where(request string, params ...)</code> puis l'appeler : <code>DBFind("matable").Where({" id": $monid, "type": 2})</code>.</p> <div class="language- extra-class"><pre class="language-text"><code>func DBFind(table string).Columns(columns string).Where(format string, tail ...) .Limit(limit int).Offset(offset int) string { ... } func names() string { ... return DBFind("table").Columns("name").Where({"id": 100}).Limit(1) } </code></pre></div><h2 id="needle-functions-classification"><a href="#needle-functions-classification" class="header-anchor">#</a> Classification des fonctions Needle </h2> <p>Récupération des valeurs de la base de données :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#appparam">AppParam</a></td> <td><a href="#ecosysparam">EcosysParam</a></td> <td><a href="#getdatafromxlsx">GetDataFromXLSX</a></td></tr> <tr><td><a href="#dbfind">DBFind</a></td> <td><a href="#gethistory">GetHistory</a></td> <td><a href="#getrowscountxlsx">GetRowsCountXLSX</a></td></tr> <tr><td><a href="#dbrow">DBRow</a></td> <td><a href="#gethistoryrow">GetHistoryRow</a></td> <td><a href="#getblock">GetBlock</a></td></tr> <tr><td><a href="#dbselectmetrics">DBSelectMetrics</a></td> <td><a href="#getcolumntype">GetColumnType</a></td> <td><a href="#langres">LangRes</a></td></tr></tbody></table> <p>Mise à jour des données dans les tables :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#dbinsert">DBInsert</a></td> <td><a href="#dbupdateext">DBUpdateExt</a></td> <td><a href="#deltable">DelTable</a></td></tr> <tr><td><a href="#dbupdate">DBUpdate</a></td> <td><a href="#delcolumn">DelColumn</a></td> <td></td></tr></tbody></table> <p>Opérations avec des tableaux :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#append">Append</a></td> <td><a href="#len">Len</a></td> <td><a href="#getmapkeys">GetMapKeys</a></td></tr> <tr><td><a href="#join">Join</a></td> <td><a href="#row">Row</a></td> <td><a href="#sortedkeys">SortedKeys</a></td></tr> <tr><td><a href="#split">Split</a></td> <td><a href="#one">One</a></td> <td></td></tr></tbody></table> <p>Opérations avec des contrats et des autorisations:</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#callcontract">CallContract</a></td> <td><a href="#getcontractbyid">GetContractById</a></td> <td><a href="#transactioninfo">TransactionInfo</a></td></tr> <tr><td><a href="#contractaccess">ContractAccess</a></td> <td><a href="#roleaccess">RoleAccess</a></td> <td><a href="#throw">Throw</a></td></tr> <tr><td><a href="#contractconditions">ContractConditions</a></td> <td><a href="#getcontractbyname">GetContractByName</a></td> <td><a href="#validatecondition">ValidateCondition</a></td></tr> <tr><td><a href="#evalcondition">EvalCondition</a></td> <td></td> <td></td></tr></tbody></table> <p>Opérations avec des adresses :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#addresstoid">AddressToId</a></td> <td><a href="#idtoaddress">IdToAddress</a></td> <td><a href="#pubtoid">PubToID</a></td></tr></tbody></table> <p>Opérations avec des valeurs de variables:</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#decodebase64">DecodeBase64</a></td> <td><a href="#formatmoney">FormatMoney</a></td> <td><a href="#hash">Hash</a></td></tr> <tr><td><a href="#encodebase64">EncodeBase64</a></td> <td><a href="#random">Random</a></td> <td><a href="#sha256">Sha256</a></td></tr> <tr><td><a href="#float">Float</a></td> <td><a href="#int">Int</a></td> <td><a href="#str">Str</a></td></tr> <tr><td><a href="#hextobytes">HexToBytes</a></td> <td></td> <td></td></tr></tbody></table> <p>Opérations arithmétiques :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#floor">Floor</a></td> <td><a href="#log10">Log10</a></td> <td><a href="#round">Round</a></td></tr> <tr><td><a href="#log">Log</a></td> <td><a href="#pow">Pow</a></td> <td><a href="#sqrt">Sqrt</a></td></tr></tbody></table> <p>Opérations avec JSON:</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#jsonencode">JSONEncode</a></td> <td><a href="#jsonencodeindent">JSONEncodeIndent</a></td> <td><a href="#jsondecode">JSONDecode</a></td></tr></tbody></table> <p>Opérations avec des chaînes de caractères:</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#hasprefix">HasPrefix</a></td> <td><a href="#size">Size</a></td> <td><a href="#tolower">ToLower</a></td></tr> <tr><td><a href="#contains">Contains</a></td> <td><a href="#sprintf">Sprintf</a></td> <td><a href="#toupper">ToUpper</a></td></tr> <tr><td><a href="#replace">Replace</a></td> <td><a href="#substr">Substr</a></td> <td><a href="#trimspace">TrimSpace</a></td></tr></tbody></table> <p>Opérations avec des octets :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#stringtobytes">StringToBytes</a></td> <td><a href="#bytestostring">BytesToString</a></td> <td></td></tr></tbody></table> <p>Opérations avec date et heure au format SQL :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#blocktime">BlockTime</a></td> <td><a href="#datetime">DateTime</a></td> <td><a href="#unixdatetime">UnixDateTime</a></td></tr></tbody></table> <p>Opérations avec les paramètres de la plateforme:</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#sysparamstring">SysParamString</a></td> <td><a href="#sysparamint">SysParamInt</a></td> <td><a href="#dbupdatesysparam">DBUpdateSysParam</a></td></tr> <tr><td><a href="#updatenotifications">UpdateNotifications</a></td> <td><a href="#updaterolesnotifications">UpdateRolesNotifications</a></td> <td></td></tr></tbody></table> <p>Fonctionnement du mode CLB :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#httprequest">HTTPRequest</a></td> <td><a href="#httppostjson">HTTPPostJSON</a></td> <td></td></tr></tbody></table> <p>Fonctions pour les nœuds maîtres CLB :</p> <table><thead><tr><th></th> <th></th> <th></th></tr></thead> <tbody><tr><td><a href="#createobs">CreateOBS</a></td> <td><a href="#runobs">RunOBS</a></td> <td><a href="#removeobs">RemoveOBS</a></td></tr> <tr><td><a href="#getobslist">GetOBSList</a></td> <td><a href="#stopobs">StopOBS</a></td> <td></td></tr></tbody></table> <h2 id="needle-functions-reference"><a href="#needle-functions-reference" class="header-anchor">#</a> Référence des fonctions Needle </h2> <h3 id="appparam"><a href="#appparam" class="header-anchor">#</a> AppParam </h3> <p>Retourne la valeur d'un paramètre d'application spécifié (à partir de la table des paramètres d'application app_params).</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>AppParam(app int, name string, ecosystemid int) string </code></pre></div><ul><li><p><strong>App</strong></p> <p>Identifiant de l'application.</p></li> <li><p><strong>name</strong></p> <p>Nom du paramètre de l'application.</p></li> <li><p><strong>Ecosystemid</strong></p> <p>Identifiant de l'écosystème.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>AppParam(1, "app_account", 1) </code></pre></div><h3 id="dbfind"><a href="#dbfind" class="header-anchor">#</a> DBFind </h3> <p>Interroge les données d'une table spécifiée avec les paramètres spécifiés et renvoie un tableau de tableaux d'objets map.</p> <p><code>.Row()</code> permet d'obtenir le premier élément map dans la requête, <code>.One(column string)</code> permet d'obtenir le premier élément map d'une colonne spécifiée dans la requête.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBFind(table string) [.Columns(columns array|string)] [.Where(where map)] [.WhereId(id int)] [.Order(order string)] [.Limit(limit int)] [.Offset(offset int)] [.Row()] [.One(column string)] [.Ecosystem(ecosystemid int)] array </code></pre></div><ul><li><p><strong>table</strong></p> <p>Nom de la table.</p></li> <li><p><strong>colonnes</strong></p> <p>Retourne une liste de colonnes. Si non spécifié, toutes les colonnes seront renvoyées.</p> <p>La valeur est un tableau ou une chaîne de caractères séparée par des virgules.</p></li> <li><p><strong>où</strong></p> <p>Conditions de requête.</p></li></ul> <p>Exemple: <code>.Where({name: "John"})</code> ou <code>.Where({"id": {"$gte": 4}})</code>.</p> <p>Ce paramètre doit contenir un tableau d'objets avec des critères de recherche. Le tableau peut contenir des éléments imbriqués.</p> <p>Les constructions syntaxiques suivantes sont utilisées :</p> <ul><li><p><code>{"field1": "value1", "field2": "value2"}</code> Équivalent à <code>field1 = "value1" ET field2 = "value2"</code>.</p></li> <li><p><code>{"field1": {"$eq":"value"}}</code> Équivalent à <code>field = "value"</code>.</p></li> <li><p><code>{"field1": {"$neq": "value"}}</code> Équivalent à <code>field != "value"</code>.</p></li> <li><p><code>{"field1: {"$in": [1,2,3]}}</code> Équivalent à <code>field IN (1,2,3)</code>.</p></li> <li><p><code>{"field1": {"$nin": [1,2,3]}}</code> Équivalent à <code>field NOT IN (1,2,3)</code>.</p></li> <li><p><code>{"field": {"$lt": 12}}</code> Équivalent à <code>field < 12</code>.</p></li> <li><p><code>{"field": {"$lte": 12}}</code> Équivalent à <code>field <= 12</code>.</p></li> <li><p><code>{"field": {"$gt": 12}}</code> Équivalent à <code>field > 12</code>.</p></li> <li><p><code>{"field": {"$gte": 12}}</code> Équivalent à <code>field >= 12</code>.</p></li> <li><p><code>{"$and": [<expr1>, <expr2>, <expr3>]}</code> Équivalent à <code>expr1 ET expr2 ET expr3</code>.</p></li> <li><p><code>{"$or": [<expr1>, <expr2>, <expr3>]}</code> Équivalent à <code>expr1 OU expr2 OU expr3</code>.</p></li> <li><p><code>{field: {"$like": "value"}}</code> Équivalent à <code>field like '%value%'</code> (recherche floue).</p></li> <li><p><code>{field: {"$begin": "value"}}</code> Équivalent à <code>field like 'value%'</code> (commence par <code>value</code>).</p></li> <li><p><code>{field: {"$end": "value"}}</code> Équivalent à <code>field like '%value'</code> (se termine par <code>value</code>).</p></li> <li><p><code>{field: "$isnull"}</code> Équivalent à <code>field is null</code>.</p></li></ul> <p>Assurez-vous de ne pas écraser les clés des tableaux d'objets. Par exemple, si vous souhaitez interroger avec <code>id>2 et id<5</code>, vous ne pouvez pas utiliser <code>{id:{"$gt": 2}, id:{"$lt": 5}}</code>, car le premier élément sera écrasé par le deuxième élément. Vous devriez utiliser la structure de requête suivante :</p> <div class="language- extra-class"><pre class="language-text"><code>{id: [{"$gt": 2}, {"$lt": 5}]} </code></pre></div><div class="language- extra-class"><pre class="language-text"><code>{"$and": [{id:{"$gt": 2}}, {id:{"$lt": 5}}]} </code></pre></div><blockquote><p>Id</p></blockquote> <div class="language- extra-class"><pre><code>Requêtes par ID. Par exemple, .WhereId(1). </code></pre></div><blockquote><p>Order</p></blockquote> <div class="language- extra-class"><pre><code>Utilisé pour trier l'ensemble de résultats par une colonne spécifiée, ou par id par défaut. Si vous utilisez uniquement un champ pour le tri, vous pouvez le spécifier en tant que chaîne de caractères. Pour trier plusieurs champs, vous devez spécifier un tableau d'objets de chaînes de caractères : Ordre décroissant : `{"field": "-1"}` Équivalent à `field desc`. Ordre croissant : `{"field": "1"}` Équivalent à `field asc`. </code></pre></div><blockquote><p>limit</p></blockquote> <div class="language- extra-class"><pre><code>Renvoie le nombre d'entrées. 25, par défaut. Le nombre maximum est de 10 000. </code></pre></div><blockquote><p>Offset</p></blockquote> <div class="language- extra-class"><pre><code>Décalage. </code></pre></div><blockquote><p>Ecosystemid</p></blockquote> <div class="language- extra-class"><pre><code>Identifiant de l'écosystème. Par défaut, la table de l'écosystème actuel est interrogée. </code></pre></div><p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var i int var ret string ret = DBFind("contracts").Columns("id,value").Where({id: [{"$gt": 2}, {"$lt": 5}]}).Order( "id") while i <Len(ret) { var vals map vals = ret[0] Println(vals["value"]) i = i + 1 } ret = DBFind("contracts").Columns("id,value").WhereId(10).One("value") if ret != nil { Println(ret) Println(ret) Println(ret) } </code></pre></div><h3 id="dbrow"><a href="#dbrow" class="header-anchor">#</a> DBRow </h3> <p>Interroge les données d'une table spécifiée avec les paramètres spécifiés. Renvoie un tableau de tableaux d'objets map.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBRow(table string) [.Columns(columns array|string)] [.Where(where map)] [.WhereId(id int)] [.Order(order array|string)] [.Ecosystem(ecosystemid int)] map </code></pre></div><ul><li><p><strong>table</strong></p> <p>Nom de la table.</p></li> <li><p><strong>columns</strong></p> <p>Retourne une liste de colonnes. Si non spécifié, toutes les colonnes seront renvoyées.</p> <p>La valeur est un tableau ou une chaîne de caractères séparée par des virgules.</p></li> <li><p><strong>où</strong></p> <p>Conditions de requête.</p> <p>Par exemple : <code>.Where({name: "John"})</code> ou <code>.Where({"id": {"$gte": 4}})</code>.</p> <p>Pour plus de détails, consultez <a href="#dbfind">DBFind</a>.</p></li> <li><p><strong>Id</strong></p> <p>Requête par ID. Par exemple, <code>.WhereId(1)</code>.</p></li> <li><p><strong>Order</strong></p> <p>Utilisé pour trier l'ensemble des résultats par une colonne spécifiée, ou par id par défaut.</p> <p>Pour plus de détails, voir <a href="#dbfind">DBFind</a>.</p></li> <li><p><strong>Ecosystemid</strong></p> <p>Identifiant de l'écosystème. Par défaut, la table de l'écosystème actuel est interrogée.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var ret map ret = DBRow("contracts").Columns(["id","value"]).Where({id: 1}) Println(ret) </code></pre></div><h3 id="dbselectmetrics"><a href="#dbselectmetrics" class="header-anchor">#</a> DBSelectMetrics </h3> <p>Retourne les données agrégées d'une métrique.</p> <p>Les métriques sont mises à jour à chaque fois que 100 blocs sont générés. Et les données agrégées sont stockées sur un cycle de 1 jour.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBSelectMetrics(metric string, timeInterval string, aggregateFunc string) array </code></pre></div><ul><li><p><strong>metric</strong></p> <p>Nom de la métrique</p> <ul><li><p><strong>ecosystem_pages</strong></p> <p>Nombre de pages d'écosystème.</p> <p>Valeur de retour : clé - ID de l'écosystème, valeur - nombre de pages d'écosystème.</p></li> <li><p><strong>ecosystem_members</strong></p> <p>Nombre de membres de l'écosystème.</p> <p>Valeur de retour : clé - ID de l'écosystème, valeur - nombre de membres de l'écosystème.</p></li> <li><p><strong>ecosystem_tx</strong></p> <p>Nombre de transactions de l'écosystème.</p> <p>Valeur de retour : clé - ID de l'écosystème, valeur - nombre de transactions de l'écosystème.</p></li></ul></li> <li><p><strong>timeInterval</strong></p> <p>Intervalle de temps pour l'agrégation des données de la métrique. Par exemple : <code>1 jour</code>, <code>30 jours</code>.</p></li> <li><p><strong>aggregateFunc</strong></p> <p>Fonction d'agrégation. Par exemple, <code>max</code>, <code>min</code>, <code>avg</code>.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var rows array rows = DBSelectMetrics("ecosystem_tx", "30 days", "avg") var i int while(i <Len(rows)) { var row map row = rows[i] i = i + 1 } </code></pre></div><h3 id="ecosysparam"><a href="#ecosysparam" class="header-anchor">#</a> EcosysParam </h3> <p>Retourne la valeur d'un paramètre spécifié dans la table des paramètres de l'écosystème.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>EcosysParam(name string) string </code></pre></div><ul><li><p><strong>name</strong></p> <p>Nom du paramètre.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Println(EcosysParam("founder_account")) </code></pre></div><h3 id="gethistory"><a href="#gethistory" class="header-anchor">#</a> GetHistory </h3> <p>Retourne l'historique des modifications apportées aux entrées d'une table spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetHistory(table string, id int) array </code></pre></div><ul><li><p><strong>table</strong></p> <p>Nom de la table.</p></li> <li><p><strong>Id</strong></p> <p>Identifiant d'entrée.</p></li></ul> <p><strong>Valeur de retour</strong></p> <p>Retourne un tableau d'objets de type map, qui spécifient l'historique des modifications apportées aux entrées des tables.</p> <p>Chaque tableau contient les champs d'un enregistrement avant de procéder à la prochaine modification. Le tableau est trié par ordre des modifications les plus récentes.</p> <p>Le champ id dans le tableau pointe vers l'id de la table rollback_tx. block_id représente l'ID du bloc, tandis que block_time représente l'horodatage de génération du bloc.</p> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var list array var item map list = GetHistory("blocks", 1) if Len(list) > 0 { item = list[0] } </code></pre></div><h3 id="gethistoryrow"><a href="#gethistoryrow" class="header-anchor">#</a> GetHistoryRow </h3> <p>Retourne un instantané unique de l'historique des modifications d'une entrée spécifiée dans une table spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetHistoryRow(table string, id int, rollbackId int) map </code></pre></div><ul><li><p><strong>table</strong></p> <p>Nom de la table.</p></li> <li><p><strong>Id</strong></p> <p>Identifiant de l'entrée.</p></li> <li><p><strong>rollbackId</strong></p> <p>rollback_tx The entry ID of the table.</p></li></ul> <div class="language- extra-class"><pre class="language-text"><code> $result = GetHistoryRow("contracts",205,2358) </code></pre></div><h3 id="getcolumntype"><a href="#getcolumntype" class="header-anchor">#</a> GetColumnType </h3> <p>Returns the data type of a specified field in a specified table.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetColumnType(table, column string) string </code></pre></div><ul><li><p><strong>table</strong></p> <p>Table name.</p></li> <li><p><strong>column</strong></p> <p>Field Name.</p></li></ul> <blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>The following types can be returned: <code>text, varchar, number, money, double, bytes, json, datetime, double</code>.</p> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var coltype string coltype = GetColumnType("members", "member_name") </code></pre></div><h3 id="getdatafromxlsx"><a href="#getdatafromxlsx" class="header-anchor">#</a> GetDataFromXLSX </h3> <p>Returns data from XLSX spreadsheets.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetDataFromXLSX(binId int, line int, count int, sheet int) string </code></pre></div><ul><li><p><strong>binId</strong></p> <p>ID in XLSX format in the binary table binary.</p></li> <li><p><strong>line</strong></p> <p>The starting line number, starting from 0 by default.</p></li> <li><p><strong>count</strong></p> <p>The number of rows that need to be returned.</p></li> <li><p><strong>sheet</strong></p> <p>List number, starting from 1 by default.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var a array a = GetDataFromXLSX(3, 12, 10, 1) </code></pre></div><h3 id="getrowscountxlsx"><a href="#getrowscountxlsx" class="header-anchor">#</a> GetRowsCountXLSX </h3> <p>Returns the number of lines in a specified XLSX file.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetRowsCountXLSX(binId int, sheet int) int </code></pre></div><ul><li><p><strong>binId</strong></p> <p>ID in XLSX format in the binary table binary.</p></li> <li><p><strong>sheet</strong></p> <p>List number, starting from 1 by default.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var count int count = GetRowsCountXLSX(binid, 1) </code></pre></div><h3 id="langres"><a href="#langres" class="header-anchor">#</a> LangRes </h3> <p>Returns a multilingual resource with name label for language lang, specified as a two-character code, for example: <code>en</code>, <code>fr</code>. If there is no language for a selected language, then the language resource of the <code>en</code> label is returned.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>LangRes(label string, lang string) string </code></pre></div><ul><li><p><strong>label</strong></p> <p>Language resource name.</p></li> <li><p><strong>lang</strong></p> <p>Two-character language code.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>warning LangRes("@1confirm", "en") error LangRes("@1problems", "fr") </code></pre></div><h3 id="getblock"><a href="#getblock" class="header-anchor">#</a> GetBlock </h3> <p>Returns relevant information about a specified block.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetBlock(blockID int64) map </code></pre></div><ul><li><p><strong>blockID</strong></p> <p>Block ID.</p></li></ul> <blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>Return an array of objects:</p> <ul><li><p><strong>id</strong></p> <p>Block ID.</p></li> <li><p><strong>time</strong></p> <p>Block generation timestamp.</p></li> <li><p><strong>key_id</strong></p> <p>The account address of the verification node generated the block.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var b map b = GetBlock(1) Println(b) </code></pre></div><h3 id="dbinsert"><a href="#dbinsert" class="header-anchor">#</a> DBInsert </h3> <p>Adds an entry to a specified table and return the entry ID.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBInsert(table string, params map) int </code></pre></div><ul><li><p><strong>tblname</strong></p> <p>Table name.</p></li> <li><p><strong>params</strong></p> <p>An array of objects where keys are field names and values are inserted values.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBInsert("mytable", {name: "John Smith", amount: 100}) </code></pre></div><h3 id="dbupdate"><a href="#dbupdate" class="header-anchor">#</a> DBUpdate </h3> <p>Changes the column value of a specified entry ID in a specified table. If the entry ID does not exist in the table, an error is returned.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBUpdate(tblname string, id int, params map) </code></pre></div><ul><li><p><strong>tblname</strong></p> <p>Table name.</p></li> <li><p><strong>Id</strong></p> <p>Identifiant de l'entrée.</p></li> <li><p><strong>params</strong></p> <p>Un tableau d'objets où les clés sont les noms des champs et les valeurs sont les nouvelles valeurs après les modifications.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBUpdate("mytable", myid, {name: "John Smith", amount: 100}) </code></pre></div><h3 id="dbupdateext"><a href="#dbupdateext" class="header-anchor">#</a> DBUpdateExt </h3> <p>Modifie la valeur d'une colonne dans une table spécifiée qui correspond à la condition de requête.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBUpdateExt(tblname string, where map, params map) </code></pre></div><ul><li><p><strong>tblname</strong></p> <p>Nom de la table.</p></li> <li><p><strong>où</strong></p> <p>Conditions de requête.</p> <p>Pour plus de détails, consultez <a href="#dbfind">DBFind</a>.</p></li> <li><p><strong>params</strong></p> <p>Un tableau d'objets où les clés sont les noms des champs et les valeurs sont les nouvelles valeurs après les modifications.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBUpdateExt("mytable", {id: $key_id, ecosystem: $ecosystem_id}, {name: "John Smith", amount: 100}) </code></pre></div><h3 id="delcolumn"><a href="#delcolumn" class="header-anchor">#</a> DelColumn </h3> <p>Supprime un champ dans une table spécifiée qui ne contient aucun enregistrement.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DelColumn(tblname string, column string) </code></pre></div><ul><li><p><strong>tblname</strong></p> <p>Nom de la table.</p></li> <li><p><strong>column</strong></p> <p>Le champ à supprimer.</p></li></ul> <div class="language- extra-class"><pre class="language-text"><code>DelColumn("mytable", "mycolumn") </code></pre></div><h3 id="deltable"><a href="#deltable" class="header-anchor">#</a> DelTable </h3> <p>Supprime une table spécifiée qui ne contient aucun enregistrement.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DelTable(tblname string) </code></pre></div><ul><li><p><strong>tblname</strong></p> <p>Nom de la table.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DelTable("mytable") </code></pre></div><h3 id="append"><a href="#append" class="header-anchor">#</a> Append </h3> <p>Insère n'importe quel type de valeur dans le tableau src.</p> <p><strong>Syntaxe</strong></p> <p>Ajouter (src tableau, val anyType) tableau</p> <ul><li><p><strong>src</strong></p> <p>Le tableau original.</p></li> <li><p><strong>val</strong></p> <p>La valeur à insérer.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var list array list = Append(list, "new_val") </code></pre></div><h3 id="join"><a href="#join" class="header-anchor">#</a> Join </h3> <p>Combine les éléments du tableau en une chaîne de caractères avec un séparateur spécifié.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Join(in array, sep string) string </code></pre></div><ul><li><p><strong>In</strong></p> <p>Nom du tableau.</p></li> <li><p><strong>sep</strong></p> <p>Séparateur.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code> var val string, myarr array myarr[0] = "first" myarr[1] = 10 val = Join(myarr, ",") </code></pre></div><h3 id="split"><a href="#split" class="header-anchor">#</a> Split </h3> <p>Utilisez le séparateur "sep" pour diviser la chaîne d'entrée en éléments et les placer dans un tableau.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Split(in string, sep string) array </code></pre></div><ul><li><p><strong>In</strong></p> <p>Chaîne.</p></li> <li><p><strong>sep</strong></p> <p>Séparateur.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var myarr array myarr = Split("first,second,third", ",") </code></pre></div><h3 id="len"><a href="#len" class="header-anchor">#</a> Len </h3> <p>Retourne le nombre d'éléments dans un tableau spécifié.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Len(val array) int </code></pre></div><ul><li><p><strong>val</strong></p> <p>Tableau.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>if Len(mylist) == 0 { ... } </code></pre></div><h3 id="row"><a href="#row" class="header-anchor">#</a> Row </h3> <p>Le paramètre de liste ne doit pas être spécifié dans ce cas. Renvoyez le premier tableau d'objets dans la liste d'arrays. Si la liste est vide, un résultat vide est renvoyé. Cette fonction est principalement utilisée en conjonction avec la fonction <a href="#dbfind">DBFind</a>. Lors de l'utilisation de cette fonction, vous ne pouvez pas spécifier de paramètres.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code> Row(list array) map </code></pre></div><ul><li><p><strong>list</strong></p> <p>Le tableau d'objets retourné par la fonction DBFind.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code> var ret map ret = DBFind("contracts").Columns("id,value").WhereId(10).Row() Println(ret) </code></pre></div><h3 id="one"><a href="#one" class="header-anchor">#</a> One </h3> <p>Retourne la valeur du champ du premier objet du tableau dans la liste d'arrays. Si la liste est vide, nil est retourné. Cela est principalement utilisé en conjonction avec la fonction <a href="#dbfind">DBFind</a>. Lors de l'utilisation de cette fonction, vous ne pouvez pas spécifier de paramètres.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>One(list array, column string) string </code></pre></div><ul><li><strong>list</strong></li></ul> <p>Le tableau d'objets retourné par la fonction DBFind.</p> <ul><li><p><strong>column</strong></p> <p>Nom du champ.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var ret string ret = DBFind("contracts").Columns("id,value").WhereId(10).One("value") if ret != nil { Println(ret) } </code></pre></div><h3 id="getmapkeys"><a href="#getmapkeys" class="header-anchor">#</a> GetMapKeys </h3> <p>Retourne le tableau de clés dans le tableau d'objets.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetMapKeys(val map) array </code></pre></div><ul><li><p><strong>val</strong></p> <p>Tableau d'objets.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var val map var arr array val["k1"] = "v1" val["k2"] = "v2" arr = GetMapKeys(val) </code></pre></div><h3 id="sortedkeys"><a href="#sortedkeys" class="header-anchor">#</a> SortedKeys </h3> <p>Retourne un tableau de clés triées dans le tableau d'objets.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>SortedKeys(val map) array </code></pre></div><ul><li><p><strong>val</strong></p> <p>Tableau d'objets.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var val map var arr array val["k2"] = "v2" val["k1"] = "v1" arr = SortedKeys(val) </code></pre></div><h3 id="callcontract"><a href="#callcontract" class="header-anchor">#</a> CallContract </h3> <p>Appelle le contrat avec un nom spécifié. Tous les paramètres de la section de données dans le contrat doivent être inclus dans un tableau d'objets. Cette fonction renvoie la valeur assignée à la variable <strong>$result</strong> par un contrat spécifié.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>CallContract(name string, params map) </code></pre></div><ul><li><p><strong>name</strong></p> <p>Le nom du contrat qui est appelé.</p></li> <li><p><strong>params</strong></p> <p>Un tableau associatif des données d'entrée du contrat.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var par map par["Name"] = "My Name" CallContract("MyContract", par) </code></pre></div><h3 id="contractaccess"><a href="#contractaccess" class="header-anchor">#</a> ContractAccess </h3> <p>Vérifie si le nom du contrat en cours d'exécution correspond à l'un des noms répertoriés dans les paramètres. Cela est généralement utilisé pour contrôler l'accès du contrat aux tables. Lors de la modification des champs de table ou de l'insertion et de l'ajout de nouveaux champs de colonne dans la section des autorisations de la table, veuillez spécifier cette fonction dans les champs d'autorisations.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ContractAccess(name string, [name string]) bool </code></pre></div><ul><li><p><strong>name</strong></p> <p>Nom du contrat.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ContractAccess("MyContract") ContractAccess("MyContract","SimpleContract") </code></pre></div><h3 id="contractconditions"><a href="#contractconditions" class="header-anchor">#</a> ContractConditions </h3> <p>Appelle la section des conditions dans le contrat avec un nom spécifié.</p> <p>Pour ce type de contrats, la section des données doit être vide. Si la section des conditions est exécutée sans erreur, elle renvoie true. S'il y a une erreur pendant l'exécution, le contrat parent sera également résilié en raison de l'erreur. Cette fonction est généralement utilisée pour contrôler l'accès du contrat aux tables et peut être appelée dans les champs de permission lors de la modification des tables système.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ContractConditions(name string, [name string]) bool </code></pre></div><ul><li><p><strong>name</strong></p> <p>Nom du contrat.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ContractConditions("MainCondition") </code></pre></div><h3 id="evalcondition"><a href="#evalcondition" class="header-anchor">#</a> EvalCondition </h3> <p>Obtient la valeur du champ condfield dans l'enregistrement avec un champ 'name' de la table tablename, et vérifie les conditions de la valeur du champ condfield.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>EvalCondition(tablename string, name string, condfield string) </code></pre></div><ul><li><p><strong>tablename</strong></p> <p>Nom de la table.</p></li> <li><p><strong>name</strong></p> <p>Interroge la valeur avec le champ 'name'.</p></li> <li><p><strong>condfield</strong></p> <p>Le nom du champ dont les conditions doivent être vérifiées.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>EvalCondition(`menu`, $Name, `conditions`) </code></pre></div><h3 id="getcontractbyid"><a href="#getcontractbyid" class="header-anchor">#</a> GetContractById </h3> <p>Retourne le nom du contrat en fonction de l'ID du contrat. Si le contrat n'est pas trouvé, une chaîne vide est renvoyée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetContractById(id int) string </code></pre></div><ul><li><p><strong>Id</strong></p> <p>L'identifiant du contrat dans la table des contrats est contracts.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var name string name = GetContractById($IdContract) </code></pre></div><h3 id="getcontractbyname"><a href="#getcontractbyname" class="header-anchor">#</a> GetContractByName </h3> <p>Cette fonction renvoie l'ID de contrat correspondant à son nom de contrat. Si le contrat n'est pas trouvé, zéro est renvoyé.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetContractByName(name string) int </code></pre></div><ul><li><p><strong>name</strong></p> <p>Le nom du contrat dans la table des contrats est "contrats".</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var id int id = GetContractByName(`NewBlock`) </code></pre></div><h3 id="roleaccess"><a href="#roleaccess" class="header-anchor">#</a> RoleAccess </h3> <p>Vérifie si l'ID du rôle de l'appelant du contrat correspond à l'un des IDs spécifiés dans le paramètre.</p> <p>Vous pouvez utiliser cette fonction pour contrôler l'accès du contrat aux tables et autres données.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>RoleAccess(id int, [id int]) bool </code></pre></div><ul><li><p><strong>Id</strong></p> <p>Identifiant de rôle.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>RoleAccess(1) RoleAccess(1, 3) </code></pre></div><h3 id="transactioninfo"><a href="#transactioninfo" class="header-anchor">#</a> TransactionInfo </h3> <p>Requêtes les transactions par valeur de hachage spécifiée et renvoie des informations sur le contrat exécuté et ses paramètres.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>TransactionInfo(hash: string) </code></pre></div><ul><li><p><strong>hash</strong></p> <p>Hachage de transaction au format de chaîne hexadécimale.</p></li></ul> <blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>Cette fonction renvoie une chaîne au format JSON.</p> <div class="language- extra-class"><pre class="language-text"><code>{"contract":"ContractName", "params":{"key": "val"}, "block": "N"} </code></pre></div><ul><li><p><strong>contract</strong></p> <p>Nom du contrat.</p></li> <li><p><strong>params</strong></p> <p>Données transmises aux paramètres du contrat.</p></li> <li><p><strong>block</strong></p> <p>ID du bloc qui a traité la transaction.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var out map out = JSONDecode(TransactionInfo(hash)) </code></pre></div><h3 id="throw"><a href="#throw" class="header-anchor">#</a> Throw </h3> <p>Génère une erreur de type exception.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Throw(ErrorId string, ErrDescription string) </code></pre></div><ul><li><p><strong>ErrorId</strong></p> <p>Identifiant d'erreur.</p></li> <li><p><strong>ErrDescription</strong></p> <p>Description de l'erreur.</p></li></ul> <blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>Le format de ce type de transaction est le suivant:</p> <div class="language- extra-class"><pre class="language-text"><code>{"type":"exception","error":"Error description","id":"Error ID"} </code></pre></div><p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Throw("Problem", "There is a problem") </code></pre></div><h3 id="validatecondition"><a href="#validatecondition" class="header-anchor">#</a> ValidateCondition </h3> <p>Tente de compiler les conditions spécifiées par le paramètre de condition. S'il y a une erreur pendant le processus de compilation, une erreur est générée et le contrat appelé est terminé. Cette fonction est conçue pour vérifier la correction du format conditionnel.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ValidateCondition(condition string, state int) </code></pre></div><ul><li><p><strong>condition</strong></p> <p>Le format conditionnel qui doit être vérifié.</p></li> <li><p><strong>state</strong></p> <p>Identifiant de l'écosystème. Si vous vérifiez l'état mondial, veuillez le spécifier comme 0.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ValidateCondition(`ContractAccess("@1MyContract")`, 1) </code></pre></div><h3 id="addresstoid"><a href="#addresstoid" class="header-anchor">#</a> AddressToId </h3> <p>Retourne l'adresse de compte correspondante en fonction de l'adresse de portefeuille. Si une adresse invalide est spécifiée, '0' est retourné.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>AddressToId(address string) int </code></pre></div><ul><li><p>Address</p> <p>Adresse de portefeuille au format <code>XXXX-...-XXXX</code> ou au format numérique.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>wallet = AddressToId($Recipient) </code></pre></div><h3 id="idtoaddress"><a href="#idtoaddress" class="header-anchor">#</a> IdToAddress </h3> <p>Retourne l'adresse de portefeuille correspondante à l'adresse du compte. Si une adresse invalide est spécifiée, l'adresse invalide 'invalid' est renvoyée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>IdToAddress(id int) string </code></pre></div><ul><li><p><strong>Id</strong></p> <p>Adresse du compte.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>$address = IdToAddress($id) </code></pre></div><h3 id="pubtoid"><a href="#pubtoid" class="header-anchor">#</a> PubToID </h3> <p>L'adresse du compte est renvoyée par la clé publique au format hexadécimal.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>PubToID(hexkey string) int </code></pre></div><ul><li><p><strong>hexkey</strong></p> <p>La clé publique au format hexadécimal.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var wallet int wallet = PubToID("04fa5e78.....34abd6") </code></pre></div><h3 id="decodebase64"><a href="#decodebase64" class="header-anchor">#</a> DecodeBase64 </h3> <p>Retourne une chaîne en spécifiant le format base64</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DecodeBase64(input string) string </code></pre></div><ul><li><p><strong>Input</strong></p> <p>Chaîne au format base64.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = DecodeBase64(mybase64) </code></pre></div><h3 id="encodebase64"><a href="#encodebase64" class="header-anchor">#</a> EncodeBase64 </h3> <p>Retourne une chaîne au format base64 en spécifiant une chaîne.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>EncodeBase64(input string) string </code></pre></div><ul><li><p><strong>Input</strong></p> <p>La chaîne à encoder.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var base64str string base64str = EncodeBase64("my text") </code></pre></div><h3 id="float"><a href="#float" class="header-anchor">#</a> Float </h3> <p>Convertit un entier ou une chaîne de caractères en nombre décimal.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Float(val int|string) float </code></pre></div><ul><li><p><strong>val</strong></p> <p>Un entier ou une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Float("567.989") + Float(232) </code></pre></div><h3 id="hextobytes"><a href="#hextobytes" class="header-anchor">#</a> HexToBytes </h3> <p>Convertit une chaîne au format hexadécimal en octets de type byte.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code> HexToBytes(hexdata string) bytes </code></pre></div><ul><li><p><strong>hexdata</strong></p> <p>Une chaîne au format hexadécimal.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var val bytes val = HexToBytes("34fe4501a4d80094") </code></pre></div><h3 id="formatmoney"><a href="#formatmoney" class="header-anchor">#</a> FormatMoney </h3> <p>Retourne la valeur de chaîne de exp / 10 ^ digit.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>FormatMoney(exp string, digit int) string </code></pre></div><ul><li><p><strong>Exp</strong></p> <p>Un nombre au format de chaîne de caractères.</p></li> <li><p><strong>digit</strong></p> <p>L'exposant (positif ou négatif) de 10 dans l'expression <code>Exp/10^digit</code>. Les valeurs positives déterminent les décimales.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code> s = FormatMoney("78236475917384", 0) </code></pre></div><h3 id="random"><a href="#random" class="header-anchor">#</a> Random </h3> <div class="language- extra-class"><pre class="language-text"><code>Returns a random number between min and max (min <= result <max). Both min and max must be positive numbers. </code></pre></div><p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Random(min int, max int) int </code></pre></div><ul><li><p><strong>min</strong></p> <p>La valeur minimale parmi les nombres aléatoires.</p></li> <li><p><strong>max</strong></p> <p>La limite supérieure des nombres aléatoires. Le nombre aléatoire généré sera inférieur à cette valeur.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>i = Random(10,5000) </code></pre></div><h3 id="int"><a href="#int" class="header-anchor">#</a> Int </h3> <p>Convertit une valeur au format chaîne de caractères en un entier.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Int(val string) int </code></pre></div><ul><li><p><strong>val</strong></p> <p>Un nombre au format de chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>mystr = "-37763499007332" val = Int(mystr) </code></pre></div><h3 id="hash"><a href="#hash" class="header-anchor">#</a> Hash </h3> <p>Retourne le hachage d'un tableau d'octets ou d'une chaîne spécifiée, qui est généré par la bibliothèque de chiffrement système crypto.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Hash(val interface{}) string, error </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne de caractères ou un tableau d'octets.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var hash string hash = Hash("Test message") </code></pre></div><h3 id="sha256"><a href="#sha256" class="header-anchor">#</a> Sha256 </h3> <p>Retourne le hachage SHA256 d'une chaîne spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Sha256(val string) string </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne nécessite l'opération de hachage Sha256.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var sha string sha = Sha256("Test message") </code></pre></div><h3 id="str"><a href="#str" class="header-anchor">#</a> Str </h3> <p>Convertit un nombre entier int ou un nombre à virgule flottante float en une chaîne de caractères.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Str(val int|float) string </code></pre></div><ul><li><p><strong>val</strong></p> <p>Un nombre entier ou décimal.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>myfloat = 5.678 val = Str(myfloat) </code></pre></div><h3 id="jsonencode"><a href="#jsonencode" class="header-anchor">#</a> JSONEncode </h3> <p>Convertit un nombre, une chaîne de caractères ou un tableau en une chaîne de caractères au format JSON.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>JSONEncode(src int|float|string|map|array) string </code></pre></div><ul><li><p><strong>src</strong></p> <p>Data to convert.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var mydata map mydata["key"] = 1 var json string json = JSONEncode(mydata) </code></pre></div><h3 id="jsonencodeindent"><a href="#jsonencodeindent" class="header-anchor">#</a> JSONEncodeIndent </h3> <p>Utilise l'indentation spécifiée pour convertir un nombre, une chaîne de caractères ou un tableau en une chaîne au format JSON.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>JSONEncodeIndent(src int|float|string|map|array, indent string) string </code></pre></div><ul><li><p><strong>src</strong></p> <p>Données à convertir.</p></li> <li><p><strong>Indent</strong></p> <p>La chaîne sera utilisée comme indentation.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var mydata map mydata["key"] = 1 var json string json = JSONEncodeIndent(mydata, "\t") </code></pre></div><h3 id="jsondecode"><a href="#jsondecode" class="header-anchor">#</a> JSONDecode </h3> <p>Convertit une chaîne au format JSON en nombre, chaîne de caractères ou tableau.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>JSONDecode(src string) int|float|string|map|array </code></pre></div><ul><li><p><strong>src</strong></p> <p>Une chaîne contenant des données au format JSON.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var mydata map mydata = JSONDecode(`{"name": "John Smith", "company": "Smith's company"}`) </code></pre></div><h3 id="hasprefix"><a href="#hasprefix" class="header-anchor">#</a> HasPrefix </h3> <p>Vérifie si la chaîne commence par une chaîne spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>HasPrefix(s string, prefix string) bool </code></pre></div><ul><li><p><strong>s</strong></p> <p>Une chaîne de caractères.</p></li> <li><p><strong>prefix</strong></p> <p>Le préfixe à vérifier.</p></li></ul> <blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>Si la chaîne commence par une chaîne spécifiée, <code>true</code> est renvoyé.</p> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>if HasPrefix($Name, `my`) { ... } </code></pre></div><h3 id="contains"><a href="#contains" class="header-anchor">#</a> Contains </h3> <p>Vérifie si la chaîne de caractères contient une sous-chaîne spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Contains(s string, substr string) bool </code></pre></div><ul><li><p><strong>s</strong></p> <p>Une chaîne de caractères.</p></li> <li><p><strong>substr</strong></p> <p>Une sous-chaîne.</p></li></ul> <blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>Si la chaîne contient la sous-chaîne, elle renvoie <code>true</code>.</p> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>if Contains($Name, `my`) { ... } </code></pre></div><h3 id="replace"><a href="#replace" class="header-anchor">#</a> Remplacer </h3> <p>Remplacez l'ancien (la vieille chaîne) par le nouveau (la nouvelle chaîne) dans la chaîne.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Replace(s string, old string, new string) string </code></pre></div><ul><li><p><strong>s</strong></p> <p>La chaîne originale.</p></li> <li><p><strong>Old</strong></p> <p>La sous-chaîne à remplacer.</p></li> <li><p><strong>new</strong></p> <p>La nouvelle chaîne.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>s = Replace($Name, `me`, `you`) </code></pre></div><h3 id="size"><a href="#size" class="header-anchor">#</a> Size </h3> <p>Retourne le nombre d'octets dans une chaîne spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Size(val string) int </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var len int len = Size($Name) </code></pre></div><h3 id="sprintf"><a href="#sprintf" class="header-anchor">#</a> Sprintf </h3> <p>Cette fonction crée une chaîne de caractères en utilisant le modèle et les paramètres spécifiés.</p> <p>Jokers disponibles :</p> <ul><li><code>%d</code> (entier)</li> <li><code>%s</code> (chaîne de caractères)</li> <li><code>%f</code> (nombre à virgule flottante)</li> <li><code>%v</code> (n'importe quel type)</li></ul> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Sprintf(pattern string, val ...) string </code></pre></div><ul><li><p><strong>pattern</strong></p> <p>Un modèle de chaîne.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>out = Sprintf("%s=%d", mypar, 6448) </code></pre></div><h3 id="substr"><a href="#substr" class="header-anchor">#</a> Substr </h3> <p>Retourne la sous-chaîne obtenue à partir d'une chaîne spécifiée en commençant à l'offset (calculé à partir de 0 par défaut), et la longueur maximale est limitée à length.</p> <p>Si l'offset ou la longueur est inférieure à zéro, ou si l'offset est supérieur à la longueur, une chaîne vide est renvoyée.</p> <p>Si la somme de l'offset et de la longueur est supérieure à la taille de la chaîne, alors la sous-chaîne sera renvoyée à partir de l'offset jusqu'à la fin de la chaîne.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Substr(s string, offset int, length int) string </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne de caractères.</p></li> <li><p><strong>Offset</strong></p> <p>Décalage.</p></li> <li><p><strong>length</strong></p> <p>Longueur de la sous-chaîne.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var s string s = Substr($Name, 1, 10) </code></pre></div><h3 id="tolower"><a href="#tolower" class="header-anchor">#</a> ToLower </h3> <p>Renvoie une chaîne spécifiée en minuscules.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ToLower(val string) string </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = ToLower(val) </code></pre></div><h3 id="toupper"><a href="#toupper" class="header-anchor">#</a> ToUpper </h3> <p>Renvoie une chaîne spécifiée en majuscules.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>ToUpper(val string) string </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = ToUpper(val) </code></pre></div><h3 id="trimspace"><a href="#trimspace" class="header-anchor">#</a> TrimSpace </h3> <p>Supprime les espaces, les tabulations et les sauts de ligne en début et en fin d'une chaîne spécifiée.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>TrimSpace(val string) string </code></pre></div><ul><li><p><strong>val</strong></p> <p>Une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var val string val = TrimSpace(" mystr ") </code></pre></div><h3 id="floor"><a href="#floor" class="header-anchor">#</a> Floor </h3> <p>Renvoie la plus grande valeur entière inférieure ou égale à un nombre spécifié, un nombre à virgule flottante et une chaîne de caractères.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Floor(x float|int|string) int </code></pre></div><ul><li><p><strong>x</strong></p> <p>Un nombre, un nombre décimal et une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Floor(5.6) // returns 5 </code></pre></div><h3 id="log"><a href="#log" class="header-anchor">#</a> Log </h3> <p>Retourne le logarithme naturel d'un nombre spécifié, d'un nombre à virgule flottante et d'une chaîne de caractères.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Log(x float|int|string) float </code></pre></div><ul><li><p><strong>x</strong></p> <p>Un nombre, un nombre décimal et une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Log(10) </code></pre></div><h3 id="log10"><a href="#log10" class="header-anchor">#</a> Log10 </h3> <p>Renvoie le logarithme en base 10 d'un nombre, d'un nombre flottant et d'une chaîne spécifiés.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Log10(x float|int|string) float </code></pre></div><ul><li><p><strong>x</strong></p> <p>Un nombre, un nombre décimal et une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Log10(100) </code></pre></div><h3 id="pow"><a href="#pow" class="header-anchor">#</a> Pow </h3> <p>Renvoie la base spécifiée à la puissance spécifiée (xy).</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Pow(x float|int|string, y float|int|string) float </code></pre></div><ul><li><p><strong>x</strong></p> <p>Numéro de base.</p></li> <li><p><strong>y</strong></p> <p>Exposant.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Pow(2, 3) </code></pre></div><h3 id="round"><a href="#round" class="header-anchor">#</a> Round </h3> <p>Renvoie la valeur d'un nombre spécifié arrondi à l'entier le plus proche.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>Round(x float|int|string) int </code></pre></div><ul><li><p><strong>x</strong></p> <p>Un numéro.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Round(5.6) </code></pre></div><h3 id="sqrt"><a href="#sqrt" class="header-anchor">#</a> Sqrt </h3> <p>Retourne la racine carrée d'un nombre spécifié.</p> <div class="language- extra-class"><pre class="language-text"><code>Sqrt(x float|int|string) float </code></pre></div><ul><li><p><strong>x</strong></p> <p>Un numéro.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>val = Sqrt(225) </code></pre></div><h3 id="stringtobytes"><a href="#stringtobytes" class="header-anchor">#</a> StringToBytes </h3> <p>Convertit une chaîne de caractères en octets.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>StringToBytes(src string) bytes </code></pre></div><ul><li><p><strong>src</strong></p> <p>Une chaîne de caractères.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var b bytes b = StringToBytes("my string") </code></pre></div><h3 id="bytestostring"><a href="#bytestostring" class="header-anchor">#</a> BytesToString </h3> <p>Convertit des octets en chaîne de caractères.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>BytesToString(src bytes) string </code></pre></div><ul><li><p><strong>src</strong></p> <p>Octet.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var s string s = BytesToString($Bytes) </code></pre></div><h3 id="sysparamstring"><a href="#sysparamstring" class="header-anchor">#</a> SysParamString </h3> <p>Retourne la valeur d'un paramètre de plateforme spécifié.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>SysParamString(name string) string </code></pre></div><ul><li><p><strong>name</strong></p> <p>Nom du paramètre.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>url = SysParamString(`blockchain_url`) </code></pre></div><h3 id="sysparamint"><a href="#sysparamint" class="header-anchor">#</a> SysParamInt </h3> <p>Retourne la valeur d'un paramètre de plateforme spécifié sous forme de nombre.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>SysParamInt(name string) int </code></pre></div><ul><li><p><strong>name</strong></p> <p>Nom du paramètre.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>maxcol = SysParam(`max_columns`) </code></pre></div><h3 id="dbupdatesysparam"><a href="#dbupdatesysparam" class="header-anchor">#</a> DBUpdateSysParam </h3> <p>Met à jour la valeur et les conditions d'un paramètre de plateforme. Si vous n'avez pas besoin de modifier la valeur ou les conditions, veuillez spécifier une chaîne vide dans le paramètre correspondant.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBUpdateSysParam(name, value, conditions string) </code></pre></div><ul><li><p><strong>name</strong></p> <p>Nom du paramètre.</p></li> <li><p><strong>value</strong></p> <p>Nouvelle valeur d'un paramètre.</p></li> <li><p><strong>conditions</strong></p> <p>Nouvelles conditions pour mettre à jour un paramètre.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DBUpdateSysParam(`fuel_rate`, `400000000000`, ``) </code></pre></div><h3 id="updatenotifications"><a href="#updatenotifications" class="header-anchor">#</a> UpdateNotifications </h3> <p>Obtient la liste des notifications d'une clé spécifiée depuis la base de données, et envoie la notification obtenue à Centrifugo.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>UpdateNotifications(ecosystemID int, keys int...) </code></pre></div><ul><li><p><strong>EcosystemID</strong></p> <p>Identifiant de l'écosystème.</p></li> <li><p><strong>key</strong></p> <p>Une liste d'adresses de compte, séparées par des virgules. Ou vous pouvez utiliser un tableau pour spécifier une liste d'adresses de compte.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>UpdateNotifications($ecosystem_id, $key_id, 23345355454, 35545454554) UpdateNotifications(1, [$key_id, 23345355454, 35545454554]) </code></pre></div><h3 id="updaterolesnotifications"><a href="#updaterolesnotifications" class="header-anchor">#</a> UpdateRolesNotifications </h3> <p>Obtient la liste des notifications de toutes les adresses de compte d'un ID de rôle spécifié dans la base de données, et envoie la notification obtenue à Centrifugo.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>UpdateRolesNotifications(ecosystemID int, roles int ...) </code></pre></div><ul><li><p><strong>EcosystemID</strong></p> <p>Identifiant de l'écosystème.</p></li> <li><p><strong>roles</strong></p> <p>Une liste d'identifiants de rôles, séparés par des virgules. Ou vous pouvez utiliser un tableau pour spécifier une liste d'identifiants de rôles.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>UpdateRolesNotifications(1, 1, 2) </code></pre></div><h3 id="httprequest"><a href="#httprequest" class="header-anchor">#</a> HTTPRequest </h3> <p>Envoie des requêtes HTTP à l'adresse spécifiée.</p> <blockquote><p>Remarque</p></blockquote> <blockquote><p>Cette fonction ne peut être utilisée que dans les contrats CLB.</p></blockquote> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>HTTPRequest(url string, method string, heads map, pars map) string </code></pre></div><ul><li><p><strong>Url</strong></p> <p>Adresse à laquelle la demande sera envoyée.</p></li> <li><p><strong>method</strong></p> <p>Type de requête (GET ou POST).</p></li> <li><p><strong>heads</strong></p> <p>Un tableau d'en-têtes de requête, d'objets.</p></li> <li><p><strong>pars</strong></p> <p>Paramètres de la demande.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var ret string var ret string var ret string var pars, heads, json map heads["Authorization"] = "Bearer "+ $auth_token pars["obs"] = "true" ret = HTTPRequest("http://localhost:7079/api/v2/content/page/default_page","POST", heads, pars) json = JSONToMap(ret) </code></pre></div><h3 id="httppostjson"><a href="#httppostjson" class="header-anchor">#</a> HTTPPostJSON </h3> <p>Cette fonction est similaire à la fonction HTTPRequest, mais elle envoie une requête POST et les paramètres de la requête sont des chaînes de caractères.</p> <blockquote><p>Remarque</p></blockquote> <blockquote><p>Cette fonction ne peut être utilisée que dans les contrats CLB.</p></blockquote> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>HTTPPostJSON(url string, heads map, pars string) string </code></pre></div><ul><li><p><strong>Url</strong></p> <p>Adresse à laquelle la demande sera envoyée.</p></li> <li><p><strong>heads</strong></p> <p>Un tableau d'en-têtes de requête, d'objets.</p></li> <li><p><strong>pars</strong></p> <p>Paramètres de requête sous forme de chaîne JSON.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var ret string var ret string var ret string var heads, json map heads["Authorization"] = "Bearer "+ $auth_token ret = HTTPPostJSON("http://localhost:7079/api/v2/content/page/default_page", heads, `{"obs":"true"}`) json = JSONToMap(ret) </code></pre></div><h3 id="blocktime"><a href="#blocktime" class="header-anchor">#</a> BlockTime </h3> <p>Retourne le temps de génération du bloc au format SQL.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>BlockTime() </code></pre></div><p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>var mytime string mytime = BlockTime() DBInsert("mytable", myid, {time: mytime}) </code></pre></div><h3 id="datetime"><a href="#datetime" class="header-anchor">#</a> DateTime </h3> <p>Convertit le timestamp unixtime en une chaîne de caractères au format YYYY-MM-DD HH:MI:SS.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DateTime(unixtime int) string </code></pre></div><p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>DateTime(1532325250) </code></pre></div><h3 id="unixdatetime"><a href="#unixdatetime" class="header-anchor">#</a> UnixDateTime </h3> <p>Convertit une chaîne au format YYYY-MM-DD HH:MI:SS en un horodatage unixtime</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>UnixDateTime(datetime string) int </code></pre></div><p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>UnixDateTime("2018-07-20 14:23:10") </code></pre></div><h3 id="createobs"><a href="#createobs" class="header-anchor">#</a> CreateOBS </h3> <p>Crée un CLB enfant.</p> <p>Cette fonction ne peut être utilisée qu'en mode CLB maître.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>CreateOBS(OBSName string, DBUser string, DBPassword string, OBSAPIPort int) </code></pre></div><ul><li><p><strong>OBSName</strong></p> <p>Nom du CLB.</p></li> <li><p><strong>DBUser</strong></p> <p>Le nom du rôle de la base de données.</p></li> <li><p><strong>DBPassword</strong></p> <p>Le mot de passe du rôle.</p></li> <li><p><strong>OBSAPIPort</strong></p> <p>Le port de la requête API.</p></li></ul> <p><strong>Exemple</strong></p> <div class="language- extra-class"><pre class="language-text"><code>CreateOBS("obsname", "obsuser", "obspwd", 8095) </code></pre></div><h3 id="getobslist"><a href="#getobslist" class="header-anchor">#</a> GetOBSList </h3> <p>Retourne la liste des CLBs enfants.</p> <p>Cette fonction ne peut être utilisée qu'en mode CLB maître.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>GetOBSList() </code></pre></div><blockquote><p><strong>Valeur de retour</strong></p></blockquote> <p>Un tableau d'objets, où la clé est le nom du CLB et la valeur est l'état du processus.</p> <h3 id="runobs"><a href="#runobs" class="header-anchor">#</a> RunOBS </h3> <p>Un processus en cours d'exécution du CLB.</p> <p>Cette fonction ne peut être utilisée que dans le mode maître du CLB.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>RunOBS(OBSName string) </code></pre></div><ul><li><p><strong>OBSName</strong></p> <p>Nom du CLB.</p> <p>Il ne peut contenir que des lettres et des chiffres, et le symbole d'espace ne peut pas être utilisé.</p></li></ul> <h3 id="stopobs"><a href="#stopobs" class="header-anchor">#</a> StopOBS </h3> <p>Arrêtez le processus d'un CLB spécifié.</p> <p>Cette fonction ne peut être utilisée qu'en mode CLB maître.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>StopOBS(OBSName string) </code></pre></div><ul><li><p><strong>OBSName</strong></p> <p>Nom du CLB.</p> <p>Il ne peut contenir que des lettres et des chiffres, et le symbole d'espace ne peut pas être utilisé.</p></li></ul> <h3 id="removeobs"><a href="#removeobs" class="header-anchor">#</a> RemoveOBS </h3> <p>Supprime le processus d'un CLB spécifié.</p> <p>Cette fonction ne peut être utilisée qu'en mode CLB maître.</p> <p><strong>Syntaxe</strong></p> <div class="language- extra-class"><pre class="language-text"><code>RemoveOBS(OBSName string) </code></pre></div><ul><li><strong>OBSName</strong></li></ul> <p>Nom du CLB.</p> <p>Il ne peut contenir que des lettres et des chiffres, et le symbole d'espace ne peut pas être utilisé.</p> <h2 id="system-contracts"><a href="#system-contracts" class="header-anchor">#</a> System Contracts </h2> <p>Les contrats système sont créés par défaut lorsque la plateforme blockchain IBax est lancée. Tous ces contrats ont été créés dans le premier écosystème. C'est pourquoi vous devez spécifier leurs noms complets lors de leur appel à partir d'autres écosystèmes, par exemple, <code>@1NewContract</code>.</p> <h3 id="newecosystem"><a href="#newecosystem" class="header-anchor">#</a> NewEcosystem </h3> <p>Ce contrat crée un nouvel écosystème. Pour obtenir l'ID de l'écosystème créé, vous devez citer le champ de résultat retourné dans <a href="/fr/reference/api2.html#txstatus">txstatus</a>.</p> <p>Paramètres:</p> <ul><li><strong>Name</strong> - <em>string</em> - nom de l'écosystème. Il peut être modifié ultérieurement.</li></ul> <h3 id="editecosystemname"><a href="#editecosystemname" class="header-anchor">#</a> EditEcosystemName </h3> <p>Modifie le nom de l'écosystème dans la table 1_ecosystems qui n'existe que dans le premier écosystème.</p> <p>Paramètres:</p> <ul><li><strong>EcosystemID</strong> - <em>int</em> - change le nom de l'ID de l'écosystème;</li> <li><strong>NewName</strong> - <em>string</em> - nouveau nom de l'écosystème.</li></ul> <h3 id="newcontract"><a href="#newcontract" class="header-anchor">#</a> NewContract </h3> <p>Crée un nouveau contrat dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>ApplicationId</strong> - <em>int</em> - l'application à laquelle appartient un nouveau contrat;</li> <li><strong>Value</strong> - <em>string</em> - code source du contrat. La couche supérieure ne doit avoir qu'un seul contrat;</li> <li><strong>Conditions</strong> - <em>string</em> - modifie les conditions du contrat;</li> <li><strong>TokenEcosystem</strong> - <em>int "optionnel"</em> - ID de l'écosystème. Il détermine quel jeton sera utilisé pour les transactions lorsque le contrat est activé.</li></ul> <h3 id="editcontract"><a href="#editcontract" class="header-anchor">#</a> EditContract </h3> <p>Modifie le contrat dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - l'ID du contrat modifié;</li> <li><strong>Value</strong> - <em>string "optionnel"</em> - code source du contrat;</li> <li><strong>Conditions</strong> - <em>string "optionnel"</em> - modifie les conditions du contrat.</li></ul> <h3 id="bindwallet"><a href="#bindwallet" class="header-anchor">#</a> BindWallet </h3> <p>Liaison du contrat à l'adresse du portefeuille dans l'écosystème actuel. Après liaison avec le contrat, les frais d'exécution du contrat seront payés sous cette adresse.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - l'ID du contrat à lier.</li> <li><strong>WalletId</strong> - <em>string "optionnel"</em> - l'adresse du portefeuille liée au contrat.</li></ul> <h3 id="unbindwallet"><a href="#unbindwallet" class="header-anchor">#</a> UnbindWallet </h3> <p>Détacher le contrat de l'adresse du portefeuille dans l'écosystème actuel. Seules les adresses liées au contrat peuvent être détachées. Après avoir détaché le contrat, les utilisateurs qui exécutent le contrat devront payer les frais d'exécution.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - l'ID du contrat en cours de liaison.</li></ul> <h3 id="newparameter"><a href="#newparameter" class="header-anchor">#</a> NewParameter </h3> <p>Un nouveau paramètre d'écosystème a été ajouté à l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Nom</strong> - <em>string</em> - nom du paramètre;</li> <li><strong>Valeur</strong> - <em>string</em> - valeur du paramètre;</li> <li><strong>Conditions</strong> - <em>string</em> - conditions pour modifier le paramètre.</li></ul> <h3 id="editparameter"><a href="#editparameter" class="header-anchor">#</a> EditParameter </h3> <p>Modifie les paramètres de l'écosystème existant dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Nom</strong> - <em>string</em> - nom du paramètre à modifier;</li> <li><strong>Valeur</strong> - <em>string</em> - nouvelle valeur du paramètre;</li> <li><strong>Conditions</strong> - <em>string</em> - nouvelles conditions pour modifier le paramètre.</li></ul> <h3 id="newmenu"><a href="#newmenu" class="header-anchor">#</a> NewMenu </h3> <p>Ajoute un nouveau menu dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Nom</strong> - <em>string</em> - nom du menu;</li> <li><strong>Valeur</strong> - <em>string</em> - code source du menu;</li> <li><strong>Titre</strong> - <em>string "optional"</em> - titre du menu;</li> <li><strong>Conditions</strong> - <em>string</em> - conditions pour changer le menu.</li></ul> <h3 id="editmenu"><a href="#editmenu" class="header-anchor">#</a> EditMenu </h3> <p>Modifie le menu existant dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ID du menu à modifier ;</li> <li><strong>Value</strong> - <em>string "optionnel"</em> - code source du nouveau menu ;</li> <li><strong>Title</strong> - <em>string "optionnel"</em> - titre du nouveau menu ;</li> <li><strong>Conditions</strong> - <em>string "optionnel"</em> - nouvelles conditions pour modifier le menu.</li></ul> <h3 id="appendmenu"><a href="#appendmenu" class="header-anchor">#</a> AppendMenu </h3> <p>Ajoute le contenu du code source aux menus existants dans l'écosystème actuel</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ID du menu ;</li> <li><strong>Value</strong> - <em>string</em> - code source à ajouter.</li></ul> <h3 id="newpage"><a href="#newpage" class="header-anchor">#</a> NewPage </h3> <p>Ajoute une nouvelle page dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><p><strong>Nom</strong> - <em>String</em> - nom de la page ;</p></li> <li><p><strong>Valeur</strong> - <em>String</em> - code source de la page ;</p></li> <li><p><strong>Menu</strong> - <em>String</em> - nom du menu associé à la page ;</p></li> <li><p><strong>Conditions</strong> - <em>String</em> - conditions pour changer la page ;</p></li> <li><p><strong>ValidateCount</strong> - <em>int "optionnel"</em> - nombre de nœuds requis pour la validation de la page. Si ce paramètre n'est pas spécifié, la valeur du paramètre d'écosystème min_page_validate_count est utilisée. La valeur de ce paramètre ne peut pas être inférieure à min_page_validate_count et supérieure à max_page_validate_count ;</p></li> <li><p><strong>ValidateMode</strong> - <em>int "optional"</em> - mode de vérification de validité de la page. La page sera vérifiée lorsqu'elle est chargée si la valeur de ce paramètre est 0 ; ou vérifiée lorsqu'elle est chargée ou quitte la page si la valeur de ce paramètre est 1.</p></li></ul> <h3 id="editpage"><a href="#editpage" class="header-anchor">#</a> EditPage </h3> <p>Modifie les pages existantes dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ID de la page à modifier;</li> <li><strong>Value</strong> - <em>string "optional"</em> - code source de la nouvelle page ;</li> <li><strong>Menu</strong> - <em>string "optional"</em> - nom du nouveau menu associé à la page ;</li> <li><strong>Conditions</strong> - <em>string "optional"</em> - nouvelles conditions pour modifier la page ;</li> <li><strong>ValidateCount</strong> - <em>int "optional"</em> - nombre de nœuds requis pour la validation de la page. Si ce paramètre n'est pas spécifié, la valeur du paramètre d'écosystème min_page_validate_count est utilisée. La valeur de ce paramètre ne peut être inférieure à min_page_validate_count et supérieure à max_page_validate_count ;</li> <li><strong>ValidateMode</strong> - <em>int "optional"</em> - mode de vérification de la validité de la page. La page sera vérifiée lors de son chargement si la valeur de ce paramètre est 0 ; ou vérifiée lors de son chargement ou de sa sortie de la page si la valeur de ce paramètre est 1.</li></ul> <h3 id="appendpage"><a href="#appendpage" class="header-anchor">#</a> AppendPage </h3> <p>Ajoute le contenu source aux pages existantes dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ID de la page à modifier;</li> <li><strong>Value</strong> - <em>string</em> - Le code source à ajouter.</li></ul> <h3 id="newblock"><a href="#newblock" class="header-anchor">#</a> NewBlock </h3> <p>Ajoute un module de page à l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Nom</strong> - <em>string</em> - nom du module;</li> <li><strong>Valeur</strong> - <em>string</em> - code source du module;</li> <li><strong>Conditions</strong> - <em>string</em> - conditions pour modifier le module.</li></ul> <h3 id="editblock"><a href="#editblock" class="header-anchor">#</a> EditBlock </h3> <p>Modifie les modules de page existants dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li>Id - <em>int</em> - module ID à changer;</li> <li>Value - <em>string</em> - code source du nouveau module;</li> <li>Conditions - <em>string</em> - nouvelles conditions pour changer le module.</li></ul> <h3 id="newtable"><a href="#newtable" class="header-anchor">#</a> NewTable </h3> <p>Ajoute une nouvelle table à l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>ApplicationId</strong> - <em>int</em> - ID de l'application de la table associée ;</li> <li><strong>Name</strong> - <em>string</em> - nom de la nouvelle table ;</li> <li><strong>Columns</strong> - <em>string</em> - tableau de champs au format JSON <code>[{"name":"...", "type":"...","index": "0", "conditions":".. ."},...]</code>, où <ul><li><strong>name</strong> - nom du champ, uniquement des caractères latins ;</li> <li><strong>type</strong> - type de données <code>varchar,bytea,number,datetime,money,text,double,character</code>;</li> <li><strong>index</strong> - champ non clé primaire <code>0</code>, clé primaire <code>1</code>;</li> <li><strong>conditions</strong> - conditions pour modifier les données du champ, et les autorisations d'accès doivent être spécifiées au format JSON "<code>{"update":"ContractConditions(MainCondition)", "read":"ContractConditions(MainCondition)"}</code>;</li></ul></li> <li><strong>Permissions</strong> - <em>string</em> - autorisations d'accès au format JSON <code>{"insert": "...", "new_column": "...", "update": "...", "read": ".. ."}</code>. <ul><li><strong>insert</strong> - autorisation d'insérer des entrées ;</li> <li><strong>new_column</strong> - autorisation d'ajouter une nouvelle colonne ;</li> <li><strong>update</strong> - autorisation de modifier les données de l'entrée ;</li> <li><strong>read</strong> - autorisation de lire les données de l'entrée.</li></ul></li></ul> <h3 id="edittable"><a href="#edittable" class="header-anchor">#</a> EditTable </h3> <p>Modifie les permissions d'accès d'une table dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Name</strong> - <em>string</em> - nom de la table ;</li> <li><strong>InsertPerm</strong> - <em>string</em> - autorisation d'insérer des entrées dans la table ;</li> <li><strong>UpdatePerm</strong> - <em>string</em> - autorisation de mettre à jour les entrées dans la table ;</li> <li><strong>ReadPerm</strong> - <em>string</em> - autorisation de lire les entrées dans la table ;</li> <li><strong>NewColumnPerm</strong> - <em>string</em> - autorisation de créer une nouvelle colonne ;</li></ul> <h3 id="newcolumn"><a href="#newcolumn" class="header-anchor">#</a> NewColumn </h3> <p>Ajoute un nouveau champ à la table de l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>TableName</strong> - <em>string</em> - nom de la table ;</li> <li><strong>Name</strong> - <em>string</em> - nom du champ en caractères latins ;</li> <li><strong>Type</strong> - <em>string</em> - type de données <code>varchar,bytea,number,money,datetime,text,double,character</code>;</li> <li><strong>UpdatePerm</strong> - <em>string</em> - autorisation de modifier la valeur dans la colonne ;</li> <li><strong>ReadPerm</strong> - <em>string</em> - autorisation de lire la valeur dans la colonne.</li></ul> <h3 id="editcolumn"><a href="#editcolumn" class="header-anchor">#</a> EditColumn </h3> <p>Modifie les permissions d'un champ de table spécifié dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>TableName</strong> - <em>string</em> - nom de la table ;</li> <li><strong>Name</strong> - <em>string</em> - nom du champ en caractères latins à modifier ;</li> <li><strong>UpdatePerm</strong> - <em>string</em> - nouvelle autorisation pour modifier la valeur dans la colonne ;</li> <li><strong>ReadPerm</strong> - <em>string</em> - nouvelle autorisation pour lire la valeur dans la colonne.</li></ul> <h3 id="newlang"><a href="#newlang" class="header-anchor">#</a> NewLang </h3> <p>Ajoute des ressources linguistiques à l'écosystème actuel, et la permission de le faire est définie dans le paramètre changing_language des paramètres de l'écosystème.</p> <p>Paramètres:</p> <ul><li><strong>Name</strong> - <em>string</em> - nom des ressources linguistiques en caractères latins</li> <li><strong>Trans</strong> - <em>string</em> - chaîne au format JSON, avec un code de langue à deux caractères comme clé et la chaîne traduite comme valeur. Par exemple, <code>{"en": "Texte en anglais", "fr": "Texte en français"}</code>.</li></ul> <h3 id="editlang"><a href="#editlang" class="header-anchor">#</a> EditLang </h3> <p>Modifie les ressources linguistiques dans l'écosystème actuel, et l'autorisation de le faire est définie dans le paramètre changing_language de l'écosystème.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ressources linguistiques ID.</li> <li><strong>Trans</strong> - <em>string</em> En format JSON, avec un code de langue à deux caractères comme clé et la chaîne traduite comme valeur. Par exemple, <code>{"en": "Texte en anglais", "fr": "Texte en français"}</code>.</li></ul> <h3 id="import"><a href="#import" class="header-anchor">#</a> Import </h3> <p>Importe une application dans l'écosystème actuel et importe les données chargées à partir du contrat <a href="#importupload">ImportUpload</a>.</p> <p>Paramètres:</p> <ul><li><strong>Data</strong> - <em>string</em> - Données importées au format texte, provenant d'un fichier exporté par l'écosystème.</li></ul> <h3 id="importupload"><a href="#importupload" class="header-anchor">#</a> ImportUpload </h3> <p>Charge un fichier d'application externe dans la table buffer_data de l'écosystème actuel pour une importation ultérieure.</p> <p>Paramètres:</p> <ul><li><strong>InputFile</strong> - <em>file</em> - un fichier écrit dans la table buffer_data de l'écosystème actuel.</li></ul> <h3 id="newappparam"><a href="#newappparam" class="header-anchor">#</a> NewAppParam </h3> <p>Ajoute de nouveaux paramètres d'application à l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>ApplicationId</strong> - <em>int</em> - ID de l'application ;</li> <li><strong>Name</strong> - <em>string</em> - nom du paramètre ;</li> <li><strong>Value</strong> - <em>string</em> - valeur du paramètre ;</li> <li><strong>Conditions</strong> - <em>string</em> - autorisation de modifier le paramètre.</li></ul> <h3 id="editappparam"><a href="#editappparam" class="header-anchor">#</a> EditAppParam </h3> <p>Modifie les paramètres de l'application existante dans l'écosystème actuel.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ID du paramètre de l'application ;</li> <li><strong>Value</strong> - <em>string "optional"</em> - nouvelle valeur du paramètre ;</li> <li><strong>Conditions</strong> - <em>string "optional"</em> - nouvelles autorisations pour modifier le paramètre.</li></ul> <h3 id="newdelayedcontract"><a href="#newdelayedcontract" class="header-anchor">#</a> NewDelayedContract </h3> <p>Ajoute une nouvelle tâche au démon planificateur des contrats retardés.</p> <p>Le planificateur des contrats retardés exécute les contrats requis par le bloc actuellement généré.</p> <p>Paramètres:</p> <ul><li><strong>Contract</strong> - <em>string</em> - nom du contrat ;</li> <li><strong>EveryBlock</strong> - <em>int</em> - le contrat sera exécuté tous les X blocs ;</li> <li><strong>Conditions</strong> - <em>string</em> - autorisation de modifier la tâche ;</li> <li><strong>BlockID</strong> - <em>int "optional"</em> - l'ID du bloc où le contrat doit être exécuté. S'il n'est pas spécifié, il sera calculé automatiquement en ajoutant l'ID du "bloc courant" + EveryBlock ;</li> <li><strong>Limit</strong> - <em>int "optional"</em> - le nombre maximum d'exécutions de la tâche. S'il n'est pas spécifié, la tâche sera exécutée un nombre illimité de fois.</li></ul> <h3 id="editdelayedcontract"><a href="#editdelayedcontract" class="header-anchor">#</a> EditDelayedContract </h3> <p>Modifie une tâche dans le démon planificateur des contrats retardés.</p> <p>Paramètres:</p> <ul><li><strong>Id</strong> - <em>int</em> - ID de la tâche ;</li> <li><strong>Contract</strong> - <em>string</em> - nom du contrat ;</li> <li><strong>EveryBlock</strong> - <em>int</em> - le contrat sera exécuté tous les X blocs ;</li> <li><strong>Conditions</strong> - <em>string</em> - autorisation de modifier la tâche ;</li> <li><strong>BlockID</strong> - <em>int "optional"</em> - l'ID du bloc où le contrat doit être exécuté. S'il n'est pas spécifié, il sera calculé automatiquement en ajoutant l'ID du "bloc courant" + EveryBlock ;</li> <li><strong>Limit</strong> - <em>int "optional"</em> - le nombre maximum d'exécutions de la tâche. S'il n'est pas spécifié, la tâche sera exécutée un nombre illimité de fois ;</li> <li><strong>Deleted</strong> - <em>int "optional"</em> - bascule de la tâche. Une valeur de <code>1</code> désactivera la tâche. Une valeur de <code>0</code> activera la tâche.</li></ul> <h3 id="uploadbinary"><a href="#uploadbinary" class="header-anchor">#</a> UploadBinary </h3> <p>Ajoute ou remplace un fichier statique dans la table X_binaries. Lors de l'appel d'un contrat via l'API HTTP, la requête doit être au format <code>multipart/form-data</code>; le paramètre DataMimeType sera utilisé en conjonction avec les données du formulaire.</p> <p>Paramètres:</p> <ul><li><strong>Name</strong> - <em>string</em> - nom du fichier statique ;</li> <li><strong>Data</strong> - <em>bytes</em> - contenu du fichier statique ;</li> <li><strong>DataMimeType</strong> - <em>string "optional"</em> - un fichier statique au format mime-type ;</li> <li><strong>ApplicationId</strong> - <em>int</em> - l'ID de l'application associée à la table X_binaries.</li></ul> <p>Si le paramètre DataMimeType n'est pas spécifié, le format <code>application/octet-stream</code> est utilisé par défaut.</p></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/IBAX-io/documentation/edit/master/docs/fr/topics/script.md" target="_blank" rel="noopener noreferrer">Modifier cette page sur GitHub</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">Dernière mise à jour:</span> <span class="time">06/07/2023 18:59:03</span></div></footer> <div class="page-nav"><p class="inner"> <span class="next"><a href="/fr/topics/templates2.html"> Langage de modèle </a> → </span></p></div> </main></div><div class="global-ui"></div></div> <script src="/assets/js/app.d049f7ab.js" defer></script><script src="/assets/js/2.8d94a0db.js" defer></script><script src="/assets/js/62.6885c134.js" defer></script> </body> </html>