Smart Contracts </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/topics/script.html#contract-structure" class="sidebar-link">계약 구조 (Contract Structure) </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/topics/script.html#data-section" class="sidebar-link">데이터 섹션 (Data section) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#conditions-section" class="sidebar-link">조건 섹션 (Conditions section) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#action-section" class="sidebar-link">액션 섹션 (Action section) </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#variables" class="sidebar-link">변수 (Variables) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#nested-contracts" class="sidebar-link">중첩된 계약 (Nested Contracts) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#file-upload" class="sidebar-link">파일 업로드 (File upload) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#queries-in-json-format" class="sidebar-link">JSON 형식의 쿼리 (Queries in JSON format) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#queries-with-date-and-time-operations" class="sidebar-link">날짜 및 시간 연산이 포함된 쿼리 (Queries with date and time operations) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#needle-contract-language" class="sidebar-link">Needle 계약 언어 (Needle contract language) </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/topics/script.html#basic-elements-and-structure" class="sidebar-link">기본 요소 및 구조 (Basic elements and structure) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#data-types-and-variables" class="sidebar-link">데이터 유형 및 변수 (Data types and variables) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#array" class="sidebar-link">배열 (Array) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#if-and-while-statements" class="sidebar-link">If 및 While 문 (If and While statements) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#functions" class="sidebar-link">함수 (Functions) </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#needle-functions-classification" class="sidebar-link">Needle 함수 분류 (Needle functions classification) </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#needle-functions-reference" class="sidebar-link">Needle 함수 참조 (Needle functions reference) </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/topics/script.html#appparam" class="sidebar-link">AppParam </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbfind" class="sidebar-link">DBFind </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbrow" class="sidebar-link">DBRow </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbselectmetrics" class="sidebar-link">DBSelectMetrics </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#ecosysparam" class="sidebar-link">EcosysParam </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#gethistory" class="sidebar-link">GetHistory </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#gethistoryrow" class="sidebar-link">GetHistoryRow </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getcolumntype" class="sidebar-link">GetColumnType </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getdatafromxlsx" class="sidebar-link">GetDataFromXLSX </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getrowscountxlsx" class="sidebar-link">GetRowsCountXLSX </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#langres" class="sidebar-link">LangRes </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getblock" class="sidebar-link">GetBlock </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbinsert" class="sidebar-link">DBInsert </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbupdate" class="sidebar-link">DBUpdate </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbupdateext" class="sidebar-link">DBUpdateExt </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#delcolumn" class="sidebar-link">DelColumn </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#deltable" class="sidebar-link">DelTable </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#append" class="sidebar-link">Append </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#join" class="sidebar-link">Join </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#split" class="sidebar-link">Split </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#len" class="sidebar-link">Len </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#row" class="sidebar-link">Row </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#one" class="sidebar-link">One </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getmapkeys" class="sidebar-link">GetMapKeys </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#sortedkeys" class="sidebar-link">SortedKeys </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#callcontract" class="sidebar-link">CallContract </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#contractaccess" class="sidebar-link">ContractAccess </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#contractconditions" class="sidebar-link">ContractConditions </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#evalcondition" class="sidebar-link">EvalCondition </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getcontractbyid" class="sidebar-link">GetContractById </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getcontractbyname" class="sidebar-link">GetContractByName </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#roleaccess" class="sidebar-link">RoleAccess </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#transactioninfo" class="sidebar-link">TransactionInfo </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#throw" class="sidebar-link">Throw </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#validatecondition" class="sidebar-link">ValidateCondition </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#addresstoid" class="sidebar-link">AddressToId </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#idtoaddress" class="sidebar-link">IdToAddress </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#pubtoid" class="sidebar-link">PubToID </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#decodebase64" class="sidebar-link">DecodeBase64 </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#encodebase64" class="sidebar-link">EncodeBase64 </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#float" class="sidebar-link">Float </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#hextobytes" class="sidebar-link">HexToBytes </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#formatmoney" class="sidebar-link">FormatMoney </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#random" class="sidebar-link">Random </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#int" class="sidebar-link">Int </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#hash" class="sidebar-link">Hash </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#sha256" class="sidebar-link">Sha256 </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#str" class="sidebar-link">Str </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#jsonencode" class="sidebar-link">JSONEncode </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#jsonencodeindent" class="sidebar-link">JSONEncodeIndent </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#jsondecode" class="sidebar-link">JSONDecode </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#hasprefix" class="sidebar-link">HasPrefix </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#contains" class="sidebar-link">Contains </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#replace" class="sidebar-link">Replace </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#size" class="sidebar-link">Size </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#sprintf" class="sidebar-link">Sprintf </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#substr" class="sidebar-link">Substr </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#tolower" class="sidebar-link">ToLower </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#toupper" class="sidebar-link">ToUpper </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#trimspace" class="sidebar-link">TrimSpace </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#floor" class="sidebar-link">Floor </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#log" class="sidebar-link">Log </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#log10" class="sidebar-link">Log10 </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#pow" class="sidebar-link">Pow </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#round" class="sidebar-link">Round </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#sqrt" class="sidebar-link">Sqrt </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#stringtobytes" class="sidebar-link">StringToBytes </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#bytestostring" class="sidebar-link">BytesToString </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#sysparamstring" class="sidebar-link">SysParamString </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#sysparamint" class="sidebar-link">SysParamInt </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#dbupdatesysparam" class="sidebar-link">DBUpdateSysParam </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#updatenotifications" class="sidebar-link">UpdateNotifications </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#updaterolesnotifications" class="sidebar-link">UpdateRolesNotifications </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#httprequest" class="sidebar-link">HTTPRequest </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#httppostjson" class="sidebar-link">HTTPPostJSON </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#blocktime" class="sidebar-link">BlockTime </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#datetime" class="sidebar-link">DateTime </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#unixdatetime" class="sidebar-link">UnixDateTime </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#createobs" class="sidebar-link">CreateOBS </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#getobslist" class="sidebar-link">GetOBSList </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#runobs" class="sidebar-link">RunOBS </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#stopobs" class="sidebar-link">StopOBS </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#removeobs" class="sidebar-link">RemoveOBS </a></li></ul></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#system-contracts" class="sidebar-link">시스템 계약 (System Contracts) </a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newecosystem" class="sidebar-link">NewEcosystem </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editecosystemname" class="sidebar-link">EditEcosystemName </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newcontract" class="sidebar-link">NewContract </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editcontract" class="sidebar-link">EditContract </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#bindwallet" class="sidebar-link">BindWallet </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#unbindwallet" class="sidebar-link">UnbindWallet </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newparameter" class="sidebar-link">NewParameter </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editparameter" class="sidebar-link">EditParameter </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newmenu" class="sidebar-link">NewMenu </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editmenu" class="sidebar-link">EditMenu </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#appendmenu" class="sidebar-link">AppendMenu </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newpage" class="sidebar-link">NewPage </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editpage" class="sidebar-link">EditPage </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#appendpage" class="sidebar-link">AppendPage </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newblock" class="sidebar-link">NewBlock </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editblock" class="sidebar-link">EditBlock </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newtable" class="sidebar-link">NewTable </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#edittable" class="sidebar-link">EditTable </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newcolumn" class="sidebar-link">NewColumn </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editcolumn" class="sidebar-link">EditColumn </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newlang" class="sidebar-link">NewLang </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editlang" class="sidebar-link">EditLang </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#import" class="sidebar-link">Import </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#importupload" class="sidebar-link">ImportUpload </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newappparam" class="sidebar-link">NewAppParam </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editappparam" class="sidebar-link">EditAppParam </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#newdelayedcontract" class="sidebar-link">NewDelayedContract </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#editdelayedcontract" class="sidebar-link">EditDelayedContract </a></li><li class="sidebar-sub-header"><a href="/kr/topics/script.html#uploadbinary" class="sidebar-link">UploadBinary </a></li></ul></li></ul></li><li><a href="/kr/topics/templates2.html" class="sidebar-link">템플릿 언어 </a></li><li><a href="/kr/topics/vm.html" class="sidebar-link">컴파일러와 가상 머신 </a></li><li><a href="/kr/topics/daemons.html" class="sidebar-link">데몬 </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> Smart Contracts </h1> <h1 id=""><a href="#" class="header-anchor">#</a> 스마트 계약</h1> <ul><li><a href="#contract-structure">계약 구조</a> <ul><li><a href="#data-section">데이터 섹션</a></li> <li><a href="#conditions-section">조건 섹션</a></li> <li><a href="#action-section">액션 섹션</a></li></ul></li> <li><a href="#variables">변수</a></li> <li><a href="#nested-contracts">중첩된 계약</a></li> <li><a href="#file-upload">파일 업로드</a></li> <li><a href="#queries-in-json-format">JSON 형식의 쿼리</a></li> <li><a href="#queries-with-date-and-time-operations">날짜 및 시간 연산이 포함된 쿼리</a></li> <li><a href="#needle-contract-language">Needle 계약 언어</a> <ul><li><a href="#basic-elements-and-structure">기본 요소 및 구조</a></li> <li><a href="#data-types-and-variables">데이터 유형 및 변수</a></li> <li><a href="#array">배열</a></li> <li><a href="#if-and-while-statements">If 및 While 문</a></li></ul></li> <li><a href="#functions">함수</a> <ul><li><a href="#function-declaration">함수 선언</a></li> <li><a href="#variable-length-parameters">가변 길이 매개변수</a></li> <li><a href="#optional-parameters">옵션 매개변수</a></li></ul></li> <li><a href="#needle-functions-classification">Needle 함수 분류</a></li> <li><a href="#needle-functions-reference">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">시스템 계약</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>스마트 계약(이하 계약)은 애플리케이션의 기본 요소 중 하나입니다. 사용자가 페이지에서 계약을 구현하는 것은 일반적으로 데이터베이스 항목을 업데이트하거나 만드는 것이 목적인 단일 작업입니다. 애플리케이션의 모든 데이터 작업은 계약 시스템을 형성하며 이러한 계약은 데이터베이스 또는 계약 콘텐츠 기능을 통해 서로 상호 작용합니다.</p> <h2 id="contract-structure"><a href="#contract-structure" class="header-anchor">#</a> 계약 구조 (Contract Structure) </h2> <p>아래와 같은 형식으로 <code>contract</code> 키워드를 사용하여 계약을 선언합니다. 계약 이름 뒤에 중괄호로 계약 내용을 감싸야 합니다. 계약은 주로 세 가지 섹션으로 구성됩니다:</p> <ol><li><p><strong>data</strong> - <a href="#data-section">data section</a>에서는 입력 데이터의 변수 이름과 변수 유형을 선언합니다.</p></li> <li><p><strong>conditions</strong> - <a href="#conditions-section">conditions section</a>에서는 데이터의 정확성을 검증합니다.</p></li> <li><p><strong>action</strong> - <a href="#action-section">action section</a>에서는 데이터 조작을 정의합니다.</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> 데이터 섹션 (Data section) </h3> <p><code>data</code> 섹션에서는 계약 데이터 입력 및 수신된 폼 매개변수를 설명합니다.</p> <p>각 줄의 구조는 다음과 같습니다:</p> <ul><li>Variable name - 변수만 수신하고 배열은 수신하지 않습니다.</li> <li>Variable data type - 변수의 <a href="#data-types-and-variables">data type</a>;</li> <li>optional - 폼 요소에 기입하지 않아도 되는 선택적 매개변수입니다.</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> 조건 섹션 (Conditions section) </h3> <p><code>conditions</code> 섹션은 수신된 데이터의 검증을 설명합니다.</p> <p>다음 명령은 오류 경고에 사용됩니다: 심각한 오류 <code>error</code>, 경고 오류 <code>warning</code>, 암시적 오류 <code>info</code>. 이 세 가지 명령은 계약 실행을 종료하는 오류를 생성하고 각 오류는 다른 유형의 오류 로그 정보를 인쇄합니다. 예를 들어:</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> 액션 섹션 (Action section) </h3> <p><code>action</code> 섹션은 다른 데이터를 검색하고 결과 값을 테이블에 기록하는 계약의 주요 코드를 설명합니다. 예를 들어:</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>데이터 섹션에 선언된 변수는 <code>$</code> 기호와 변수 이름을 통해 다른 계약 섹션으로 전달됩니다. <code>$</code> 기호는 데이터 섹션에 없는 다른 변수를 선언하는 데에도 사용할 수 있으며, 이 변수는 이 계약 및 이 계약이 중첩된 모든 계약의 전역 변수로 간주됩니다.</p> <p>미리 정의된 변수는 스마트 계약을 호출한 트랜잭션 데이터를 포함하는 계약에서 사용할 수 있습니다.</p> <ul><li><code>$time</code> - 트랜잭션 타임스탬프;</li> <li><code>$ecosystem_id</code> - 생태계 ID;</li> <li><code>$block</code> - 트랜잭션을 포함하는 블록의 ID;</li> <li><code>$key_id</code> - 현재 트랜잭션에 서명한 계정의 주소;</li> <li><code>$type</code> - 가상 머신에서의 계약 ID;</li> <li><code>$block_key_id</code> - 블록을 생성한 노드의 계정 주소;</li> <li><code>$block_time</code> - 블록 생성 타임스탬프;</li> <li><code>$original_contract</code> - 초기에 트랜잭션을 처리한 계약의 이름. 이 변수가 빈 문자열이면 트랜잭션 유효성 검증 중에 계약이 호출되었음을 의미합니다. 계약이 다른 계약에 의해 호출되었는지 아니면 직접 트랜잭션에 의해 호출되었는지 확인하려면 $original_contract와 $this_contract의 값을 비교해야 합니다. 두 값이 동일하면 계약이 트랜잭션에 의해 호출된 것을 의미합니다;</li> <li><code>$this_contract</code> - 현재 실행 중인 계약의 이름;</li> <li><code>$guest_key</code> - 게스트 계정 주소;</li> <li><code>$stack</code> - 데이터 유형이 배열인 계약 배열 스택으로, 실행된 모든 계약을 포함합니다. 배열의 첫 번째 요소는 현재 실행 중인 계약의 이름을 나타내고, 마지막 요소는 초기에 트랜잭션을 처리한 계약의 이름을 나타냅니다;</li> <li><code>$node_position</code> - 블록이 위치한 검증 노드 배열의 인덱스 번호;</li> <li><code>$txhash</code> - 트랜잭션 해시;</li> <li><code>$contract</code> - 현재 계약 구조 배열.</li></ul> <p>미리 정의된 변수는 계약뿐만 아니라 애플리케이션 요소의 액세스 권한 조건을 정의하는 권한 필드에서도 액세스할 수 있습니다. 권한 필드에서 사용될 때 블록 정보에 대한 미리 정의된 변수는 <code>$time</code>, <code>$block</code> 등과 같이 항상 0입니다.</p> <p>미리 정의된 변수 <code>$result</code>는 계약의 반환 결과와 함께 할당됩니다.</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> 중첩된 계약 (Nested Contracts) </h2> <p>계약의 조건 및 작업 섹션에 계약을 중첩할 수 있습니다. 중첩된 계약은 직접 호출할 수 있으며 계약 매개변수는 계약 이름 뒤에 괄호 안에 지정됩니다(예: <code>@1NameContract(Params)</code>). <a href="#callcontract">CallContract</a> 함수를 사용하여 중첩 계약을 호출할 수도 있습니다.</p> <h2 id="file-upload"><a href="#file-upload" class="header-anchor">#</a> 파일 업로드 (File upload) </h2> <p><code>multipart/form-data</code> 형식의 양식을 사용하여 파일을 업로드하려면 계약서의 데이터 유형이 <code>file</code>이어야 합니다.</p> <div class="language- extra-class"><pre class="language-text"><code>contract Upload { data { File file } ... } </code></pre></div><p><a href="#uploadbinary">UploadBinary</a> 계약은 파일을 업로드하고 저장하는 데 사용됩니다. 페이지 편집기의 Logicor 언어 기능 <a href="/kr/topics/templates2.html#binary">Binary</a>를 사용하면 파일 다운로드 링크를 얻을 수 있습니다.</p> <h2 id="queries-in-json-format"><a href="#queries-in-json-format" class="header-anchor">#</a> JSON 형식의 쿼리 (Queries in JSON format) </h2> <p>계약 언어에서 <strong>JSON</strong>을 필드 유형으로 지정할 수 있습니다. <strong>columnname->fieldname</strong> 구문을 사용하여 항목 필드를 처리할 수 있습니다. 얻은 값은 <strong>columnname.fieldname</strong>에 기록됩니다. 위 구문은 <a href="#dbfind">DBFind</a> 함수의 Columns,One,Where에서 사용할 수 있습니다.</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> 날짜 및 시간 연산이 포함된 쿼리 (Queries with date and time operations) </h2> <p>계약 언어 함수로 날짜와 시간을 직접 쿼리하고 업데이트할 수는 없지만, 아래 예시와 같이 Where 문에서 PostgreSQL 함수와 기능을 사용할 수 있습니다. 예를 들어 date_column 필드를 현재 시간과 비교해야 합니다. date_column이 타임스탬프 유형인 경우 표현식은 <code>date_column <NOW()</code>여야 합니다. date_column이 Unix 유형인 경우 표현식은 <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>다음 Needle 함수는 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> Needle 계약 언어 (Needle contract language) </h2> <p>계약 언어에는 데이터 알고리즘 처리 및 데이터베이스 작업을 실현할 수 있는 일련의 함수, 연산자 및 구조가 포함됩니다.</p> <p>계약 편집 권한이 <code>false</code>로 설정되어 있지 않으면 계약 내용을 수정할 수 있습니다. 계약 변경의 전체 이력은 Weaver에서 사용할 수 있는 블록체인에 저장됩니다.</p> <p>블록체인의 데이터 작업은 최신 버전의 계약에 따라 실행됩니다.</p> <h3 id="basic-elements-and-structure"><a href="#basic-elements-and-structure" class="header-anchor">#</a> 기본 요소 및 구조 (Basic elements and structure) </h3> <h3 id="data-types-and-variables"><a href="#data-types-and-variables" class="header-anchor">#</a> 데이터 유형 및 변수 (Data types and variables) </h3> <p>데이터 유형은 모든 변수에 정의되어야 합니다. 일반적으로 데이터 유형은 자동으로 변환됩니다. 다음과 같은 데이터 유형을 사용할 수 있습니다:</p> <ul><li><code>bool</code> - 불리언, <code>true</code> 또는 <code>false</code>;</li> <li><code>bytes</code> - 바이트 형식;</li> <li><code>Int</code> - 64비트 정수;</li> <li><code>Array</code> - 어떤 유형의 배열;</li> <li><code>map</code> - 객체 배열;</li> <li><code>money</code> - 큰 정수;</li> <li><code>float</code> - 64비트 부동 소수점 숫자;</li> <li><code>string</code> - 문자열은 큰 따옴표나 이스케이프 형식으로 정의되어야 합니다: "This is a string" 또는 `This is a string`;</li> <li><code>file</code> - 객체 배열: <ul><li><code>Name</code> - 파일 이름, <code>string</code> 유형;</li> <li><code>MimeType</code> - 파일의 <strong>MIME 타입</strong>, <code>string</code> 유형;</li> <li><code>Body</code> - 파일 내용, <code>bytes</code> 유형.</li></ul></li></ul> <p>변수, 함수 및 계약의 이름을 포함한 모든 식별자는 대소문자를 구분합니다 (MyFunc와 myFunc은 다른 이름입니다).</p> <p>변수를 선언하려면 <strong>var</strong> 키워드를 사용하고 변수의 이름과 유형을 지정해야 합니다. 중괄호 내에서 선언된 변수는 동일한 중괄호 쌍 내에서 사용되어야 합니다.</p> <p>선언된 모든 변수의 기본값은 0입니다. bool 유형의 기본값은 false이고, 모든 숫자 유형의 기본값은 0이며, 문자열의 기본값은 빈 문자열입니다. 변수 선언의 예시:</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> 배열 (Array) </h3> <p>계약 언어는 두 가지 유형의 배열을 지원합니다:</p> <ul><li><code>Array</code> - 인덱스가 0부터 시작하는 배열;</li> <li><code>map</code> - 객체의 배열.</li></ul> <p>배열 요소를 할당하고 검색할 때는 인덱스를 대괄호에 위치시켜야 합니다. 배열에서 여러 개의 인덱스를 지원하지 않으며, 배열 요소를 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><code>[]</code>에 요소를 지정하여 배열 유형의 배열을 정의할 수도 있습니다. 지도 유형 <code>arrays</code>의 경우 <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>식에서 이러한 초기화를 사용할 수 있습니다. 예를 들어 함수 매개변수에 사용합니다.</p> <div class="language- extra-class"><pre class="language-text"><code>DBFind...Where({id: 1}) </code></pre></div><p>개체 배열의 경우 키를 지정해야 합니다. 키는 큰따옴표(<code>""</code>)로 묶인 문자열로 지정됩니다. 키 이름이 문자, 숫자 및 밑줄로 제한되는 경우 큰따옴표를 생략할 수 있습니다.</p> <div class="language- extra-class"><pre class="language-text"><code>{key1: "value1", key2: "value2"} </code></pre></div><p>배열은 문자열, 숫자, 모든 유형의 변수 이름 및 <code>$</code> 기호가 있는 변수 이름을 포함할 수 있습니다. 중첩 배열을 지원합니다. 다른 맵 또는 배열을 값으로 지정할 수 있습니다.</p> <p>식은 배열 요소로 사용할 수 없습니다. 변수를 사용하여 식 결과를 저장하고 이 변수를 배열 요소로 지정합니다.</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 및 While 문 (If and While statements) </h3> <p>계약 언어는 계약 및 함수에서 사용할 수 있는 표준 <strong>if</strong> 조건문 및 <strong>while</strong> 루프를 지원합니다. 이러한 명령문은 서로 중첩될 수 있습니다.</p> <p><strong>if</strong> 및 <strong>while</strong> 뒤에는 조건문이 와야 합니다. 조건문이 숫자를 반환하면 값이 0일 때 거짓으로 간주됩니다.</p> <p>val == 0은 !val과 같고 val != 0은 val과 같습니다. <strong>if</strong> 문은 <strong>else</strong> 코드 블록을 가질 수 있으며 <strong>else</strong>는 <strong>if</strong> 조건문이 거짓일 때 실행됩니다.</p> <p>다음 비교 연산자는 조건문에서 사용할 수 있습니다: <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>코드 블록은 <strong>while</strong> 루프의 조건문이 참일 때 실행됩니다. <strong>break</strong>는 코드 블록의 루프를 종료하는 것을 의미합니다. 루프를 처음부터 시작하려면 <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>조건문 외에도 Needle은 <code>+</code>, <code>-</code>, <code>*</code>, <code>/</code>와 같은 표준 산술 연산도 지원합니다.</p> <p>문자열 및 바이트 유형의 변수를 조건문으로 사용할 수 있습니다. 유형의 길이가 0보다 크면 조건이 참이고 그렇지 않으면 거짓입니다.</p> <h3 id="functions"><a href="#functions" class="header-anchor">#</a> 함수 (Functions) </h3> <p>함수는 계약의 <a href="#data-section">data section</a> 에서 수신한 데이터에 대해 일부 작업을 수행할 수 있습니다. 데이터베이스에서 데이터 읽기 및 쓰기, 값 유형 변환, 계약 간의 상호 작용 설정.</p> <h4 id="function-declaration"><a href="#function-declaration" class="header-anchor">#</a> 함수 선언 (Function declaration) </h4> <p>func 키워드를 사용하여 함수를 선언하고 그 뒤에 이름과 전달된 매개변수 목록 및 해당 유형을 사용합니다. 모든 매개변수는 괄호로 묶고 쉼표로 구분합니다. 괄호 뒤에는 함수가 반환하는 값의 데이터 유형을 선언해야 합니다. 함수 본문은 중괄호로 묶어야 합니다. 함수에 매개변수가 없으면 중괄호를 생략할 수 있습니다. 함수에서 값을 반환하려면 <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>모든 오류 검사가 자동으로 수행되기 때문에 함수는 오류를 반환하지 않습니다. 기능에 오류가 있는 경우 계약은 해당 작업을 종료하고 오류 설명을 창에 표시합니다.</p> <h4 id="variable-length-parameters"><a href="#variable-length-parameters" class="header-anchor">#</a> 가변 길이 매개변수 (Variable-length parameters) </h4> <p>함수는 가변 길이 매개변수를 정의할 수 있으며 <code>...</code> 기호를 함수의 마지막 매개변수 유형으로 사용하여 <code>array</code> 데이터 유형으로 가변 길이 매개변수를 나타낼 수 있습니다. 가변 길이 매개변수에는 매개변수가 호출에 전달된 시점부터의 모든 변수가 포함됩니다. 모든 유형의 변수를 전달할 수 있지만 데이터 유형의 불일치 충돌을 처리해야 합니다.</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> 옵션 매개변수 (Optional parameters) </h4> <p>함수는 많은 매개변수를 가지지만 호출할 때에는 그 중 일부만 필요할 수 있습니다. 이 경우, 다음과 같이 선택적 매개변수를 선언할 수 있습니다: <code>func myfunc(name string).Param1(param string).Param2(param2 int) {...}</code>, 그런 다음 호출할 때 지정된 매개변수를 원하는 순서로 호출할 수 있습니다: <code>myfunc("name").Param2(100)</code>.</p> <p>함수 본문에서는 이러한 변수들을 일반적으로 처리할 수 있습니다. 지정된 선택적 매개변수가 호출되지 않은 경우, 기본값은 0입니다. 또한 ...을 사용하여 가변 길이 매개변수를 지정할 수도 있습니다: <code>func DBFind(table string).Where(request string, params ...)</code> 그리고 이를 호출할 수 있습니다: <code>DBFind("mytable").Where({" id": $myid, "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> Needle 함수 분류 (Needle functions classification) </h2> <p>데이터베이스에서 값 검색:</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>테이블의 데이터 업데이트:</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>어레이 작업:</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>계약 및 권한이 있는 작업:</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>주소가 있는 작업:</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>변수 값을 사용한 작업:</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>산술 연산:</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>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>문자열 작업:</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>바이트 작업:</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>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>플랫폼 매개변수를 사용한 작업:</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>플랫폼 매개변수를 사용한 작업:</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>마스터 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> Needle 함수 참조 (Needle functions reference) </h2> <h3 id="appparam"><a href="#appparam" class="header-anchor">#</a> AppParam </h3> <p>지정된 응용 프로그램 매개변수의 값을 반환합니다 (응용 프로그램 매개변수 테이블 app_params에서).</p> <h4 id="-2"><a href="#-2" class="header-anchor">#</a> 구문</h4> <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>애플리케이션 ID.</p></li> <li><p><strong>name</strong></p> <p>애플리케이션 매개변수 이름.</p></li> <li><p><strong>Ecosystemid</strong></p> <p>생태계 ID.</p></li></ul> <h4 id="-3"><a href="#-3" class="header-anchor">#</a> 예</h4> <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>지정된 매개변수를 사용하여 지정된 테이블에서 데이터를 쿼리하고 객체 맵의 배열로 구성된 배열 배열을 반환합니다.</p> <p><code>.Row()</code>는 쿼리에서 첫 번째 맵 요소를 가져올 수 있고, <code>.One(열 문자열)</code>은 쿼리에서 지정된 열의 첫 번째 맵 요소를 가져올 수 있습니다.</p> <h4 id="-4"><a href="#-4" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>сolumns</strong></p> <p>열 목록을 반환합니다. 지정하지 않으면 모든 열이 반환됩니다.</p> <p>값은 배열이거나 쉼표로 구분된 문자열입니다.</p></li> <li><p><strong>where</strong></p> <p>쿼리 조건.</p> <p>예: <code>.Where({name: "John"})</code> 또는 <code>.Where({"id": {"$gte": 4}})</code>.</p> <p>이 매개변수는 검색 기준이 있는 객체 배열을 포함해야 합니다. 배열은 중첩된 요소를 포함할 수 있습니다.</p> <p>다음 구문 구조가 사용됩니다.</p> <ul><li><p><code>{"field1": "value1", "field2": "value2"}</code> <code>field1 = "value1" AND field2 = "value2"</code>와 동일합니다.</p></li> <li><p><code>{"field1": {"$eq":"value"}}</code> <code>field = "value"</code>와 동일합니다.</p></li> <li><p><code>{"field1": {"$neq": "value"}}</code> <code>field != "value"</code>와 동일합니다.</p></li> <li><p><code>{"field1: {"$in": [1,2,3]}</code> <code>field IN (1,2,3)</code>와 동일합니다.</p></li> <li><p><code>{"field1": {"$nin": [1,2,3]}</code> <code>field NOT IN (1,2,3)</code>와 동일합니다.</p></li> <li><p><code>{"field": {"$lt": 12}}</code> <code>field < 12</code>와 동일합니다.</p></li> <li><p><code>{"field": {"$lte": 12}}</code> <code>field <= 12</code>와 동일합니다.</p></li> <li><p><code>{"field": {"$gt": 12}}</code> <code>field > 12</code>와 동일합니다.</p></li> <li><p><code>{"field": {"$gte": 12}}</code> <code>field >= 12</code>와 동일합니다.</p></li> <li><p><code>{"$and": [<expr1>, <expr2>, <expr3>]}</code> <code>expr1 AND expr2 AND expr3</code>와 동일합니다.</p></li> <li><p><code>{"$or": [<expr1>, <expr2>, <expr3>]}</code> <code>expr1 OR expr2 OR expr3</code>와 동일합니다.</p></li> <li><p><code>{field: {"$like": "value"}}</code> <code>field like '%value%'</code>와 동일합니다 (퍼지 검색).</p></li> <li><p><code>{field: {"$begin": "value"}}</code> <code>field like 'value%'</code>와 동일합니다 (value로 시작).</p></li> <li><p><code>{field: {"$end": "value"}}</code> <code>field like '%value'</code>와 동일합니다 (value로 끝남).</p></li> <li><p><code>{field: "$isnull"}</code> <code>field is null</code>와 동일합니다.</p></li></ul></li></ul> <p>객체 배열의 키를 덮어쓰지 않도록 하십시오. 예를 들어 <code>id>2 및 id<5</code>로 쿼리하려는 경우 <code>{id:{"$gt": 2}, id:{"$lt": 5}}</code>를 사용할 수 없습니다. 첫 번째 요소는 두 번째 요소로 덮어씁니다. 다음 쿼리 구조를 사용해야 합니다.</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><ul><li><p><strong>Id</strong></p> <p>ID로 쿼리합니다. 예를 들어, .WhereId(1).</p></li> <li><p><strong>Order</strong></p> <p>지정된 열 또는 기본적으로 ID별로 결과 집합을 정렬하는 데 사용됩니다.</p> <p>정렬에 하나의 필드만 사용하는 경우 문자열로 지정할 수 있습니다. 여러 필드를 정렬하려면 문자열 객체의 배열을 지정해야 합니다.</p> <p>내림차순: <code>{"field": "-1"}</code> <code>field desc</code>와 동일합니다.</p> <p>오름차순: <code>{"field": "1"}</code> <code>field asc</code>와 동일합니다.</p></li> <li><p><strong>limit</strong></p> <p>항목 수를 반환합니다. 25, 기본적으로. 최대 수는 10,000입니다.</p></li> <li><p><strong>Offset</strong></p> <p>오프셋.</p></li> <li><p><strong>Ecosystemid</strong></p> <p>생태계 ID. 기본적으로 현재 생태계의 테이블이 쿼리됩니다.</p></li></ul> <h4 id="-5"><a href="#-5" class="header-anchor">#</a> 예</h4> <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><p></p> <h3 id="dbrow"><a href="#dbrow" class="header-anchor">#</a> DBRow </h3> <p>지정된 매개변수를 사용하여 지정된 테이블에서 데이터를 쿼리합니다. 객체 맵의 배열로 구성된 배열 배열을 반환합니다.</p> <h4 id="-6"><a href="#-6" class="header-anchor">#</a> 구문</h4> <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>테이블 이름입니다.</p></li> <li><p><strong>columns</strong></p> <p>열의 목록을 반환합니다. 지정하지 않으면 모든 열이 반환됩니다.</p> <p>값은 배열이거나 쉼표로 구분된 문자열입니다.</p></li> <li><p><strong>where</strong></p> <p>쿼리 조건입니다.</p> <p>예시: <code>.Where({name: "John"})</code> 또는 <code>.Where({"id": {"$gte": 4}})</code>.</p> <p>자세한 내용은 <a href="#dbfind">DBFind</a>를 참조하세요.</p></li> <li><p><strong>Id</strong></p> <p>ID로 쿼리합니다. 예시: <code>.WhereId(1)</code>.</p></li> <li><p><strong>Order</strong></p> <p>결과 집합을 지정된 열 또는 기본값인 id로 정렬하는 데 사용됩니다.</p> <p>자세한 내용은 <a href="#dbfind">DBFind</a>를 참조하세요.</p></li> <li><p><strong>Ecosystemid</strong></p> <p>생태계 ID입니다. 기본적으로 현재 생태계의 테이블을 쿼리합니다.</p></li></ul> <h4 id="-7"><a href="#-7" class="header-anchor">#</a> 예</h4> <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>메트릭의 집계된 데이터를 반환합니다.</p> <p>메트릭은 100개의 블록이 생성될 때마다 업데이트됩니다. 그리고 집계된 데이터는 1일 주기로 저장됩니다.</p> <h4 id="-8"><a href="#-8" class="header-anchor">#</a> 구문</h4> <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>메트릭 이름</p> <ul><li><p><strong>ecosystem_pages</strong></p> <p>생태계 페이지 수.</p> <p>반환 값: 키 - 생태계 ID, 값 - 생태계 페이지 수.</p></li> <li><p><strong>ecosystem_members</strong></p> <p>생태계 구성원 수.</p> <p>반환 값: 키 - 생태계 ID, 값 - 생태계 구성원 수.</p></li> <li><p><strong>ecosystem_tx</strong></p> <p>생태계 거래 수.</p> <p>반환 값: 키 - 생태계 ID, 값 - 생태계 트랜잭션 수.</p></li></ul></li> <li><p><strong>timeInterval</strong></p> <p>메트릭 데이터 집계를 위한 시간 간격입니다. 예: <code>1 day</code>, <code>30 days</code>.</p></li> <li><p><strong>aggregateFunc</strong></p> <p>함수를 집계합니다. 예: <code>max</code>, <code>min</code>, <code>avg</code>.</p></li></ul> <h4 id="-9"><a href="#-9" class="header-anchor">#</a> 예</h4> <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>생태계 매개변수 테이블 매개변수에서 지정된 매개변수의 값을 반환합니다.</p> <h4 id="-10"><a href="#-10" class="header-anchor">#</a> 구문</h4> <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>매개변수 이름.</p></li></ul> <h4 id="-11"><a href="#-11" class="header-anchor">#</a> 예</h4> <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>지정된 테이블의 항목에 대한 변경 내역을 반환합니다.</p> <h4 id="-12"><a href="#-12" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>Id</strong></p> <p>항목 ID.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>테이블의 항목에 대한 변경 기록을 지정하는 맵 유형의 개체 배열을 반환합니다.</p> <p>각 배열에는 다음 변경을 수행하기 전에 레코드의 필드가 포함됩니다. 배열은 가장 최근에 변경된 순서대로 정렬됩니다.</p> <p>배열의 id 필드는 rollback_tx 테이블의 id를 가리킵니다. block_id는 블록 ID를 나타내고 block_time은 블록 생성 타임스탬프를 나타냅니다.</p> <h4 id="-13"><a href="#-13" class="header-anchor">#</a> 예</h4> <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>지정된 테이블의 지정된 항목의 변경 기록에서 단일 스냅샷을 반환합니다.</p> <h4 id="-14"><a href="#-14" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>Id</strong></p> <p>항목 ID.</p></li> <li><p><strong>rollbackId</strong></p> <p>rollback_tx 테이블의 항목 ID입니다.</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>지정된 테이블에서 지정된 필드의 데이터 유형을 반환합니다.</p> <h4 id="-15"><a href="#-15" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>column</strong></p> <p>분야 명.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>반환될 수 있는 유형은 <code>text, varchar, number, money, double, bytes, json, datetime, double</code>입니다.</p> <h4 id="-16"><a href="#-16" class="header-anchor">#</a> 예</h4> <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>XLSX 스프레드시트에서 데이터를 반환합니다.</p> <h4 id="-17"><a href="#-17" class="header-anchor">#</a> 구문</h4> <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>이진 테이블 이진에서 XLSX 형식의 ID입니다.</p></li> <li><p><strong>line</strong></p> <p>기본적으로 0부터 시작하는 시작 줄 번호입니다.</p></li> <li><p><strong>count</strong></p> <p>반환해야 하는 행 수입니다.</p></li> <li><p><strong>sheet</strong></p> <p>기본적으로 1부터 시작하는 목록 번호입니다.</p></li></ul> <h4 id="-18"><a href="#-18" class="header-anchor">#</a> 예</h4> <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>지정된 XLSX 파일의 줄 수를 반환합니다.</p> <h4 id="-19"><a href="#-19" class="header-anchor">#</a> 구문</h4> <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>이진 테이블 이진에서 XLSX 형식의 ID입니다.</p></li> <li><p><strong>sheet</strong></p> <p>기본적으로 1부터 시작하는 목록 번호입니다.</p></li></ul> <h4 id="-20"><a href="#-20" class="header-anchor">#</a> 예</h4> <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>언어 lang에 대한 이름 레이블이 있는 다국어 리소스를 반환하며, 두 문자 코드로 지정됩니다(예: <code>en</code>, <code>kr</code>). 선택한 언어에 대한 언어가 없으면 <code>en</code> 레이블의 언어 리소스가 반환됩니다.</p> <h4 id="-21"><a href="#-21" class="header-anchor">#</a> 구문</h4> <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> <h4 id="-22"><a href="#-22" class="header-anchor">#</a> 예</h4> <div class="language- extra-class"><pre class="language-text"><code>warning LangRes("@1confirm", "en") error LangRes("@1problems", "kr") </code></pre></div><h3 id="getblock"><a href="#getblock" class="header-anchor">#</a> GetBlock </h3> <p>지정된 블록에 대한 관련 정보를 반환합니다.</p> <h4 id="-23"><a href="#-23" class="header-anchor">#</a> 구문</h4> <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>블록 ID.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>객체 배열을 반환합니다.</p> <ul><li><p><strong>id</strong></p> <p>블록 ID.</p></li> <li><p><strong>time</strong></p> <p>블록 생성 타임스탬프.</p></li> <li><p><strong>key_id</strong></p> <p>검증 노드의 계정 주소가 블록을 생성했습니다.</p></li></ul> <h4 id="-24"><a href="#-24" class="header-anchor">#</a> 예</h4> <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>지정된 테이블에 항목을 추가하고 항목 ID를 반환합니다.</p> <h4 id="-25"><a href="#-25" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>params</strong></p> <p>키가 필드 이름이고 값이 삽입된 값인 개체의 배열입니다.</p></li></ul> <h4 id="-26"><a href="#-26" class="header-anchor">#</a> 예</h4> <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>지정된 테이블에서 지정된 항목 ID의 열 값을 변경합니다. 항목 ID가 테이블에 없으면 오류가 반환됩니다.</p> <h4 id="-27"><a href="#-27" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>Id</strong></p> <p>항목 ID.</p></li> <li><p><strong>params</strong></p> <p>필드 이름이 키이고 변경 후의 새 값이 값인 객체 배열입니다.</p></li></ul> <h4 id="-28"><a href="#-28" class="header-anchor">#</a> 예</h4> <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>쿼리 조건과 일치하는 지정된 테이블의 열 값을 변경합니다.</p> <h4 id="-29"><a href="#-29" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>where</strong></p> <p>쿼리 조건.</p> <p>자세한 내용은 <a href="#dbfind">DBFind</a>를 참조하세요.</p></li> <li><p><strong>params</strong></p> <p>키가 필드 이름이고 값이 변경 후 새 값인 개체 배열입니다.</p></li></ul> <h4 id="-30"><a href="#-30" class="header-anchor">#</a> 예</h4> <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>레코드가 없는 지정된 테이블의 필드를 삭제합니다.</p> <h4 id="-31"><a href="#-31" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>column</strong></p> <p>삭제할 필드입니다.</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>레코드가 없는 지정된 테이블을 삭제합니다.</p> <h4 id="-32"><a href="#-32" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>DelTable(tblname string) </code></pre></div><ul><li><p><strong>tblname</strong></p> <p>테이블 이름.</p></li></ul> <h4 id="-33"><a href="#-33" class="header-anchor">#</a> 예</h4> <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>모든 유형의 val을 src 배열에 삽입합니다.</p> <h4 id="-34"><a href="#-34" class="header-anchor">#</a> 구문</h4> <p>Append(src array, val anyType) array</p> <ul><li><p><strong>src</strong></p> <p>원래 배열입니다.</p></li> <li><p><strong>val</strong></p> <p>삽입할 값입니다.</p></li></ul> <h4 id="-35"><a href="#-35" class="header-anchor">#</a> 예</h4> <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>지정된 sep 구분자로 배열의 요소를 문자열로 결합합니다.</p> <h4 id="-36"><a href="#-36" class="header-anchor">#</a> 구문</h4> <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>어레이 이름.</p></li> <li><p><strong>sep</strong></p> <p>분리 기호 (Separator).</p></li></ul> <h4 id="-37"><a href="#-37" class="header-anchor">#</a> 예</h4> <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>sep 구분자를 사용하여 in 문자열을 요소로 분할하고 배열에 넣습니다.</p> <h4 id="-38"><a href="#-38" class="header-anchor">#</a> 구문</h4> <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>끈.</p></li> <li><p><strong>sep</strong></p> <p>분리 기호 (Separator).</p></li></ul> <h4 id="-39"><a href="#-39" class="header-anchor">#</a> 예</h4> <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>지정된 배열의 요소 수를 반환합니다.</p> <h4 id="-40"><a href="#-40" class="header-anchor">#</a> 구문</h4> <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>정렬.</p></li></ul> <h4 id="-41"><a href="#-41" class="header-anchor">#</a> 예</h4> <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>이 경우 목록 매개변수를 지정하지 않아야 합니다. 배열 목록의 첫 번째 객체 배열을 반환합니다. 목록이 비어 있으면 빈 결과가 반환됩니다. 이 함수는 주로 <a href="#dbfind">DBFind</a> 함수와 함께 사용됩니다. 이 기능을 사용할 때 매개변수를 지정할 수 없습니다.</p> <h4 id="-42"><a href="#-42" class="header-anchor">#</a> 구문</h4> <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>DBFind 함수에서 반환된 개체 배열입니다.</p></li></ul> <h4 id="-43"><a href="#-43" class="header-anchor">#</a> 예</h4> <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>배열 목록에서 첫 번째 객체 배열의 필드 값을 반환합니다. 목록 배열이 비어있으면 nil 이 반환됩니다. 이 함수는 주로 <a href="#dbfind">DBFind</a> 함수와 함께 사용됩니다. 이 함수를 사용할 때는 매개변수를 지정할 수 없습니다.</p> <h4 id="-44"><a href="#-44" class="header-anchor">#</a> 구문</h4> <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>DBFind 함수에서 반환된 개체 배열입니다.</p> <ul><li><p><strong>column</strong></p> <p>분야 명.</p></li></ul> <h4 id="-45"><a href="#-45" class="header-anchor">#</a> 예</h4> <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>객체 배열의 키 배열을 반환합니다.</p> <h4 id="-46"><a href="#-46" class="header-anchor">#</a> 구문</h4> <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>객체 배열.</p></li></ul> <h4 id="-47"><a href="#-47" class="header-anchor">#</a> 예</h4> <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>객체 배열에서 정렬된 키 배열을 반환합니다.</p> <h4 id="-48"><a href="#-48" class="header-anchor">#</a> 구문</h4> <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>객체 배열.</p></li></ul> <h4 id="-49"><a href="#-49" class="header-anchor">#</a> 예</h4> <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>지정된 이름으로 스마트 계약을 호출합니다. 계약에 있는 데이터 섹션의 모든 매개변수는 개체 배열에 포함되어야 합니다. 이 함수는 지정된 계약에 의해 <strong>$result</strong> 변수에 할당된 값을 반환합니다.</p> <h4 id="-50"><a href="#-50" class="header-anchor">#</a> 구문</h4> <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>호출되는 계약의 이름입니다.</p></li> <li><p><strong>params</strong></p> <p>계약 입력 데이터의 연관 배열입니다.</p></li></ul> <h4 id="-51"><a href="#-51" class="header-anchor">#</a> 예</h4> <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>실행 중인 계약의 이름이 매개변수에 나열된 이름 중 하나와 일치하는지 확인합니다. 일반적으로 테이블에 대한 계약 액세스를 제어하는 데 사용됩니다. 테이블 필드를 편집하거나 테이블의 권한 섹션에 새 열 필드를 삽입 및 추가할 때 권한 필드에 이 기능을 지정하십시오.</p> <h4 id="-52"><a href="#-52" class="header-anchor">#</a> 구문</h4> <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>스마트 계약 이름.</p></li></ul> <h4 id="-53"><a href="#-53" class="header-anchor">#</a> 예</h4> <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>지정된 이름으로 계약서의 조건 섹션을 호출합니다.</p> <p>이 계약 유형의 경우 데이터 섹션이 비어 있어야 합니다. 조건 섹션이 오류 없이 실행되면 true를 반환합니다. 실행 중 오류가 발생하면 오류로 인해 상위 계약도 종료됩니다. 이 함수는 일반적으로 테이블에 대한 계약의 액세스를 제어하는 데 사용되며 시스템 테이블을 편집할 때 권한 필드에서 호출할 수 있습니다.</p> <h4 id="-54"><a href="#-54" class="header-anchor">#</a> 구문</h4> <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>계약명.</p></li></ul> <h4 id="-55"><a href="#-55" class="header-anchor">#</a> 예</h4> <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>tablename 테이블에서 'name' 필드가 있는 레코드의 condfield 필드 값을 가져오고 condfield 필드 값의 조건을 확인합니다.</p> <h4 id="-56"><a href="#-56" class="header-anchor">#</a> 구문</h4> <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>테이블 이름.</p></li> <li><p><strong>name</strong></p> <p>'name' 필드로 값을 쿼리합니다.</p></li> <li><p><strong>condfield</strong></p> <p>조건을 확인해야 하는 필드의 이름입니다.</p></li></ul> <h4 id="-57"><a href="#-57" class="header-anchor">#</a> 예</h4> <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>계약 ID로 계약 이름을 반환합니다. 계약서를 찾을 수 없으면 빈 문자열이 반환됩니다.</p> <h4 id="-58"><a href="#-58" class="header-anchor">#</a> 구문</h4> <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>계약 테이블 계약의 계약 ID입니다.</p></li></ul> <h4 id="-59"><a href="#-59" class="header-anchor">#</a> 예</h4> <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>이 함수는 계약 이름으로 계약 ID를 반환합니다. 계약서를 찾을 수 없으면 0이 반환됩니다.</p> <h4 id="-60"><a href="#-60" class="header-anchor">#</a> 구문</h4> <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>계약 테이블 계약의 계약 이름입니다.</p></li></ul> <h4 id="-61"><a href="#-61" class="header-anchor">#</a> 예</h4> <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>계약 호출자의 역할 ID가 매개변수에 지정된 ID 중 하나와 일치하는지 확인합니다.</p> <p>이 기능을 사용하여 테이블 및 기타 데이터에 대한 계약 액세스를 제어할 수 있습니다.</p> <h4 id="-62"><a href="#-62" class="header-anchor">#</a> 구문</h4> <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>역할 ID.</p></li></ul> <h4 id="-63"><a href="#-63" class="header-anchor">#</a> 예</h4> <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>지정된 해시 값으로 트랜잭션을 쿼리하고 실행된 계약 및 해당 매개변수에 대한 정보를 반환합니다.</p> <h4 id="-64"><a href="#-64" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>TransactionInfo(hash: string) </code></pre></div><ul><li><p><strong>hash</strong></p> <p>16진수 문자열 형식의 트랜잭션 해시입니다.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>이 함수는 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>계약명.</p></li> <li><p><strong>params</strong></p> <p>계약 매개변수에 전달된 데이터입니다.</p></li> <li><p><strong>block</strong></p> <p>트랜잭션을 처리한 블록의 ID입니다.</p></li></ul> <h4 id="-65"><a href="#-65" class="header-anchor">#</a> 예</h4> <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>예외 유형의 오류를 생성합니다.</p> <h4 id="-66"><a href="#-66" class="header-anchor">#</a> 구문</h4> <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>오류 식별자.</p></li> <li><p><strong>ErrDescription</strong></p> <p>오류 설명.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>이 유형의 거래 결과 형식은 다음과 같습니다.</p> <div class="language- extra-class"><pre class="language-text"><code>{"type":"exception","error":"Error description","id":"Error ID"} </code></pre></div><h4 id="-67"><a href="#-67" class="header-anchor">#</a> 예</h4> <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>조건 매개변수로 지정된 조건을 컴파일하려고 시도합니다. 컴파일 과정에서 오류가 발생하면 오류가 발생하고 호출된 계약이 종료됩니다. 이 기능은 조건부 형식의 정확성을 확인하도록 설계되었습니다.</p> <h4 id="-68"><a href="#-68" class="header-anchor">#</a> 구문</h4> <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>확인해야 하는 조건부 형식입니다.</p></li> <li><p><strong>state</strong></p> <p>생태계 ID. 전역 조건을 확인하는 경우 0으로 지정하십시오.</p></li></ul> <h4 id="-69"><a href="#-69" class="header-anchor">#</a> 예</h4> <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>지갑 주소로 해당 계정 주소를 반환합니다. 유효하지 않은 주소를 지정하면 "<code>0</code>" 이 반환됩니다.</p> <h4 id="-70"><a href="#-70" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>AddressToId(address string) int </code></pre></div><ul><li><p>Address</p> <p><code>XXXX-...-XXXX</code> 형식 또는 숫자 형식의 지갑 주소입니다.</p></li></ul> <h4 id="-71"><a href="#-71" class="header-anchor">#</a> 예</h4> <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>계정 주소별로 해당 지갑 주소를 반환합니다. 유효하지 않은 주소를 지정하면 유효하지 않은 주소 <code>invalid</code> 가 반환됩니다.</p> <h4 id="-72"><a href="#-72" class="header-anchor">#</a> 구문</h4> <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>계정 주소.</p></li></ul> <h4 id="-73"><a href="#-73" class="header-anchor">#</a> 예</h4> <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>계정 주소는 16진수 형식의 공개 키로 반환됩니다.</p> <h4 id="-74"><a href="#-74" class="header-anchor">#</a> 구문</h4> <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>16진수 형식의 공개 키입니다.</p></li></ul> <h4 id="-75"><a href="#-75" class="header-anchor">#</a> 예</h4> <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>base64 형식을 지정하여 문자열을 반환합니다.</p> <h4 id="-76"><a href="#-76" class="header-anchor">#</a> 구문</h4> <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>base64 형식의 문자열입니다.</p></li></ul> <h4 id="-77"><a href="#-77" class="header-anchor">#</a> 예</h4> <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>문자열을 지정하여 base64 형식의 문자열을 반환합니다.</p> <h4 id="-78"><a href="#-78" class="header-anchor">#</a> 구문</h4> <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>인코딩할 문자열입니다.</p></li></ul> <h4 id="-79"><a href="#-79" class="header-anchor">#</a> 예</h4> <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>정수 또는 문자열을 부동 숫자로 변환합니다.</p> <h4 id="-80"><a href="#-80" class="header-anchor">#</a> 구문</h4> <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>정수 또는 문자열.</p></li></ul> <h4 id="-81"><a href="#-81" class="header-anchor">#</a> 예</h4> <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>16진수 형식의 문자열을 바이트 유형 바이트로 변환합니다.</p> <h4 id="-82"><a href="#-82" class="header-anchor">#</a> 구문</h4> <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>16진수 형식의 문자열입니다.</p></li></ul> <h4 id="-83"><a href="#-83" class="header-anchor">#</a> 예</h4> <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>exp / 10 ^ 숫자의 문자열 값을 반환합니다.</p> <h4 id="-84"><a href="#-84" class="header-anchor">#</a> 구문</h4> <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>문자열 형식의 숫자입니다.</p></li> <li><p><strong>digit</strong></p> <p><code>Exp/10^digit</code> 표현식에서 10의 지수(양수 또는 음수)입니다. 양수 값은 소수 자릿수를 결정합니다.</p></li></ul> <h4 id="-85"><a href="#-85" class="header-anchor">#</a> 예</h4> <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><h4 id="-86"><a href="#-86" class="header-anchor">#</a> 구문</h4> <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>랜덤 숫자 중 최소값을 반환합니다.</p></li> <li><p><strong>max</strong></p> <p>랜덤 숫자의 상한선입니다. 생성된 랜덤 숫자는 이 값보다 작을 것입니다.</p></li></ul> <h4 id="-87"><a href="#-87" class="header-anchor">#</a> 예</h4> <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>문자열 형식의 값을 정수로 변환합니다.</p> <h4 id="-88"><a href="#-88" class="header-anchor">#</a> 구문</h4> <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>문자열 형식의 숫자입니다.</p></li></ul> <h4 id="-89"><a href="#-89" class="header-anchor">#</a> 예</h4> <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>시스템 암호화 라이브러리 crypto에 의해 생성된 지정된 바이트 배열 또는 문자열의 해시를 반환합니다.</p> <h4 id="-90"><a href="#-90" class="header-anchor">#</a> 구문</h4> <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>문자열 또는 바이트 배열.</p></li></ul> <h4 id="-91"><a href="#-91" class="header-anchor">#</a> 예</h4> <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>지정된 문자열의 SHA256 해시를 반환합니다.</p> <h4 id="-92"><a href="#-92" class="header-anchor">#</a> 구문</h4> <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>문자열에는 Sha256 해시 작업이 필요합니다.</p></li></ul> <h4 id="-93"><a href="#-93" class="header-anchor">#</a> 예</h4> <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>정수 int 또는 float float 숫자를 문자열로 변환합니다.</p> <h4 id="-94"><a href="#-94" class="header-anchor">#</a> 구문</h4> <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>정수 또는 실수.</p></li></ul> <h4 id="-95"><a href="#-95" class="header-anchor">#</a> 예</h4> <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>숫자, 문자열 또는 배열을 JSON 형식의 문자열로 변환합니다.</p> <h4 id="-96"><a href="#-96" class="header-anchor">#</a> 구문</h4> <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>변환할 데이터.</p></li></ul> <h4 id="-97"><a href="#-97" class="header-anchor">#</a> 예</h4> <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>지정된 들여쓰기를 사용하여 숫자, 문자열 또는 배열을 JSON 형식의 문자열로 변환합니다.</p> <h4 id="-98"><a href="#-98" class="header-anchor">#</a> 구문</h4> <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>변환할 데이터.</p></li> <li><p><strong>Indent</strong></p> <p>문자열은 들여쓰기로 사용됩니다.</p></li></ul> <h4 id="-99"><a href="#-99" class="header-anchor">#</a> 예</h4> <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>JSON 형식의 문자열을 숫자, 문자열 또는 배열로 변환합니다.</p> <h4 id="-100"><a href="#-100" class="header-anchor">#</a> 구문</h4> <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>JSON 형식의 데이터를 포함하는 문자열입니다.</p></li></ul> <h4 id="-101"><a href="#-101" class="header-anchor">#</a> 예</h4> <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>문자열이 지정된 문자열로 시작하는지 확인합니다.</p> <h4 id="-102"><a href="#-102" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li> <li><p><strong>prefix</strong></p> <p>확인할 접두사입니다.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>문자열이 지정된 문자열로 시작하면 <code>true</code>가 반환됩니다.</p> <h4 id="-103"><a href="#-103" class="header-anchor">#</a> 예</h4> <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>문자열에 지정된 하위 문자열이 포함되어 있는지 확인합니다.</p> <h4 id="-104"><a href="#-104" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li> <li><p><strong>substr</strong></p> <p>하위 문자열.</p></li></ul> <blockquote><p><strong>Return value</strong></p></blockquote> <p>문자열에 하위 문자열이 포함되어 있으면 <code>true</code> 를 반환합니다.</p> <h4 id="-105"><a href="#-105" class="header-anchor">#</a> 예</h4> <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> Replace </h3> <p>문자열에서 old(이전 문자열)를 new(새 문자열)로 바꿉니다.</p> <h4 id="-106"><a href="#-106" class="header-anchor">#</a> 구문</h4> <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>원래 문자열입니다.</p></li> <li><p><strong>Old</strong></p> <p>바꿀 하위 문자열입니다.</p></li> <li><p><strong>new</strong></p> <p>새 문자열입니다.</p></li></ul> <h4 id="-107"><a href="#-107" class="header-anchor">#</a> 예</h4> <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>지정된 문자열의 바이트 수를 반환합니다.</p> <h4 id="-108"><a href="#-108" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li></ul> <h4 id="-109"><a href="#-109" class="header-anchor">#</a> 예</h4> <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>이 함수는 지정된 템플릿과 매개변수를 사용하여 문자열을 생성합니다.</p> <p>사용 가능한 와일드카드:</p> <ul><li><code>%d</code> (정수)</li> <li><code>%s</code> (문자열)</li> <li><code>%f</code> (부동소수점)</li> <li><code>%v</code> (임의의 타입)</li></ul> <h4 id="-110"><a href="#-110" class="header-anchor">#</a> 구문</h4> <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>문자열 템플릿.</p></li></ul> <h4 id="-111"><a href="#-111" class="header-anchor">#</a> 예</h4> <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>지정된 문자열에서 offset (기본값으로부터 0 으로 계산)부터 시작하여 최대 길이 length로 얻은 부분 문자열을 반환합니다.</p> <p>만약 offset 또는 length 가 0보다 작거나, offset이 문자열 길이보다 큰 경우 빈 문자열이 반환됩니다.</p> <p>만약 offset 과 length의 합이 문자열의 크기보다 큰 경우, offset부터 문자열의 끝까지의 부분 문자열이 반환됩니다.</p> <h4 id="-112"><a href="#-112" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li> <li><p><strong>Offset</strong></p> <p>오프셋 (Offset).</p></li> <li><p><strong>length</strong></p> <p>하위 문자열의 길이입니다.</p></li></ul> <h4 id="-113"><a href="#-113" class="header-anchor">#</a> 예</h4> <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>지정된 문자열을 소문자로 반환합니다.</p> <h4 id="-114"><a href="#-114" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li></ul> <h4 id="-115"><a href="#-115" class="header-anchor">#</a> 예</h4> <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>지정된 문자열을 대문자로 반환합니다.</p> <h4 id="-116"><a href="#-116" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li></ul> <h4 id="-117"><a href="#-117" class="header-anchor">#</a> 예</h4> <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>지정된 문자열의 선행 및 후행 공백, 탭 및 개행을 삭제합니다.</p> <h4 id="-118"><a href="#-118" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li></ul> <h4 id="-119"><a href="#-119" class="header-anchor">#</a> 예</h4> <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>지정된 숫자, 부동 숫자 및 문자열보다 작거나 같은 가장 큰 정수 값을 반환합니다.</p> <h4 id="-120"><a href="#-120" class="header-anchor">#</a> 구문</h4> <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>숫자, 부동 숫자 및 문자열입니다.</p></li></ul> <h4 id="-121"><a href="#-121" class="header-anchor">#</a> 예</h4> <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>지정된 숫자, 부동 숫자 및 문자열의 자연 로그를 반환합니다.</p> <h4 id="-122"><a href="#-122" class="header-anchor">#</a> 구문</h4> <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>숫자, 부동 숫자 및 문자열입니다.</p></li></ul> <h4 id="-123"><a href="#-123" class="header-anchor">#</a> 예</h4> <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>지정된 숫자, 실수 숫자 및 문자열의 밑이 10인 로그를 반환합니다.</p> <h4 id="-124"><a href="#-124" class="header-anchor">#</a> 구문</h4> <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>숫자, 부동 숫자 및 문자열입니다.</p></li></ul> <h4 id="-125"><a href="#-125" class="header-anchor">#</a> 예</h4> <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>지정된 기준을 지정된 거듭제곱(xy)으로 반환합니다.</p> <h4 id="-126"><a href="#-126" class="header-anchor">#</a> 구문</h4> <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>기본 번호.</p></li> <li><p><strong>y</strong></p> <p>멱지수.</p></li></ul> <h4 id="-127"><a href="#-127" class="header-anchor">#</a> 예</h4> <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>가장 가까운 정수로 반올림된 지정된 숫자 값을 반환합니다.</p> <h4 id="-128"><a href="#-128" class="header-anchor">#</a> 구문</h4> <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>숫자.</p></li></ul> <h4 id="-129"><a href="#-129" class="header-anchor">#</a> 예</h4> <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>지정된 숫자의 제곱근을 반환합니다.</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>숫자.</p></li></ul> <h4 id="-130"><a href="#-130" class="header-anchor">#</a> 예</h4> <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>문자열을 바이트로 변환합니다.</p> <h4 id="-131"><a href="#-131" class="header-anchor">#</a> 구문</h4> <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>문자열.</p></li></ul> <h4 id="-132"><a href="#-132" class="header-anchor">#</a> 예</h4> <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>바이트를 문자열로 변환합니다.</p> <h4 id="-133"><a href="#-133" class="header-anchor">#</a> 구문</h4> <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>바이트 (Byte).</p></li></ul> <h4 id="-134"><a href="#-134" class="header-anchor">#</a> 예</h4> <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>지정된 플랫폼 매개변수의 값을 반환합니다.</p> <h4 id="-135"><a href="#-135" class="header-anchor">#</a> 구문</h4> <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>매개변수 이름.</p></li></ul> <h4 id="-136"><a href="#-136" class="header-anchor">#</a> 예</h4> <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>지정된 플랫폼 매개변수의 값을 숫자 형식으로 반환합니다.</p> <h4 id="-137"><a href="#-137" class="header-anchor">#</a> 구문</h4> <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>매개변수 이름.</p></li></ul> <h4 id="-138"><a href="#-138" class="header-anchor">#</a> 예</h4> <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>플랫폼 매개변수의 값과 조건을 업데이트합니다. 값이나 조건을 변경할 필요가 없다면 해당 매개변수에 빈 문자열을 지정하십시오.</p> <h4 id="-139"><a href="#-139" class="header-anchor">#</a> 구문</h4> <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>매개변수 이름.</p></li> <li><p><strong>value</strong></p> <p>매개변수의 새 값입니다.</p></li> <li><p><strong>conditions</strong></p> <p>매개변수 업데이트를 위한 새로운 조건.</p></li></ul> <h4 id="-140"><a href="#-140" class="header-anchor">#</a> 예</h4> <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>데이터베이스에서 지정된 키의 알림 목록을 가져와서 얻은 알림을 Centrifugo 로 보냅니다.</p> <h4 id="-141"><a href="#-141" class="header-anchor">#</a> 구문</h4> <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>생태계 ID.</p></li> <li><p><strong>key</strong></p> <p>쉼표로 구분된 계정 주소 목록입니다. 또는 배열을 사용하여 계정 주소 목록을 지정할 수 있습니다.</p></li></ul> <h4 id="-142"><a href="#-142" class="header-anchor">#</a> 예</h4> <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>데이터베이스에서 지정된 역할 ID의 모든 계정 주소에 대한 알림 목록을 획득하고 획득한 알림을 Centrifugo 로 보냅니다.</p> <h4 id="-143"><a href="#-143" class="header-anchor">#</a> 구문</h4> <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>생태계 ID.</p></li> <li><p><strong>roles</strong></p> <p>쉼표로 구분된 역할 ID 목록입니다. 또는 배열을 사용하여 역할 ID 목록을 지정할 수 있습니다.</p></li></ul> <h4 id="-144"><a href="#-144" class="header-anchor">#</a> 예</h4> <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>지정된 주소로 HTTP 요청을 보냅니다.</p> <blockquote><p>참고</p></blockquote> <blockquote><p>이 기능은 CLB 계약에서만 사용할 수 있습니다.</p></blockquote> <h4 id="-145"><a href="#-145" class="header-anchor">#</a> 구문</h4> <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>요청을 보낼 주소입니다.</p></li> <li><p><strong>method</strong></p> <p>요청 유형(GET 또는 POST).</p></li> <li><p><strong>heads</strong></p> <p>요청 헤더, 객체의 배열입니다.</p></li> <li><p><strong>pars</strong></p> <p>매개변수를 요청합니다.</p></li></ul> <h4 id="-146"><a href="#-146" class="header-anchor">#</a> 예</h4> <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>이 함수는 HTTPRequest 함수와 유사하지만 POST 요청을 보내고 요청 매개변수는 문자열입니다.</p> <blockquote><p>참고</p></blockquote> <blockquote><p>이 기능은 CLB 계약에서만 사용할 수 있습니다.</p></blockquote> <h4 id="-147"><a href="#-147" class="header-anchor">#</a> 구문</h4> <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>요청을 보낼 주소입니다.</p></li> <li><p><strong>heads</strong></p> <p>요청 헤더, 객체의 배열입니다.</p></li> <li><p><strong>pars</strong></p> <p>파라미터를 JSON 문자열로 요청합니다.</p></li></ul> <h4 id="-148"><a href="#-148" class="header-anchor">#</a> Example</h4> <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>블록의 생성 시간을 SQL 형식으로 반환합니다.</p> <h4 id="-149"><a href="#-149" class="header-anchor">#</a> Syntax</h4> <div class="language- extra-class"><pre class="language-text"><code>BlockTime() </code></pre></div><h4 id="-150"><a href="#-150" class="header-anchor">#</a> 예</h4> <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>타임스탬프 unixtime을 YYYY-MM-DD HH:MI:SS 형식의 문자열로 변환합니다.</p> <h4 id="-151"><a href="#-151" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>DateTime(unixtime int) string </code></pre></div><h4 id="-152"><a href="#-152" class="header-anchor">#</a> 예</h4> <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>YYYY-MM-DD HH:MI:SS 형식의 문자열을 타임스탬프 unixtime으로 변환합니다.</p> <h4 id="-153"><a href="#-153" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>UnixDateTime(datetime string) int </code></pre></div><h4 id="-154"><a href="#-154" class="header-anchor">#</a> 예</h4> <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>하위 CLB를 생성합니다.</p> <p>이 기능은 마스터 CLB 모드에서만 사용할 수 있습니다.</p> <h4 id="-155"><a href="#-155" class="header-anchor">#</a> 구문</h4> <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>CLB 이름.</p></li> <li><p><strong>DBUser</strong></p> <p>데이터베이스의 역할 이름입니다.</p></li> <li><p><strong>DBPassword</strong></p> <p>역할의 암호입니다.</p></li> <li><p><strong>OBSAPIPort</strong></p> <p>API 요청의 포트입니다.</p></li></ul> <h4 id="-156"><a href="#-156" class="header-anchor">#</a> 예</h4> <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>하위 CLB 목록을 반환합니다.</p> <p>이 기능은 마스터 CLB 모드에서만 사용할 수 있습니다.</p> <h4 id="-157"><a href="#-157" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>GetOBSList() </code></pre></div><blockquote><p><strong>Return value</strong></p></blockquote> <p>키가 CLB 이름이고 값이 프로세스 상태인 개체 배열입니다.</p> <h3 id="runobs"><a href="#runobs" class="header-anchor">#</a> RunOBS </h3> <p>CLB를 실행하는 프로세스.</p> <p>이 기능은 마스터 CLB 모드에서만 사용할 수 있습니다.</p> <h4 id="-158"><a href="#-158" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>RunOBS(OBSName string) </code></pre></div><ul><li><p><strong>OBSName</strong></p> <p>CLB 이름.</p> <p>영문과 숫자만 가능하며 공백 기호는 사용할 수 없습니다.</p></li></ul> <h3 id="stopobs"><a href="#stopobs" class="header-anchor">#</a> StopOBS </h3> <p>지정된 CLB의 프로세스를 중지합니다.</p> <p>이 기능은 마스터 CLB 모드에서만 사용할 수 있습니다.</p> <h4 id="-159"><a href="#-159" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>StopOBS(OBSName string) </code></pre></div><ul><li><p><strong>OBSName</strong></p> <p>CLB 이름.</p> <p>영문과 숫자만 가능하며 공백 기호는 사용할 수 없습니다.</p></li></ul> <h3 id="removeobs"><a href="#removeobs" class="header-anchor">#</a> RemoveOBS </h3> <p>지정된 CLB의 프로세스를 삭제합니다.</p> <p>이 기능은 마스터 CLB 모드에서만 사용할 수 있습니다.</p> <h4 id="-160"><a href="#-160" class="header-anchor">#</a> 구문</h4> <div class="language- extra-class"><pre class="language-text"><code>RemoveOBS(OBSName string) </code></pre></div><ul><li><strong>OBSName</strong></li></ul> <p>CLB 이름.</p> <p>영문과 숫자만 가능하며 공백 기호는 사용할 수 없습니다.</p> <h2 id="system-contracts"><a href="#system-contracts" class="header-anchor">#</a> 시스템 계약 (System Contracts) </h2> <p>시스템 스마트 계약은 IBax 블록체인 플랫폼이 실행될 때 기본적으로 생성됩니다. 이 모든 계약은 첫 번째 생태계에서 생성되었습니다. 이것이 다른 생태계에서 호출할 때 <code>@1NewContract</code>와 같이 전체 이름을 지정해야 하는 이유입니다.</p> <h3 id="newecosystem"><a href="#newecosystem" class="header-anchor">#</a> NewEcosystem </h3> <p>이 스마트 계약은 새로운 생태계를 생성합니다. 생성된 생태계의 ID를 얻으려면 <a href="/kr/reference/api2.html#txstatus">txstatus</a>에서 반환된 result 필드를 인용해야 합니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 생태계의 이름. 이후에 변경할 수 있습니다.</li></ul> <h3 id="editecosystemname"><a href="#editecosystemname" class="header-anchor">#</a> EditEcosystemName </h3> <p>첫 번째 생태계에만 존재하는 1_ecosystems 테이블의 생태계 이름을 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>EcosystemID</strong> int - 생태계 ID의 이름을 변경합니다.</li> <li><strong>NewName</strong> string - 생태계의 새 이름.</li></ul> <h3 id="newcontract"><a href="#newcontract" class="header-anchor">#</a> NewContract </h3> <p>현재 생태계에 새로운 스마트 계약을 생성합니다.</p> <p>매개변수:</p> <ul><li><strong>ApplicationId</strong> int - 새로운 계약이 속하는 응용 프로그램;</li> <li><strong>Value</strong> string - 계약 소스 코드. 상위 레벨에는 하나의 계약만 있어야 합니다.</li> <li><strong>Conditions</strong> string - 계약의 조건을 변경합니다.</li> <li><strong>TokenEcosystem</strong> int "optional" - 생태계 ID입니다. 계약이 활성화될 때 거래에 사용될 토큰을 결정합니다.</li></ul> <h3 id="editcontract"><a href="#editcontract" class="header-anchor">#</a> EditContract </h3> <p>현재 생태계에서 계약을 편집합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 변경할 계약 ID;</li> <li><strong>Value</strong> string "optional" - 계약의 소스 코드;</li> <li><strong>Conditions</strong> string "optional" - 계약의 조건을 변경합니다.</li></ul> <h3 id="bindwallet"><a href="#bindwallet" class="header-anchor">#</a> BindWallet </h3> <p>현재 생태계에서 스마트 계약을 지갑 주소에 바인딩합니다. 계약과 바인딩된 후, 계약 실행 수수료는 이 주소에서 지불됩니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 바인딩할 계약 ID.</li> <li><strong>WalletId</strong> string "optional" - 계약에 바인딩할 지갑 주소.</li></ul> <h3 id="unbindwallet"><a href="#unbindwallet" class="header-anchor">#</a> UnbindWallet </h3> <p>현재 생태계에서 계약과 지갑 주소의 바인딩을 해제합니다. 계약에 바인딩된 주소만 해제할 수 있습니다. 계약을 바인딩 해제한 후에는 계약을 실행하는 사용자가 실행 수수료를 지불합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 바인딩을 해제할 계약의 ID.</li></ul> <h3 id="newparameter"><a href="#newparameter" class="header-anchor">#</a> NewParameter </h3> <p>현재 생태계에 새로운 생태계 매개변수가 추가되었습니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 매개변수 이름;</li> <li><strong>Value</strong> string - 매개변수 값;</li> <li><strong>Conditions</strong> string - 매개변수를 변경하기 위한 조건.</li></ul> <h3 id="editparameter"><a href="#editparameter" class="header-anchor">#</a> EditParameter </h3> <p>현재 생태계에서 기존 생태계 매개변수를 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 변경할 매개변수의 이름;</li> <li><strong>Value</strong> string - 새로운 매개변수 값;</li> <li><strong>Conditions</strong> string - 매개변수를 변경하기 위한 새로운 조건.</li></ul> <h3 id="newmenu"><a href="#newmenu" class="header-anchor">#</a> NewMenu </h3> <p>현재 생태계에 새로운 메뉴를 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 메뉴 이름;</li> <li><strong>Value</strong> string - 메뉴 소스 코드;</li> <li><strong>Title</strong> string "optional" - 메뉴 제목;</li> <li><strong>Conditions</strong> string - 메뉴를 변경하기 위한 조건.</li></ul> <h3 id="editmenu"><a href="#editmenu" class="header-anchor">#</a> EditMenu </h3> <p>현재 생태계에서 기존 메뉴를 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 변경할 메뉴의 ID;</li> <li><strong>Value</strong> string "optional" - 새로운 메뉴의 소스 코드;</li> <li><strong>Title</strong> string "optional" - 새로운 메뉴의 제목;</li> <li><strong>Conditions</strong> string "optional" - 메뉴를 변경하기 위한 새로운 조건.</li></ul> <h3 id="appendmenu"><a href="#appendmenu" class="header-anchor">#</a> AppendMenu </h3> <p>현재 생태계에 기존 메뉴에 소스 코드 내용을 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 메뉴의 ID;</li> <li><strong>Value</strong> string - 추가할 소스 코드.</li></ul> <h3 id="newpage"><a href="#newpage" class="header-anchor">#</a> NewPage </h3> <p>현재 생태계에 새로운 페이지를 추가합니다.</p> <p>매개변수:</p> <ul><li><p><strong>Name</strong> string - 페이지 이름;</p></li> <li><p><strong>Value</strong> string - 페이지의 소스 코드;</p></li> <li><p><strong>Menu</strong> string - 페이지와 관련된 메뉴 이름;</p></li> <li><p><strong>Conditions</strong> string - 페이지를 변경하기 위한 조건;</p></li> <li><p><strong>ValidateCount</strong> int "optional" - 페이지 유효성 검사에 필요한 노드 수. 이 매개변수를 지정하지 않으면 min_page_validate_count 생태계 매개변수 값이 사용됩니다. 이 매개변수의 값은 min_page_validate_count보다 작거나 max_page_validate_count보다 크지 않아야 합니다.</p></li> <li><p><strong>ValidateMode</strong> int "optional" - 페이지 유효성 검사 모드. 이 매개변수의 값이 0이면 페이지가 로드될 때 확인되고, 값이 1이면 페이지가 로드되거나 페이지를 떠날 때 확인됩니다.</p></li></ul> <h3 id="editpage"><a href="#editpage" class="header-anchor">#</a> EditPage </h3> <p>현재 생태계에서 기존 페이지를 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 변경할 페이지의 ID;</li> <li><strong>Value</strong> string "optional" - 새로운 페이지의 소스 코드;</li> <li><strong>Menu</strong> string "optional" - 페이지와 관련된 새로운 메뉴 이름;</li> <li><strong>Conditions</strong> string "optional" - 페이지를 변경하기 위한 새로운 조건;</li> <li><strong>ValidateCount</strong> int "optional" - 페이지 유효성 검사에 필요한 노드 수. 이 매개변수를 지정하지 않으면 min_page_validate_count 생태계 매개변수 값이 사용됩니다. 이 매개변수의 값은 min_page_validate_count보다 작거나 max_page_validate_count보다 크지 않아야 합니다.</li> <li><strong>ValidateMode</strong> int "optional" - 페이지 유효성 검사 모드. 이 매개변수의 값이 0이면 페이지가 로드될 때 확인되고, 값이 1이면 페이지가 로드되거나 페이지를 떠날 때 확인됩니다.</li></ul> <h3 id="appendpage"><a href="#appendpage" class="header-anchor">#</a> AppendPage </h3> <p>기존 페이지에 소스 내용을 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 변경할 페이지의 ID;</li> <li><strong>Value</strong> string - 추가할 소스 코드.</li></ul> <h3 id="newblock"><a href="#newblock" class="header-anchor">#</a> NewBlock </h3> <p>현재 생태계에 페이지 모듈을 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 모듈의 이름;</li> <li><strong>Value</strong> string - 모듈의 소스 코드;</li> <li><strong>Conditions</strong> string - 모듈을 변경하기 위한 조건.</li></ul> <h3 id="editblock"><a href="#editblock" class="header-anchor">#</a> EditBlock </h3> <p>현재 생태계에서 기존 페이지 모듈을 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 변경할 모듈의 ID;</li> <li><strong>Value</strong> string - 새로운 모듈의 소스 코드;</li> <li><strong>Conditions</strong> string - 모듈을 변경하기 위한 새로운 조건.</li></ul> <h3 id="newtable"><a href="#newtable" class="header-anchor">#</a> NewTable </h3> <p>현재 생태계에 새로운 테이블을 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>ApplicationId</strong> int - 관련 테이블의 애플리케이션 ID;</li> <li><strong>Name</strong> string - 새로운 테이블의 이름;</li> <li><strong>Columns</strong> string - 필드 배열을 JSON 형식으로 나타낸 문자열 <code>[{"name":"...", "type":"...","index": "0", "conditions":".. ."},...]</code>, 여기서 <ul><li><strong>name</strong> - 필드 이름, 라틴 문자만 사용 가능;</li> <li><strong>type</strong> - 데이터 유형 <code>varchar,bytea,number,datetime,money,text,double,character</code>;</li> <li><strong>index</strong> - 비 기본 키 필드는 <code>0</code>, 기본 키는 <code>1</code>;</li> <li><strong>conditions</strong> - 필드 데이터를 변경하기 위한 조건, JSON 형식으로 "<code>{"update":"ContractConditions(MainCondition)", "read":"ContractConditions(MainCondition)"}</code>"와 같이 지정해야 합니다.</li></ul></li> <li><strong>Permissions</strong> string - JSON 형식의 접근 권한 <code>{"insert": "...", "new_column": "...", "update": "...", "read": ".. ."}</code>. <ul><li><strong>insert</strong> - 항목 삽입 권한;</li> <li><strong>new_column</strong> - 새로운 열 추가 권한;</li> <li><strong>update</strong> - 항목 데이터 변경 권한;</li> <li><strong>read</strong> - 항목 데이터 읽기 권한.</li></ul></li></ul> <h3 id="edittable"><a href="#edittable" class="header-anchor">#</a> EditTable </h3> <p>현재 생태계의 테이블의 접근 권한을 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 테이블 이름;</li> <li><strong>InsertPerm</strong> string - 테이블에 항목을 삽입하는 권한;</li> <li><strong>UpdatePerm</strong> string - 테이블의 항목을 업데이트하는 권한;</li> <li><strong>ReadPerm</strong> string - 테이블의 항목을 읽는 권한;</li> <li><strong>NewColumnPerm</strong> string - 새로운 열을 생성하는 권한;</li></ul> <h3 id="newcolumn"><a href="#newcolumn" class="header-anchor">#</a> NewColumn </h3> <p>현재 생태계의 테이블에 새로운 필드를 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>TableName</strong> string - 테이블 이름;</li> <li><strong>Name</strong> string - 라틴 문자로 된 필드 이름;</li> <li><strong>Type</strong> string - 데이터 유형 <code>varchar,bytea,number,money,datetime,text,double,character</code>;</li> <li><strong>UpdatePerm</strong> string - 열 값 변경 권한;</li> <li><strong>ReadPerm</strong> string - 열 값 읽기 권한.</li></ul> <h3 id="editcolumn"><a href="#editcolumn" class="header-anchor">#</a> EditColumn </h3> <p>현재 생태계에서 지정된 테이블 필드의 권한을 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>TableName</strong> string - 테이블 이름;</li> <li><strong>Name</strong> string - 변경할 라틴 문자로 된 필드 이름;</li> <li><strong>UpdatePerm</strong> string - 열 값 변경을 위한 새로운 권한;</li> <li><strong>ReadPerm</strong> string - 열 값 읽기를 위한 새로운 권한.</li></ul> <h3 id="newlang"><a href="#newlang" class="header-anchor">#</a> NewLang </h3> <p>현재 생태계에 언어 리소스를 추가하며, 이를 위한 권한은 생태계 매개변수의 changing_language로 설정됩니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 라틴 문자로 된 언어 리소스 이름;</li> <li><strong>Trans</strong> string - JSON 형식의 문자열, 키로는 두 글자로 된 언어 코드를 사용하고 값으로는 번역된 문자열을 사용합니다. 예를 들어 <code>{"en": "영어 텍스트", "kr": "중국어 텍스트"}</code>.</li></ul> <h3 id="editlang"><a href="#editlang" class="header-anchor">#</a> EditLang </h3> <p>현재 생태계의 언어 자원을 변경하며, 이를 위한 권한은 생태계 매개변수의 changing_language 매개변수에 설정됩니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 언어 리소스 ID.</li> <li><strong>Trans</strong> - JSON 형식의 문자열, 키로는 두 글자로 된 언어 코드를 사용하고 값으로는 번역된 문자열을 사용합니다. 예를 들어 <code>{"en": "영어 텍스트", "kr": "중국어 텍스트"}</code>.</li></ul> <h3 id="import"><a href="#import" class="header-anchor">#</a> Import </h3> <p>현재 생태계로 애플리케이션을 가져오고, <a href="#importupload">ImportUpload</a> 계약에서로드된 데이터를 가져옵니다.</p> <p>매개변수:</p> <ul><li><strong>Data</strong> string - 생태계에서 내보낸 파일에서 가져온 텍스트 형식의 데이터입니다.</li></ul> <h3 id="importupload"><a href="#importupload" class="header-anchor">#</a> ImportUpload </h3> <p>외부 애플리케이션 파일을 현재 생태계의 buffer_data 테이블로로드하여 후속 가져오기에 사용합니다.</p> <p>매개변수:</p> <ul><li><strong>InputFile</strong> file - 현재 생태계의 buffer_data 테이블에 기록된 파일입니다.</li></ul> <h3 id="newappparam"><a href="#newappparam" class="header-anchor">#</a> NewAppParam </h3> <p>현재 생태계에 새로운 애플리케이션 매개변수를 추가합니다.</p> <p>매개변수:</p> <ul><li><strong>ApplicationId</strong> int - 애플리케이션 ID;</li> <li><strong>Name</strong> string - 매개변수 이름;</li> <li><strong>Value</strong> string - 매개변수 값;</li> <li><strong>Conditions</strong> string - 매개변수를 변경할 수 있는 권한.</li></ul> <h3 id="editappparam"><a href="#editappparam" class="header-anchor">#</a> EditAppParam </h3> <p>현재 생태계에서 기존의 애플리케이션 매개변수를 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 애플리케이션 매개변수 ID;</li> <li><strong>Value</strong> string "optional" - 새로운 매개변수 값;</li> <li><strong>Conditions</strong> string "optional" - 매개변수를 변경할 권한.</li></ul> <h3 id="newdelayedcontract"><a href="#newdelayedcontract" class="header-anchor">#</a> NewDelayedContract </h3> <p>지연 계약 스케줄러 데몬에 새로운 작업을 추가합니다.</p> <p>지연된 계약 스케줄러는 현재 생성된 블록에서 필요한 계약을 실행합니다.</p> <p>매개변수:</p> <ul><li><strong>Contract</strong> string - 계약 이름;</li> <li><strong>EveryBlock</strong> int - 지정된 블록 수마다 계약이 실행됩니다;</li> <li><strong>Conditions</strong> string - 작업을 변경할 수 있는 권한;</li> <li><strong>BlockID</strong> int "optional" - 계약을 실행해야 하는 블록 ID입니다. 지정하지 않으면 "현재 블록 ID" + EveryBlock으로 자동 계산됩니다;</li> <li><strong>Limit</strong> int "optional" - 작업 실행의 최대 횟수입니다. 지정하지 않으면 작업은 무제한으로 실행됩니다.</li></ul> <h3 id="editdelayedcontract"><a href="#editdelayedcontract" class="header-anchor">#</a> EditDelayedContract </h3> <p>지연된 계약 스케줄러 데몬에서 작업을 변경합니다.</p> <p>매개변수:</p> <ul><li><strong>Id</strong> int - 작업 ID;</li> <li><strong>Contract</strong> string - 계약 이름;</li> <li><strong>EveryBlock</strong> int - 지정된 블록 수마다 계약이 실행됩니다;</li> <li><strong>Conditions</strong> string - 작업을 변경할 수 있는 권한;</li> <li><strong>BlockID</strong> int "optional" - 계약을 실행해야 하는 블록 ID입니다. 지정하지 않으면 "현재 블록 ID" + EveryBlock으로 자동 계산됩니다;</li> <li><strong>Limit</strong> int "optional" - 작업 실행의 최대 횟수입니다. 지정하지 않으면 작업은 무제한으로 실행됩니다.</li> <li><strong>Deleted</strong> int "optional" - 작업 전환. 값이 <code>1</code>인 경우 작업이 비활성화됩니다. 값이 <code>0</code>인 경우 작업이 활성화됩니다.</li></ul> <h3 id="uploadbinary"><a href="#uploadbinary" class="header-anchor">#</a> UploadBinary </h3> <p>X_binaries 테이블에 정적 파일을 추가하거나 덮어씁니다. HTTP API를 통해 계약을 호출할 때, 요청은 <code>multipart/form-data</code> 형식이어야 하며, DataMimeType 매개변수는 폼 데이터와 함께 사용됩니다.</p> <p>매개변수:</p> <ul><li><strong>Name</strong> string - 정적 파일의 이름;</li> <li><strong>Data</strong> bytes - 정적 파일의 내용;</li> <li><strong>DataMimeType</strong> string "optional" - mime-type 형식의 정적 파일;</li> <li><strong>ApplicationId</strong> int - X_binaries 테이블과 관련된 애플리케이션 ID입니다.</li></ul> <p>DataMimeType 매개변수를 전달하지 않으면 기본적으로 <code>application/octet-stream</code> 형식을 사용합니다.</p></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/IBAX-io/documentation/edit/master/docs/kr/topics/script.md" target="_blank" rel="noopener noreferrer">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">마지막 업데이트:</span> <span class="time">2023/7/6 18:59:03</span></div></footer> <div class="page-nav"><p class="inner"> <span class="next"><a href="/kr/topics/templates2.html"> 템플릿 언어 </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/117.838e7a16.js" defer></script> </body> </html>