{"id":1151,"date":"2013-03-25T19:00:36","date_gmt":"2013-03-25T19:00:36","guid":{"rendered":"https:\/\/clarionsharp.com\/blog\/?p=1151"},"modified":"2013-07-12T17:27:43","modified_gmt":"2013-07-12T17:27:43","slug":"changes-to-template-built-in-symbols-in-c9","status":"publish","type":"post","link":"https:\/\/clarionsharp.com\/blog\/changes-to-template-built-in-symbols-in-c9\/","title":{"rendered":"Changes to Template built-in symbols in C9"},"content":{"rendered":"<p>As part of the ongoing work and evolution of the Win32 AppGen, and based on numerous requests the following template symbols are now built-in (as opposed to defined at the template level):<\/p>\n<p><span style=\"color: #008000;\">%Parameters<\/span> &#8211; single, dependent from %Procedure<br \/>\nThe full list of a procedure&#8217;s formal parameters separated by commas and enclosed in parentheses unless empty<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterName<\/span> &#8211; multi,\u00a0 dependent from %Procedure<br \/>\nThe list of names of all formal parameters as entered in %Parameters symbols; if missing then the name of that parameter as in %Prototype symbol is returned; if that is missing too, an AppGen generated name is returned<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterOrigName<\/span> &#8211; single, dependent from %ProcedureParameterName<br \/>\nThe name of the parameter as entered in the %Prototype symbol<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterType<\/span> &#8211; single, dependent from %ProcedureParameterName<br \/>\nThe type of the parameter as entered in the %Prototype symbol (without the CONST keyword and square brackets for array types)<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterDefault<\/span> &#8211; single, dependent from %ProcedureParameterName<br \/>\nThe default value of parameters as entered in the %Prototype symbol<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterOmitted<\/span> &#8211; single, dependent from %ProcedureParameterName<br \/>\nReturns %True if the parameter is declared as omittable in the %Prototype symbol<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterByReference<\/span>\u00a0 &#8211; single, dependent from %ProcedureParameterName<br \/>\nReturns %True if the parameter&#8217;s type is declared with leading * in the %Prototype symbol<\/p>\n<p><span style=\"color: #008000;\">%ProcedureParameterConstant<\/span> &#8211; single, dependent from %ProcedureParameterName<br \/>\nReturns %True if the parameter&#8217;s type is declared with the CONST keyword in the %Prototype symbol<\/p>\n<p>And a new built-in symbol has been introduced into C9:<\/p>\n<p><span style=\"color: #008000;\">\u00a0%ProcedureParameterDIMs<\/span> &#8211; single, dependent from %ProcedureParameterName<br \/>\nReturns the number of dimensions if the parameter&#8217;s type is declared as an array in the %Prototype symbol (1 for [] , 2 for [,] , etc.)<\/p>\n<p>The updated Application Generator reads TXA files produced by earlier Clarion versions. TXA files produced by the C9 AppGen can&#8217;t be read by previous versions.<\/p>\n<p>These changes will be useful to all who write templates, but will benefit everyone and the visual change you&#8217;ll all immediately see is<\/p>\n<p><a href=\"https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2013\/03\/ProtoParam-C9.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-1152\" alt=\"ProtoParam-C9\" src=\"https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2013\/03\/ProtoParam-C9.png\" width=\"692\" height=\"467\" \/><\/a><\/p>\n<p style=\"text-align: center;\"><a title=\"version 8\" href=\"https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2013\/03\/ProtoParam-C8.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter  wp-image-1153\" alt=\"ProtoParam-C8\" src=\"https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2013\/03\/ProtoParam-C8.png\" width=\"740\" height=\"407\" srcset=\"https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2013\/03\/ProtoParam-C8.png 740w, https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2013\/03\/ProtoParam-C8-300x165.png 300w\" sizes=\"auto, (max-width: 740px) 100vw, 740px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>In C8 the Parameters entry field is located inside the Procedure&#8217;s Actions dialog, whereas in C9 they are now moved to the Procedure Properties main dialog.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>As part of the ongoing work and evolution of the Win32 AppGen, and based on numerous requests the following template symbols are now built-in (as opposed to defined at the template level): %Parameters &#8211; single, dependent from %Procedure The full list of a procedure&#8217;s formal parameters separated by commas and enclosed in parentheses unless empty &hellip; <a href=\"https:\/\/clarionsharp.com\/blog\/changes-to-template-built-in-symbols-in-c9\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Changes to Template built-in symbols in C9<\/span> <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[31,5],"tags":[],"class_list":["post-1151","post","type-post","status-publish","format-standard","hentry","category-clarion9","category-clarionnews"],"_links":{"self":[{"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/posts\/1151","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/comments?post=1151"}],"version-history":[{"count":9,"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/posts\/1151\/revisions"}],"predecessor-version":[{"id":1161,"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/posts\/1151\/revisions\/1161"}],"wp:attachment":[{"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/media?parent=1151"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/categories?post=1151"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clarionsharp.com\/blog\/wp-json\/wp\/v2\/tags?post=1151"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}