November 2000 Frame Page

<body stylesrc="index.html" background="images/Bkgrnd02T2.gif"> <table border="0" cellpadding="6" cellspacing="0" width="896"> <tr> <td align="right" valign="top" height="1" width="166"> <p align="center"><img border="0" src="images/Accent03.gif" align="left" width="142" height="37"> </p> <p align="left"><b><font size="2">November 2000 - Vol. 1 No. 11</font></b></p> </td> <td height="1" width="702"> <p align="center">  <a href="index.html" target="_top">[Home]</a> <a href="Newsletters.html" target="_top">[Up]</a> <a href="2000-12.html" target="_top">[Next]</a> <a href="2000-10.html" target="_top">[Previous]</a></td> </tr> <tr> <td valign="top" height="529" bgcolor="#FFFFCC" width="166"> <font size="2"> <p><a href="#TechTalk"><b>Tech Talk</b></a><br> <a href="#SeeTheErrors">See The Errors? (Part 2)</a> </p> <p><a href="#Editorial"><b>Editorial</b></a><br> <a href="#Election 2000">Election 2000</a><br> <a href="#C++ Standards Meeting">C++ Standards Meeting</a><br> </p> <p><a href="#CoolClasses"><b>Cool Classes</b></a><br> <a href="#Global Wrapper">Global Wrapper</a><br> </p> <p><a href="#Trends"><b>Trends</b></a><br> <a href="#Job Openings Trends">Job Openings Trends</a><br> <a href="#Language Demand Trend">Language Demand Trend</a></p></font> <p>  </td> <td height="277" bgcolor="#FFCC99" width="702"> <b> <h1><a name="TechTalk"><font color="#000000">Tech Talk</font></a></h1> <h2><font face="Arial" color="#000000"><a name="SeeTheErrors">See The Errors? (Part 2)</a></font></h2></b> <i><p>By <a href="Author-RegCharney.html">Reg Charney</a></p></i> <p>Last month, I published an article critiquing an MSDN sample. I also proposed a solution. After presenting a more expanded version of that article at our monthly ACCU meeting, Al Bauer, sent me this solution which I believe has a lot of value, so I have presented here. <i>[I have made some minor changes to fit this page format—Ed.]</p> </i> <p>“Here is my [<i>Al’s</i>] version of the sample program of the ACCU meeting of Oct. 10. I had some trouble finding enough include files to get all types defined; hence my own <b><font FACE="Courier New">ULONG </font></b>and using <b><font FACE="Courier New">char </font></b>instead of <b><font FACE="Courier New">TCHAR</font></b>.</p> <p>Generally, I have substituted declarations and data for algorithms.</p> <p>Feedback? Specifically, I was interested in your (Reg) comment that a nested <b><font FACE="Courier New">if</font> </b>(like mine) compiles to less efficient object code than using <b><font FACE="Courier New">goto</font></b><font FACE="Courier New">'s</font>.</p> <div align="center"> <center> <table border="0" width="531"> <tr> <td width="523" bgcolor="#FFFFFF"> <p class="MsoNormal" style="margin-right:-1.0in"><b><span style="font-size:10.0pt; font-family:"Courier New"">#include <stdlib.h><br> #include <stdio.h><br> #include "toolhelp.h"<br> #include <commdlg.h><br> <br> typedef unsigned long ULONG;<br> <br> BOOL OpenTheFile (void)<br> {<span style="mso-spacerun: yes"><br>   </span>typedef enum {ekOK, ekFDia, ekOpen, ekFSiz, ekFZro, ekGAlo, <br>                 ekRdFi, ekRdZr, ekProc} terrKind;<span style="mso-spacerun: yes"><br>   </span>typedef char* terrMsgs[ekProc+1];<span style="mso-spacerun: yes"><br>   </span>terrKind errKind = ekOK;<span style="mso-spacerun: yes"><br>   </span>static terrMsgs errMsgs = { "No Error", "File Not Fnd", <br>                               "Cant Open","Invalid FSize", <br>                               "File Empty", "Alloc Error", <span style="mso-spacerun: yes"><br>                               </span>"File Read Err", "No Bytes Read",<span style="mso-spacerun: yes"><br>                               </span>"Process Err" };<span style="mso-spacerun: yes"><br>   </span>HANDLE hFile = (HANDLE)-1;<span style="mso-spacerun: yes"><br>   </span>ULONG ulCount, ulFilSiz;<br> <span style="mso-spacerun: yes">  </span>OPENFILENAME Ofn;<span style="mso-spacerun: yes"><br>   </span>char szFile[MAX_PATH+1] = "\0";<span style="mso-spacerun: yes"><br>   </span>char *lpBuf = NULL;<br> <span style="mso-spacerun: yes">  </span>BOOL bRet = FALSE;</span></b></p> <p class="MsoNormal" style="margin-right:-1.0in"><b><span style="font-size:10.0pt; font-family:"Courier New""><span style="mso-spacerun: yes">  </span>if (!GetOpenFileName(&Ofn))<span style="mso-spacerun: yes">                 </span>errKind=ekFDia;<span style="mso-spacerun: yes"><br>   </span>else if ((hFile=CreateFile(…))==(HANDLE)-1) errKind=ekOpen;<span style="mso-spacerun: yes"><br>   </span>else if ((ulFilSiz=GetFileSize(...))==0xFF) errKind=ekFSiz;<br> <span style="mso-spacerun: yes">  </span>else if (ulFilSiz == 0)<span style="mso-spacerun: yes">                     </span>errKind=ekFZro;<span style="mso-spacerun: yes"><br>   </span>else if ((lpBuf=GlobalAlloc(...))==NULL)<span style="mso-spacerun: yes">    </span>errKind=ekGAlo;<span style="mso-spacerun: yes"><br>   </span>else if (!ReadFile(hFile, ..., &ulCount))<span style="mso-spacerun: yes">   </span>errKind=ekRdFi;<span style="mso-spacerun: yes"><br>   </span>else if (ulCount==0)<span style="mso-spacerun: yes">                        </span>errKind=ekRdZr;<span style="mso-spacerun: yes"><br>   </span>else if (!ProcessTheFile(lpBuf))<span style="mso-spacerun: yes">            </span>errKind=ekProc;</span></b></p> <p class="MsoNormal" style="margin-right:-1.0in"><b><span style="font-size:10.0pt; font-family:"Courier New""><span style="mso-spacerun: yes">  </span>if (lpBuf) GlobalFree(lpBuf);<span style="mso-spacerun: yes"><br>   </span>if (hFile!=(HANDLE)-1) CloseHandle(hFile);<br> <span style="mso-spacerun: yes">  </span>if (errKind!=ekOK) MessageBox(NULL, errMsgs[errKind]);<span style="mso-spacerun: yes"><br>      </span>else bRet = TRUE;</span></b></p> <p class="MsoNormal" style="margin-right:-1.0in"><b><span style="font-size:10.0pt; font-family:"Courier New""><span style="mso-spacerun: yes">  </span>return bRet;<br> }</span></b></p> <p align="center"><b><font face="Arial">Listing #1 - Alternate Solution</font></b></td> </tr> </table> </center> </div> <p>I replied to AL with these comments:</p> <p>“Hi Al,</p> <p>This is a very nice solution. It is one “level” above mine in that after analyzing the problem in total, it made imminent sense to rewrite it this way. I only see two potential problem areas. One, keeping the enums and error messages in sync; and two, what happens when more convoluted logic is needed at each stage.</p> <p>Consider this example case. Assume that we want to process files of zero size and do further extensive processing. That means that we need to bypass the allocation, ReadFile and subsequent (possibly redundant, as Brian Grimshaw mentioned) test, but execute the routine ProcessTheFile and the further extensive processing. My type of solution would have had an extra goto that branches to the if containing the invocation of ProcessTheFile. Your code would become something like that shown in Listing #2. Note the need to duplicate the “further processing” code.</p> <p>Alternatively, you could create a new function containing all the code in “extensive further processing” and invoke it in the two place where it is needed. While this solution could lead to a cleaner result, often creating a new function out of fragments of existing code is difficult because the old code assumes the availability of local data. This local data needs to be passed to any new function, often by reference or pointer.</p> <p>Still, your solution still stands up very well. Nicely done and thanks!”</p> <div align="center"> <center> <table border="0" width="498"> <tr> <td width="490" bgcolor="#FFFFFF"><b><span style="font-size:10.0pt;font-family:"Courier New"">if (!GetOpenFileName(&Ofn)) <span style="mso-spacerun: yes">                </span>errKind=ekFDia;<br> else if ((hFile=CreateFile(…))==(HANDLE)-1) errKind=ekOpen;<br> else if ((ulFileSize=GetFileSize(…))==0xFF) errKind=ekFSiz;<br> else if (ulFileSize == 0)<br> { // braces needed<br> <span style="mso-spacerun: yes">  </span>if (!ProcessTheFile(lpBuf)) <span style="mso-spacerun: yes">              </span>errKind=ekProc;<br> <span style="mso-spacerun: yes">  </span>else<br> <span style="mso-spacerun: yes">  </span>{<br> <span style="mso-spacerun: yes">    </span>// further extensive processing - duplicate of what<br> <span style="mso-spacerun: yes">    </span>// appears below<br> <span style="mso-spacerun: yes">  </span>}<br> }<br> else if ((lpBuf=GlobalAlloc(...))==NULL)    errKind=ekGAlo;<br> else if (!ReadFile(hFile,…,&ulBytesRead))   errKind=ekRdFi;<br> else if (ulBytesRead ==0)                   errKind=ekRdZr;<br> else if (!ProcessTheFile(lpBuf))            errKind=ekProc;<br> else<br> {<br> <span style="mso-spacerun: yes">  </span>// further extensive processing<br> }</span></b> <p align="center"><b><font face="Arial">Listing #2 - Response to Alternate Solution</font></b></td> </tr> </table> </center> </div> <p>And finally, Al’s reply:</p> <p>“Thanks for taking the time for dialog;</p> <p>The sync issue: Yes; this is error prone. You may guess I'm an old Pascal devotee'. The weaker C syntax checking lets you declare:</p> <blockquote> <b> <p><font FACE="Courier New">typedef char *tmsgs[4];<br> static tmsgs msgs={ "zero", "one" };</font></p> </blockquote> </b> <p>so <font FACE="Courier New">msgs[2] </font>and <font FACE="Courier New">msgs[3] </font>remain uninitialized. The mind reels.</p> <p>C/C++ must make up in discipline what the Pascal compiler helps you do. Nevertheless, a hack programmer can find ways around even Pascal. Sigh.</p> <p>More convoluted logic: Yes. The tough decision; do you write very loosely structured code that can be easily modified, to even much different design. the best structure to represent the current design, but risk painting yourself into a corner? - the moderate approach; probably best.</p> <p>Whether C, Pascal, or whatever, I was much impressed by Niklaus Wirth’s “Data Structures + Algorithms = Programs” I like to (as in this case) tailor the data (i.e. the error <font FACE="Courier New">msgs</font>) to simplify the logic. Generally I find the code is smaller and faster.</p> <p>Of course, the next step to many is OOP, and it truly does advance the cause started by “structured programming”. Oh, well, if I go much further, I'll be getting dangerously close to religion. I liked your “contract” approach. I came to about the same thing.</p> <blockquote> <p>Write function header comments.</p> <p>Carefully name the function;<br> - a void function is a verb describing what it does. (includes boolean returns denoting success/failure)<br> - a function returning a value is a noun describing the value returned. Mostly here I don't return values in pointer parms of value returning functions. I declare these pointer parms CONST.”</p> </blockquote> <p>3. Design the return value, parms for all data flows. i.e.: Write the function header (prototype) Avoid globals whenever possible.</p> <p>4. Now (LAST) code the function body. If you MUST "break" the contract, update the header comments IMMEDIATELY.</p> <p>I rewrote this example to correct for these errors. Can you see any other errors in this modified example.</p> <p>If I were writing this code from scratch, using OO techniques would simplify the code and reduce the chances of errors.</p> <b> <h1><font color="#000000"><a name="Editorial">Editorial</a></font></h1> </b> <i> <p>By <a href="Author-RegCharney.html">Reg. Charney</a></p> <b> <h2><font face="Arial"><a name="Election 2000">Election</a></font><a name="Election 2000"><font FACE="Arial" SIZE="2"> </font><font face="Arial">2000</font></a></h2> </b> </i> <font SIZE="2"> <p>We are very lucky here in the Valley. We probably have more money, opportunities and leading edge product development here than anywhere else in the world. Amidst these riches and abundance, we tend to forget how they came about and the debts we owe to those that came before. We also tend to assume that today’s successes were the direct result of our brilliance and hard work. A lot of that is true—but not all of it.</p> <p>Much of what we are doing here is the result of R&D and social programs started 20 or 30 years ago. The Internet, lasers/masers, and fiber optics, relational databases, Equal Employment Opportunity are some, just to name a few. More important, these projects were all originally government funded. Government funding tends to be long term and in the areas of pure research. Company funded R&D tends to be short term (driven by the quarter to quarter results) and more application specific. Without pure research, applied research is not possible and without eventual applications, the monies for long term research is not available. There needs to be a balance. As an editor and observer of the Valley, my concern is that with all the sound and fury during this election year, we are forgetting our foundations. Doing so puts our own and our children's future at risk. Please keep this in mind when you go out to vote this November 7.</p> </font><b><i> <h2><font face="Arial"><a name="C++ Standards Meeting">C++ Standards Meeting</a></font></h2> </i></b><font SIZE="2"> <p>I just returned from Toronto where the C++ Standards Committee was holding their semi-annual meeting.</p> <p>We are continuing to clarifying the more obscure corners of the language. Typical was making sure that the terms template function (a function) and function template (a template) are used consistently throughout the standard. We are also considering opening up the standards process to extensions, particularly in the library area.</p> </font> <b> <h1><font color="#000000"><a name="CoolClasses">Cool Classes</a></font></h1> </b><i> <p>By <a href="Author-RegCharney.html">Reg. Charney</a></p> <b> <h2><font face="Arial"><a name="Global Wrapper">Global Wrapper</a></font></h2> </b> </i> <p>We have all had occasion to use global variables. For example, in Windows programming, they are used extensively. However, they suffer from a number of major problems.</p> <blockquote> <p>They pollute the namespace—it is easy to accidentally have two variables with the same name in different translation units communicate with each other at run-time because the linker thought they were the same variable.</p> <p>Within the same module, local variables can accidentally hide global variables, or global variables can be used when really a local variable by the same name was omitted by accident.</p> <p>Lastly, a change in one part of the program can effect another part of the program unexpectedly when the programmer does not realize that the variable is shared by other routines.</p> </blockquote> <p>First, we need to recognize that there is always at least one global: <b><font FACE="Courier New">main() </font></b>or one of its variants in every program. There are also other globals if you use namespaces—their namespace names. The main idea is avoid possible name clashes. I am going to present three ways of dealing with globals.</p> <blockquote> <p>The old way—define all global variables individually at file scope.</p> <p>Enclose globals inside a namespace, like the standard library does with namespace <b><font FACE="Courier New">std</font></b>.</p> <p>Enclose all variables to be used as globals inside a class definition that is instantiated at global scope.</p> </blockquote> <p>Listing #3 shows these three methods.</p> <p>Method 1 has no saving graces. It just happens to be the most common method.</p> <p>Method 2 reduces the namespace pollution problem to adding just one name. It also has the added advantage that it can be extended without recompiling preexisting modules.</p> <p>Method 3 has scope, compile-time access control and potentially runtime control. It can also be used with the other two methods. Its main disadvantage is that you must remember to instantiate the class at the appropriate place.</p> <p>Please note that a namespace is not a scope or storage type. It is simply a name qualification scheme.</p> <div align="center"> <center> <table border="0" width="428"> <tr> <td bgcolor="#FFFFFF" width="420" align="left"> <b> <p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Courier New"">struct X { int i; };</span></p> <p><span style="font-size:10.0pt;font-family:"Courier New"">// Method 1 - global scope<br> int v1;<br> X x1;<br> void f1(void)<br> {<br> <span style="mso-spacerun: yes">  </span>v1 = 1; <span style="mso-spacerun: yes">  </span>// ::v1<br> <span style="mso-spacerun: yes">  </span>x1.i = 1; // ::x1.i<br> }</span></p> <p><span style="font-size:10.0pt;font-family:"Courier New"">// Method 2 - namespace<br> namespace MyGlobalNS<br> {<br> <span style="mso-spacerun: yes">  </span>int v2;<br> <span style="mso-spacerun: yes">  </span>X x2;<br> }<br> namespace mgn = MyGlobalNS;<br> void f2a(void) // qualified<br> {<br> <span style="mso-spacerun: yes">  </span>mgn::v2 = 1;<br> <span style="mso-spacerun: yes">  </span>mgn::x2.i = 2;<br> }<br> using namespace mgn;<br> void f2b(void)<br> {<br> <span style="mso-spacerun: yes">  </span>v2 = 1; // mgn::v2<br> <span style="mso-spacerun: yes">  </span>x2.i = 2; // mgn::x2.I<br> }</span></p> <p><span style="font-size:10.0pt;font-family:"Courier New"">// Method 3 - global class<br> struct MyGlobalClass<br> {<br> <span style="mso-spacerun: yes">  </span>int v3;<br> <span style="mso-spacerun: yes">  </span>X x3;<br> };<br> MyGlobalClass mgc;<br> void main(void)<br> {<br> <span style="mso-spacerun: yes">  </span>mgc.v3 = 1;<br> <span style="mso-spacerun: yes">  </span>mgc.x3.i = 3;<br> }</span></p> <p align="center"><font face="Arial">Listing #3 - Global Methods</font></b> </td> </tr> </table> </center> </div> <b> <i> <h1><font color="#000000"><a name="Trends">Trends</a></font></h1> </i> </b><i> <p>By <a href="Author-RegCharney.html">Reg. Charney</a></p> <b> <h2><font FACE="Arial"><a name="Job Openings Trends">Job Openings Trends</a></font></h2> </b> </i> <p>Last month, you may have noticed that there was a slight up-tick in the number of Software Engineering jobs in demand, particularly here in the Valley. This month proves that that was no fluke. There is still a continued demand for both IT skills in general and software engineering in particular. However, it does look like it is leveling off. The demand now for software engineers appears to be increasing at the same rate as for all IT positions.</p> <p align="center"><img border="0" src="images/2000-11-Fig01.gif" width="702" height="438"></p> <p>(Note: Chart #1 is normalized for the number of jobs in January of this year. That is, the number of openings in January 2000 has been taken as 1.00.)</p> <b><i> <h2><font FACE="Arial"><a name="Language Demand Trend">Language Demand Trend</a></font></h2> </i></b> <p>The demand for all the major computer languages have shown an interesting set of trends since the start of this year. Chart #2 shows the demand for today’s most popular computer languages. The demand peaked in the April-May time frame when demand overall for language skills was at its highest. Since then, demand for language skills has decline until last month when things turned around. Demand for the Internet related languages, XML and Perl have increased while the demand for Java and C/C++ has leveled off. My conclusion is that the desire to connect systems together using shared data definitions and universal scripting languages like Perl is driving this demand. Visual Basic is the anomaly. Demand for it increased, probably because of new prototyping being done.</p> <p align="center"><img border="0" src="images/2000-11-Fig02.gif" width="472" height="313"></p> </td> </tr> </table> </body>