home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / tvision / tfield / readme.tfd next >
Encoding:
Text File  |  1992-03-25  |  4.4 KB  |  91 lines

  1. Release 1.1.1 notes.
  2.  
  3. This release fixes several memory leaks in the TDate and TDateField functions. 
  4. Care should be taken when calling TDate::formatDate because it allocate newStr
  5. storage for the pointer it returns.  Using a call like: sprintf( buf, "The date
  6. is: %s", mydate.formatDate(MDY) ) will cause a memory leak since the string
  7. storage is never deleted.  Instead use a call like: sprintf( buf, "The date is:
  8. %s", char *temp = mydate.formatDate(MDY) ); delete(temp);  this should avoid the
  9. problem.  I'm considering implementing another format function to return a
  10. pointer to a static string storage area.  Any comments on this are welcomed.
  11.  
  12. Thanks to Elliott Jackson (CIS 72311,3616) for his recommendations fixing a
  13. potential memory leak in the TDate + and - operators.
  14.  
  15. Several people pointed out a bug in the TField classes when several routines 
  16. set the terminating null on the data string with code like the
  17. following: data[maxLen + 1] = EOS;  This has been corrected to read:
  18. data[maxLen] = EOS.  This may still look like a bug to some, but remember data 
  19. was initialized as data[aMaxLen] and maxLen was initialized to aMaxLen - 1.  
  20. The maxLen data item stored internal to a TField DOES NOT include the 
  21. terminating NULL, where the aMaxLen value passed to the constructor DOES 
  22. include the terminating NULL.  I have corrected the documentation re: aMaxLen 
  23. in TField's constructor to correctly state this fact.  Thanks to everyone who 
  24. pointed this out.
  25.  
  26. This release includes two new TField derivatives: TLowerField and TDoubleField
  27. (tlwfield.cpp and tdbfield.cpp respectively in the ZIP).  These were submitted
  28. by Jerry Jankura (CIS 70170,306)  Thanks for the help Jerry!  I've also added 
  29. a TLongDoubleField (tldfield.cpp) class.
  30.  
  31. This release also fixes a problem with the TIntField/TLongField/TFloatField
  32. min/max validation which incorrectly worded the warning messages.  Thanks to 
  33. Ernest Rowland for pointing this out.
  34.  
  35. If you have any TField derivatives from which you think others could benefit, or
  36. if you have any comments or suggestions regarding this effort, please let me
  37. know.
  38.  
  39. Files included in TFIELD.ZIP are:
  40.    README.TFD -- this file
  41.    TFIELD.DOC -- ascii documentation file (incomplete version)
  42.    TFIELDDC.WP5 -- WP51 documentation file (incomplete version)
  43.    TFIELD.H -- header file for the classes
  44.    TDATE.CPP -- TDate class routines
  45.    TFIELD.CPP -- TField class routines
  46.    TDFIELD.CPP -- TDateField class routines
  47.    TFFIELD.CPP -- TFloatField class routines
  48.    TIFIELD.CPP -- TIntField class routines
  49.    TLFIELD.CPP -- TLongField class routines
  50.    TUFIELD.CPP -- TUpperField class routines (Uppercase version of TField)
  51.    TFLDEX.CPP -- Example file to demonstrate the classes
  52.    TFLDEX.PRJ -- Project file for BC++ 3.0 to build the example under IDE
  53.    TLWFIELD.CPP -- TLowerField class routines
  54.    TLDFIELD.CPP -- TLongDoubleField class routines
  55.    TDBFIELD.CPP -- TDoubleField class routines
  56.    TFLDLIB.BAT -- Creates a TFIELD.LIB, assumes all .OBJ files exist
  57.    TFLDLIB.RSP -- Response file used to build TFIELD.LIB
  58.  
  59.    MBB
  60.  
  61.  
  62. Release 1.1 notes.
  63.  
  64. This version was developed and tested under BC++ 3.0.  You're welcome to 
  65. try to get it to run under BC++ 2.0, but I won't attempt to support it on
  66. that platform!
  67.  
  68. The tfield.doc file is incomplete, but looking at my schedule it could be
  69. another week or more before I can get it finished, so I'm releasing it as-
  70. is for now.  It should be complete enough to allow you to get by.  It anyone
  71. feels like helping, I'm including the Word Perfect 5.1 file, feel free to
  72. edit it if you want <g>.
  73.  
  74. Special thanks to Steve Marcus, Eric Simon and Chris Hill for their work on 
  75. developing the DATECL.ZIP Date class, from which I derived TDate.
  76.  
  77. This version has not had much performance tuning, yet.  It does, however, run
  78. adequately fast on a 486/33 <g> (though trying to use the IDE debugger in some
  79. routines is still terribly slow!)  I don't think performance should suffer much
  80. on anything less than a 286/12.  I could be wrong, however.
  81.  
  82. If you find any bugs, or have any ideas or suggestions for improving this 
  83. class, please let me know via CIS mail and/or post a message on S11 of the 
  84. BPROGB forum, I try to monitor there frequently enough to catch all messages, 
  85. though I may be a few days in responding.
  86.  
  87. I hope that you find these useful!
  88.  
  89. Michael Bonner
  90. CIS: 73250,1460
  91.