ZealOS/docs/Doc/Print.DD.html

132 lines
15 KiB
HTML
Raw Normal View History

2021-07-03 05:07:57 +01:00
<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=US-ASCII">
<meta name="generator" content="ZealOS V0.12">
2021-07-03 05:07:57 +01:00
<style type="text/css">
body {background-color:#fef1f0;}
.cF0{color:#000000;background-color:#fef1f0;}
.cF1{color:#0148a4;background-color:#fef1f0;}
.cF2{color:#3b7901;background-color:#fef1f0;}
.cF3{color:#057c7e;background-color:#fef1f0;}
.cF4{color:#bb2020;background-color:#fef1f0;}
.cF5{color:#9e42ae;background-color:#fef1f0;}
.cF6{color:#b57901;background-color:#fef1f0;}
.cF7{color:#b2b6af;background-color:#fef1f0;}
.cF8{color:#555753;background-color:#fef1f0;}
.cF9{color:#678fbb;background-color:#fef1f0;}
.cFA{color:#82bc49;background-color:#fef1f0;}
.cFB{color:#0097a2;background-color:#fef1f0;}
.cFC{color:#e26a6a;background-color:#fef1f0;}
.cFD{color:#c671bc;background-color:#fef1f0;}
.cFE{color:#c7ab00;background-color:#fef1f0;}
.cFF{color:#fef1f0;background-color:#fef1f0;}
2021-07-03 05:07:57 +01:00
</style>
</head>
<body>
<pre style="font-family:monospace;font-size:12pt">
<a name="l1"></a><span class=cF5> Print Format Strs</span><span class=cF0>
2021-07-03 05:07:57 +01:00
<a name="l2"></a>
<a name="l3"></a>&lt;format_arg&gt; := </span><span class=cF2>%</span><span class=cF0>[</span><span class=cF2>-</span><span class=cF0>][</span><span class=cF2>0</span><span class=cF0>][&lt;width&gt;][</span><span class=cF2>.</span><span class=cF0>&lt;decimals&gt;][&lt;flags&gt;][</span><span class=cF2>h</span><span class=cF0>&lt;aux_format_num&gt;]&lt;format_code&gt;
<a name="l4"></a>
<a name="l5"></a>See </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/StrPrint.CC.html#l249"><span class=cF4>StrPrintJoin</span></a><span class=cF0>().
2021-07-03 05:07:57 +01:00
<a name="l6"></a>
<a name="l7"></a>&lt;flags&gt;:
<a name="l8"></a>
<a name="l9"></a> </span><span class=cF2>'t'</span><span class=cF0> truncate to &lt;width&gt;.
<a name="l10"></a> </span><span class=cF2>','</span><span class=cF0> add commas every three digits or four nibbles.
<a name="l11"></a> </span><span class=cF2>'$'</span><span class=cF0> makes </span><span class=cF2>%Q</span><span class=cF0> convert </span><span class=cF2>'$'</span><span class=cF0> to </span><span class=cF2>&quot;\x24&quot;</span><span class=cF0>.
<a name="l12"></a> </span><span class=cF2>'/'</span><span class=cF0> makes </span><span class=cF2>%Q</span><span class=cF0> and </span><span class=cF2>%q</span><span class=cF0> convert </span><span class=cF2>'%'</span><span class=cF0> to </span><span class=cF2>&quot;%%&quot;</span><span class=cF0>.
<a name="l13"></a>
<a name="l14"></a>&lt;aux_format_num&gt;:
<a name="l15"></a>
<a name="l16"></a> For </span><span class=cF2>&quot;%n&quot;</span><span class=cF0>, </span><span class=cF2>&quot;%d&quot;</span><span class=cF0> or </span><span class=cF2>&quot;%u&quot;</span><span class=cF0>, the &lt;aux_format_num&gt; causes thousands mode. </span><span class=cF2>&quot;%h?n&quot;</span><span class=cF0> will pick a var exponent multiples of three
<a name="l17"></a> unit, while </span><span class=cF2>&quot;%h-3n&quot;</span><span class=cF0> will display milli units or </span><span class=cF2>&quot;%h6n&quot;</span><span class=cF0> will display mega units. The </span><span class=cF2>'k'</span><span class=cF0> flag is always on for </span><span class=cF2>&quot;%n&quot;</span><span class=cF0>. See </span><span class=cF4>
<a name="l18"></a> </span><a href="https://zeal-operating-system.github.io/ZealOS/Demo/Print.CC.html#l1"><span class=cF4>::/Demo/Print.CC</span></a><span class=cF0>.
2021-07-03 05:07:57 +01:00
<a name="l19"></a>
<a name="l20"></a>For </span><span class=cF2>&quot;%c&quot;</span><span class=cF0> or </span><span class=cF2>&quot;%C&quot;</span><span class=cF0>, the &lt;aux_format_num&gt; repeats the char that many times.
<a name="l21"></a>
<a name="l22"></a>&lt;format_code&gt;:
<a name="l23"></a>
<a name="l24"></a> </span><span class=cF2>&quot;%n&quot;</span><span class=cF0> floating point in engineering notation, exponents being multiples of three. If it has a &lt;aux_format&gt; code, it will
2021-07-03 05:07:57 +01:00
<a name="l25"></a> display scientific units letters.
<a name="l26"></a>
<a name="l27"></a> </span><span class=cF2>&quot;%S&quot;</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KDefine.CC.html#l57"><span class=cF4>Define</span></a><span class=cF0>() entry.
2021-07-03 05:07:57 +01:00
<a name="l28"></a>
<a name="l29"></a> </span><span class=cF2>&quot;%C&quot;</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KernelB.HH.html#l42"><span class=cF4>ToUpper</span></a><span class=cF0>() character.
2021-07-03 05:07:57 +01:00
<a name="l30"></a>
<a name="l31"></a> </span><span class=cF2>&quot;%h25c&quot;,'\n';</span><span class=cF0> 25 new-lines.
<a name="l32"></a>
<a name="l33"></a> </span><span class=cF2>&quot;%h*c&quot;,25,'\n';</span><span class=cF0> 25 new-lines.
<a name="l34"></a>
<a name="l35"></a> </span><span class=cF2>&quot;%F&quot;</span><span class=cF0> text file by filename.
<a name="l36"></a>
<a name="l37"></a> </span><span class=cF2>&quot;%$F&quot;</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/DolDocOverview.DD.html#l1"><span class=cF4>DolDoc</span></a><span class=cF0> file in memory.
2021-07-03 05:07:57 +01:00
<a name="l38"></a>
<a name="l39"></a> </span><span class=cF2>&quot;%p&quot;</span><span class=cF0> ptr.
<a name="l40"></a>
<a name="l41"></a> </span><span class=cF2>&quot;%,p&quot;</span><span class=cF0> ptr with no offset.
<a name="l42"></a>
<a name="l43"></a> </span><span class=cF2>&quot;%P&quot;</span><span class=cF0> link to ptr.
<a name="l44"></a>
<a name="l45"></a> </span><span class=cF2>&quot;%,P&quot;</span><span class=cF0> link to ptr with no offset.
<a name="l46"></a>
<a name="l47"></a> </span><span class=cF2>&quot;%D&quot;</span><span class=cF0> date. Pass a </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KernelA.HH.html#l209"><span class=cF4>CDate</span></a><span class=cF0>.
2021-07-03 05:07:57 +01:00
<a name="l48"></a>
<a name="l49"></a> </span><span class=cF2>&quot;%T&quot;</span><span class=cF0> time. Pass a </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KernelA.HH.html#l209"><span class=cF4>CDate</span></a><span class=cF0>.
2021-07-03 05:07:57 +01:00
<a name="l50"></a>
<a name="l51"></a> </span><span class=cF2>&quot;%z&quot;</span><span class=cF0> sub_entry of an enumerated list of text entries. See </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/StrA.CC.html#l377"><span class=cF4>ListSub</span></a><span class=cF0>(). Pass sub_entry_num first, list second.
2021-07-03 05:07:57 +01:00
<a name="l52"></a>
<a name="l53"></a> </span><span class=cF2>&quot;%Z&quot;</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KDefine.CC.html#l16"><span class=cF4>DefineListLoad</span></a><span class=cF0>() subentry. Pass sub_entry_num first, define_name second.
2021-07-03 05:07:57 +01:00
<a name="l54"></a>
<a name="l55"></a> </span><span class=cF2>&quot;%Q&quot;</span><span class=cF0> convert &quot;\&quot; to &quot;\\&quot; and quote to backslash quote. (For use in creating strs in strs.)
<a name="l56"></a>
<a name="l57"></a> </span><span class=cF2>&quot;%q&quot;</span><span class=cF0> rev a </span><span class=cF2>&quot;%Q&quot;</span><span class=cF0>.
<a name="l58"></a>
<a name="l59"></a>
<a name="l60"></a></span><span class=cF5> Print Family</span><span class=cF0>
2021-07-03 05:07:57 +01:00
<a name="l61"></a></span><span class=cF4>
<a name="l62"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/StrPrint.CC.html#l1119"><span class=cF4>MStrPrint</span></a><span class=cF0>(U8 *format, ...) is like </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/StrPrint.CC.html#l1094"><span class=cF4>StrPrint</span></a><span class=cF0>(U8 *dst,U8 *format,...) but it returns a </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Memory/MAllocFree.CC.html#l391"><span class=cF4>MAlloc</span></a><span class=cF0>ated str. It is vary handy because
2021-07-03 05:07:57 +01:00
<a name="l63"></a>you don't have to worry about overflow.
<a name="l64"></a></span><span class=cF4>
<a name="l65"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/StrPrint.CC.html#l1099"><span class=cF4>CatPrint</span></a><span class=cF0>(U8 *_dst, U8 *format, ...) concatenates a formated string.
2021-07-03 05:07:57 +01:00
<a name="l66"></a></span><span class=cF4>
<a name="l67"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l580"><span class=cF4>In</span></a><span class=cF0>(U8 *format, ...) sends text to the current task's input buffer.</span><span class=cF4>
<a name="l68"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l561"><span class=cF4>InStr</span></a><span class=cF0>(U8 *format, ...) sends text of an </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Glossary.DD.html#l220"><span class=cF4>InFile</span></a><span class=cF0> to the keyboard stream of the current TASK but can also do mouse cmds.
2021-07-03 05:07:57 +01:00
<a name="l69"></a></span><span class=cF4>
<a name="l70"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l542"><span class=cF4>XTalk</span></a><span class=cF0>(CTask *task, U8 *format, ...) and text to another task's input buffer.</span><span class=cF4>
<a name="l71"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l588"><span class=cF4>XTalkStr</span></a><span class=cF0>(CTask *task, U8 *format, ...) sends text of an </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Glossary.DD.html#l220"><span class=cF4>InFile</span></a><span class=cF0> to the keyboard stream of another TASK but can also do mouse
2021-07-03 05:07:57 +01:00
<a name="l72"></a>cmds.
<a name="l73"></a></span><span class=cF4>
<a name="l74"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/DolDoc/DocPutS.CC.html#l164"><span class=cF4>DocPrint</span></a><span class=cF0>(CDoc *doc, U8 *format, ...) sends text to a document. You can buffer to a Doc and save it, providing the
<a name="l75"></a>functionality of </span><span class=cF2>fprintf</span><span class=cF0>. See </span><a href="https://zeal-operating-system.github.io/ZealOS/Demo/Disk/FPrintF.CC.html#l1"><span class=cF4>::/Demo/Disk/FPrintF.CC</span></a><span class=cF0>.
2021-07-03 05:07:57 +01:00
<a name="l76"></a></span><span class=cF4>
<a name="l77"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l485"><span class=cF4>Sys</span></a><span class=cF0>(U8 *format, ...) sends text to the </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Glossary.DD.html#l154"><span class=cF4>System Task</span></a><span class=cF0> to be compiled and run.</span><span class=cF4>
<a name="l78"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l507"><span class=cF4>SysLog</span></a><span class=cF0>(U8 *format, ...) and </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l530"><span class=cF4>SysErr</span></a><span class=cF0>(U8 *format,...) send text to the </span><a href="https://zeal-operating-system.github.io/ZealOS/Doc/Glossary.DD.html#l154"><span class=cF4>System Task</span></a><span class=cF0> to be displayed.
2021-07-03 05:07:57 +01:00
<a name="l79"></a></span><span class=cF4>
<a name="l80"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Compiler/CMisc.CC.html#l71"><span class=cF4>StreamPrint</span></a><span class=cF0>(U8 *format, ...) sends text to the stream of code being compiled and must reside in a </span><span class=cF2>#exe{}</span><span class=cF0> blk.
2021-07-03 05:07:57 +01:00
<a name="l81"></a></span><span class=cF4>
<a name="l82"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/Gr/GrBitMap.CC.html#l1194"><span class=cF4>GrPrint</span></a><span class=cF0>(CDC *dc, I64 x, I64 y, U8 *format,...) and </span><a href="https://zeal-operating-system.github.io/ZealOS/System/Gr/GrBitMap.CC.html#l1205"><span class=cF4>GrVPrint</span></a><span class=cF0>() plots text in graphics mode.
2021-07-03 05:07:57 +01:00
<a name="l83"></a></span><span class=cF4>
<a name="l84"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/Gr/GrTextBase.CC.html#l324"><span class=cF4>TextPrint</span></a><span class=cF0>(CTask *task, I64 x, I64 y, I64 attr, U8 *format, ...) plots to </span><span class=cF4><u>gr.text_base</u></span><span class=cF0>.
2021-07-03 05:07:57 +01:00
<a name="l85"></a></span><span class=cF4>
<a name="l86"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Compiler/CMain.CC.html#l700"><span class=cF4>ExePrint</span></a><span class=cF0>(U8 *format, ...) compiles and execute a string. Note: It returns the res of the last executed expression.
2021-07-03 05:07:57 +01:00
<a name="l87"></a></span><span class=cF4>
<a name="l88"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/Registry.CC.html#l168"><span class=cF4>Once</span></a><span class=cF0>(U8 *format, ...) Writes User code to </span><a href="https://zeal-operating-system.github.io/ZealOS/Home/Registry.CC.html#l1"><span class=cF4>Registry</span></a><span class=cF0> to be executed next boot.
2021-07-03 05:07:57 +01:00
<a name="l89"></a></span><span class=cF4>
<a name="l90"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/Registry.CC.html#l158"><span class=cF4>SysOnce</span></a><span class=cF0>(U8 *format, ...) Writes System code to </span><a href="https://zeal-operating-system.github.io/ZealOS/Home/Registry.CC.html#l1"><span class=cF4>Registry</span></a><span class=cF0> to be executed next boot.
2021-07-03 05:07:57 +01:00
<a name="l91"></a></span><span class=cF4>
<a name="l92"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/InFile.CC.html#l32"><span class=cF4>InPrint</span></a><span class=cF0>(I64 mS, U8 *format, ...) </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KeyDev.CC.html#l23"><span class=cF4>PutChars</span></a><span class=cF0>()s one at a time with a delay.
2021-07-03 05:07:57 +01:00
<a name="l93"></a></span><span class=cF4>
<a name="l94"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KDebug.CC.html#l232"><span class=cF4>RawPrint</span></a><span class=cF0>(I64 mS, U8 *format, ...) sends direct to screen memory, bypassing window manager.
2021-07-03 05:07:57 +01:00
<a name="l95"></a></span><span class=cF4>
<a name="l96"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KTask.CC.html#l475"><span class=cF4>User</span></a><span class=cF0>(U8 *format, ...) Spawns a user and execute a string on start-up.
2021-07-03 05:07:57 +01:00
<a name="l97"></a></span><span class=cF4>
<a name="l98"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.CC.html#l475"><span class=cF4>PopUpPrint</span></a><span class=cF0>(U8 *format, ...) compiles and execute a string in a pop-up win. Note: It returns the res of the last executed
2021-07-03 05:07:57 +01:00
<a name="l99"></a>expression.</span><span class=cF4>
<a name="l100"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/System/DolDoc/DocPopUp.CC.html#l13"><span class=cF4>PopUpViewPrint</span></a><span class=cF0>(U8 *format, ...) creates a pop-up window and views text.
2021-07-03 05:07:57 +01:00
<a name="l101"></a>
<a name="l102"></a><blink>Note:</blink> Use </span><span class=cF2>Print(&quot;%s&quot;,src)</span><span class=cF0> if you need an unmodified string.
</span></pre></body>
</html>