<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://brwiki2.brulescorp.com/brwiki2/index.php?action=history&amp;feed=atom&amp;title=FnSnap%3A_Miscellaneous_Functions</id>
	<title>FnSnap: Miscellaneous Functions - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://brwiki2.brulescorp.com/brwiki2/index.php?action=history&amp;feed=atom&amp;title=FnSnap%3A_Miscellaneous_Functions"/>
	<link rel="alternate" type="text/html" href="https://brwiki2.brulescorp.com/brwiki2/index.php?title=FnSnap:_Miscellaneous_Functions&amp;action=history"/>
	<updated>2026-06-14T03:08:40Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.41.0</generator>
	<entry>
		<id>https://brwiki2.brulescorp.com/brwiki2/index.php?title=FnSnap:_Miscellaneous_Functions&amp;diff=5322&amp;oldid=prev</id>
		<title>Laura: 1 revision</title>
		<link rel="alternate" type="text/html" href="https://brwiki2.brulescorp.com/brwiki2/index.php?title=FnSnap:_Miscellaneous_Functions&amp;diff=5322&amp;oldid=prev"/>
		<updated>2013-07-11T17:09:05Z</updated>

		<summary type="html">&lt;p&gt;1 revision&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;==Email==&lt;br /&gt;
===FNEMAIL - creates an email file for email monitor===&lt;br /&gt;
&lt;br /&gt;
Creates an email file for [[EMAILMONITOR]]&lt;br /&gt;
&lt;br /&gt;
 FNEMAIL(SENDDIR$*80,MAILFROM$*50,SUBJECT$*100,MAT MAILTO$,MAT MESSAGE$;MAT ATTACH$,SMAILQ$*80)&lt;br /&gt;
&lt;br /&gt;
Functions used |&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;SENDDIR$&amp;#039;&amp;#039;&amp;#039;||directory where message will be created&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAILFROM$ sender&amp;#039;s email address&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;SUBJECT$&amp;#039;&amp;#039;&amp;#039;||subject line of email&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAT MAILTO$&amp;#039;&amp;#039;&amp;#039;||email addresses of recipients&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAT MESSAGE$&amp;#039;&amp;#039;&amp;#039;||email text in the form of a matrix&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAT ATTACH$&amp;#039;&amp;#039;&amp;#039;||matrix containing full path and name of any attachments&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&lt;br /&gt;
&lt;br /&gt;
EMAILMONITOR is available through David Blankenship&lt;br /&gt;
&lt;br /&gt;
===FNEMAILFILE - inserts a text file into an email for email monitor===&lt;br /&gt;
&lt;br /&gt;
Inserts a text file into an email for [[EMAILBLASTER]]&lt;br /&gt;
&lt;br /&gt;
 FNEMAILFILE(SENDDIR$*80,MAILFROM$*50,SUBJECT$*100,MAT MAILTO$,TEXTFILE$*100;MAT ATTACH$,SMAILQ$*80)&lt;br /&gt;
&lt;br /&gt;
Functions used |&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;SENDDIR$&amp;#039;&amp;#039;&amp;#039;||directory where message will be created&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAILFROM$&amp;#039;&amp;#039;&amp;#039;||sender&amp;#039;s email address&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;SUBJECT$&amp;#039;&amp;#039;&amp;#039;||subject line of email&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAT MAILTO$&amp;#039;&amp;#039;&amp;#039;||email addresses of recipients&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAT MESSAGE$&amp;#039;&amp;#039;&amp;#039;||email text in the form of a matrix&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;TEXTFILE$&amp;#039;&amp;#039;&amp;#039;||name of file containing email message&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;MAT ATTACH$&amp;#039;&amp;#039;&amp;#039;||matrix containing full path and name of any attachments&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&lt;br /&gt;
&lt;br /&gt;
==Formatting==&lt;br /&gt;
===FNLEADZERO$ - obsolete replace with CNVRT$(&amp;quot;PIC(###)&amp;quot;,x)===&lt;br /&gt;
&lt;br /&gt;
Converts a number to a string and fills the leading positions with &amp;quot;0&amp;quot;&amp;#039;s.&lt;br /&gt;
&lt;br /&gt;
 FNLEADZERO$(NUMBER,LENGTH)&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;NUMBER &amp;#039;&amp;#039;&amp;#039;||The number to be converted&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;LENGTH &amp;#039;&amp;#039;&amp;#039;||The length of the resulting field&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&amp;lt;br&amp;gt;&lt;br /&gt;
Easier done with the CNVRT$(&amp;quot;PIC(#####)&amp;quot;,number) function.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===FNCHECKAMOUNT$ - returns English words for a dollar amount===&lt;br /&gt;
&lt;br /&gt;
Converts a number into a string of English words formatted with the words Dollars and Cents.  Optionally allows the returned string to be left padded with tilde symbols.&lt;br /&gt;
&lt;br /&gt;
 FNCHECKAMOUNT$(AMOUNT;LENGTH,OPT)&lt;br /&gt;
&lt;br /&gt;
;Functions used:&amp;lt;br&amp;gt;&lt;br /&gt;
The routine uses a local function to convert each three number (hundreds, thousands, millions) into words for the final result.&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;AMOUNT &amp;#039;&amp;#039;&amp;#039;||The number to be converted. This will be truncated to two decimal places.  Maximum number is 999,999,999.99.  A zero or negative number will return the word VOID.&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;LENGTH &amp;#039;&amp;#039;&amp;#039;||An optional prameter.  If used and greater than 10 the result will be left padded with tilde symbols to the size specified.  If the result is &amp;quot;V O I D&amp;quot; the word VOID will be centered in the padded tildes.&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;OPT &amp;#039;&amp;#039;&amp;#039;||An option parameter to determne whether the words DOLLARS and CENTS are included in the output string. 0 will include these words, 1 will transform the cents to a fraction and include it prior to the final word dollars. 2 will transform the cents to a fraction and append it to the output string, but with no &amp;quot;Dollars&amp;quot; included so that the string can be added to a preprinted check.&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&amp;lt;br&amp;gt;&lt;br /&gt;
Designed to be used as check protection verbiage on computer printed checks.  Can als be used as a screen response description.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
==Progress==&lt;br /&gt;
===FNPROG - displays a progress bar for a process===&lt;br /&gt;
&lt;br /&gt;
Displays a vertical progress bar that changes color form green to yellow to red as the process approaches 100%&lt;br /&gt;
&lt;br /&gt;
 FNPROG(PROW,PCOL,PCUR,PTOT)&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PROW &amp;#039;&amp;#039;&amp;#039;||Upper left row corner of display&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PCOL &amp;#039;&amp;#039;&amp;#039;||Upper left column corner of display&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PCUR &amp;#039;&amp;#039;&amp;#039;||Current record number&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PTOT &amp;#039;&amp;#039;&amp;#039;||Total record numbers when project is complete&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&amp;lt;br&amp;gt;&lt;br /&gt;
If reading a file the file needs to be restored after obtaining the last record number&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===FNPROGRESS - displays a progress bar for a process===&lt;br /&gt;
&lt;br /&gt;
Similar to FNPROG&lt;br /&gt;
&lt;br /&gt;
 FNPROGRESS(&amp;amp;PCT_WINDEV,PCT_TOTAL,PCT_DONE;SR$,CAPTION$*55)&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PCT_WINDEV &amp;#039;&amp;#039;&amp;#039;||&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PCT_TOTAL &amp;#039;&amp;#039;&amp;#039;||Total number of transactions to complete....&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;PCT_DONE &amp;#039;&amp;#039;&amp;#039;||Number of transactions completed&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;SR$ &amp;#039;&amp;#039;&amp;#039;||Starting row for display&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;CAPTION$ &amp;#039;&amp;#039;&amp;#039;||Optional window caption&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
==Other==&lt;br /&gt;
===FNCLKBUF - clears the keyboard buffer of extra key strokes===&lt;br /&gt;
&lt;br /&gt;
Clears the keyboard buffer&lt;br /&gt;
&lt;br /&gt;
 FNCLKBUF&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;None &amp;#039;&amp;#039;&amp;#039;||&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===FNCURDRV$ - returns the current drive and directory===&lt;br /&gt;
&lt;br /&gt;
Returns the current drive and directory&lt;br /&gt;
&lt;br /&gt;
 FNCURDRV$&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;NONE&amp;#039;&amp;#039;&amp;#039;||&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===FNMSEXE$ - return the installed location of a Microsoft compliant program installation===&lt;br /&gt;
&lt;br /&gt;
Uses [[David Blankenship]]&amp;#039;s [[BRREGISTER2.exe]] to query the [[registry]] for the installed location of registered software&lt;br /&gt;
&lt;br /&gt;
 FNMSEXE$(L$)&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;L$ &amp;#039;&amp;#039;&amp;#039;||executable name as registered in the registry.&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&amp;lt;br&amp;gt;&lt;br /&gt;
Will find the location of WINWORD.EXE, EXCEL.EXE or any other executable that i properly registered&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===FNX$ - returns X if true BLANK if false===&lt;br /&gt;
&lt;br /&gt;
Returns an &amp;quot;X&amp;quot; if L is true or &amp;quot; &amp;quot; if L is false.&lt;br /&gt;
&lt;br /&gt;
 FNX$(L)&lt;br /&gt;
&lt;br /&gt;
;Functions used:&lt;br /&gt;
&lt;br /&gt;
;Variables:&lt;br /&gt;
{|&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|width=&amp;quot;10%&amp;quot;|&amp;#039;&amp;#039;&amp;#039;None&lt;br /&gt;
|-valign=&amp;quot;top&amp;quot;&lt;br /&gt;
|}&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
;Comments:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Category:FnSnap]]&lt;/div&gt;</summary>
		<author><name>Laura</name></author>
	</entry>
</feed>