mirror of
https://github.com/Zeal-Operating-System/ZealOS.git
synced 2024-12-29 00:36:32 +00:00
6b3fd2fecb
Update documentation/comments to rename addr, fun, var, stmt, blk, desc, reg, seg, ptr, dup, clus, val, and bttn, to address, function, variable, statement, block, description, register, segment, pointer, duplicate, cluster, value, and button, respectively.
131 lines
15 KiB
HTML
Executable file
131 lines
15 KiB
HTML
Executable file
<!DOCTYPE HTML>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html;charset=US-ASCII">
|
|
<meta name="generator" content="ZealOS V1.01">
|
|
<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;}
|
|
</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>
|
|
<a name="l2"></a>
|
|
<a name="l3"></a><format_arg> := </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>][<width>][</span><span class=cF2>.</span><span class=cF0><decimals>][<flags>][</span><span class=cF2>h</span><span class=cF0><aux_format_num>]<format_code>
|
|
<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>().
|
|
<a name="l6"></a>
|
|
<a name="l7"></a><flags>:
|
|
<a name="l8"></a>
|
|
<a name="l9"></a> </span><span class=cF2>'t'</span><span class=cF0> truncate to <width>.
|
|
<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>"\x24"</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>"%%"</span><span class=cF0>.
|
|
<a name="l13"></a>
|
|
<a name="l14"></a><aux_format_num>:
|
|
<a name="l15"></a>
|
|
<a name="l16"></a> For </span><span class=cF2>"%n"</span><span class=cF0>, </span><span class=cF2>"%d"</span><span class=cF0> or </span><span class=cF2>"%u"</span><span class=cF0>, the <aux_format_num> causes thousands mode. </span><span class=cF2>"%h?n"</span><span class=cF0> will pick a variable exponent multiples of three
|
|
<a name="l17"></a> unit, while </span><span class=cF2>"%h-3n"</span><span class=cF0> will display milli units or </span><span class=cF2>"%h6n"</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>"%n"</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>.
|
|
<a name="l19"></a>
|
|
<a name="l20"></a>For </span><span class=cF2>"%c"</span><span class=cF0> or </span><span class=cF2>"%C"</span><span class=cF0>, the <aux_format_num> repeats the char that many times.
|
|
<a name="l21"></a>
|
|
<a name="l22"></a><format_code>:
|
|
<a name="l23"></a>
|
|
<a name="l24"></a> </span><span class=cF2>"%n"</span><span class=cF0> floating point in engineering notation, exponents being multiples of three. If it has a <aux_format> code, it will
|
|
<a name="l25"></a> display scientific units letters.
|
|
<a name="l26"></a>
|
|
<a name="l27"></a> </span><span class=cF2>"%S"</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.
|
|
<a name="l28"></a>
|
|
<a name="l29"></a> </span><span class=cF2>"%C"</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.
|
|
<a name="l30"></a>
|
|
<a name="l31"></a> </span><span class=cF2>"%h25c",'\n';</span><span class=cF0> 25 new-lines.
|
|
<a name="l32"></a>
|
|
<a name="l33"></a> </span><span class=cF2>"%h*c",25,'\n';</span><span class=cF0> 25 new-lines.
|
|
<a name="l34"></a>
|
|
<a name="l35"></a> </span><span class=cF2>"%F"</span><span class=cF0> text file by filename.
|
|
<a name="l36"></a>
|
|
<a name="l37"></a> </span><span class=cF2>"%$F"</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.
|
|
<a name="l38"></a>
|
|
<a name="l39"></a> </span><span class=cF2>"%p"</span><span class=cF0> pointer.
|
|
<a name="l40"></a>
|
|
<a name="l41"></a> </span><span class=cF2>"%,p"</span><span class=cF0> pointer with no offset.
|
|
<a name="l42"></a>
|
|
<a name="l43"></a> </span><span class=cF2>"%P"</span><span class=cF0> link to pointer.
|
|
<a name="l44"></a>
|
|
<a name="l45"></a> </span><span class=cF2>"%,P"</span><span class=cF0> link to pointer with no offset.
|
|
<a name="l46"></a>
|
|
<a name="l47"></a> </span><span class=cF2>"%D"</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>.
|
|
<a name="l48"></a>
|
|
<a name="l49"></a> </span><span class=cF2>"%T"</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>.
|
|
<a name="l50"></a>
|
|
<a name="l51"></a> </span><span class=cF2>"%z"</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.
|
|
<a name="l52"></a>
|
|
<a name="l53"></a> </span><span class=cF2>"%Z"</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.
|
|
<a name="l54"></a>
|
|
<a name="l55"></a> </span><span class=cF2>"%Q"</span><span class=cF0> convert "\" to "\\" and quote to backslash quote. (For use in creating strs in strs.)
|
|
<a name="l56"></a>
|
|
<a name="l57"></a> </span><span class=cF2>"%q"</span><span class=cF0> rev a </span><span class=cF2>"%Q"</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>
|
|
<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
|
|
<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.
|
|
<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.
|
|
<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
|
|
<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>.
|
|
<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.
|
|
<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> block.
|
|
<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.
|
|
<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>.
|
|
<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.
|
|
<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.
|
|
<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.
|
|
<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.
|
|
<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#l235"><span class=cF4>RawPrint</span></a><span class=cF0>(I64 mS, U8 *format, ...) sends direct to screen memory, bypassing window manager.
|
|
<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.
|
|
<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
|
|
<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.
|
|
<a name="l101"></a>
|
|
<a name="l102"></a><blink>Note:</blink> Use </span><span class=cF2>Print("%s",src)</span><span class=cF0> if you need an unmodified string.
|
|
</span></pre></body>
|
|
</html>
|