home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / float0b.zip / read.me < prev   
Text File  |  1994-06-01  |  5KB  |  103 lines
  1. This is my first public attempt at an OS/2 program. Beware. I guess that makes it a beta
  2. test.
  3.  
  4. Standard disclaimer:
  5. Use this program at your own risk. I am not responsible for any damage, directly or
  6. indirectly, that it may cause. If you don't backup your data and you lose it, you
  7. have no-one but yourself to blame. This program is provided on an as-is basis, with
  8. no warranty of merchantability.
  9.  
  10. WHAT DOES IT DO?
  11. You can enter all of the main numeric C types into the entry boxes to see what they
  12. look like in Hex. Alternatively, you can enter Hex (byteswapped or in the correct order)
  13. and see the numeric value it represents.
  14.  
  15. WHY DOES IT DO THAT?
  16. If you are a programmer and have to deal with source/data files, but don't have information
  17. on the origins, and can't convert 0xb92419a8c921e0ff287d into long double floating point
  18. in your head, then this is for you. Or if you want to learn a bit about floating point
  19. representation (though I admit binary would be a bit better for that).
  20.  
  21. WHAT DOESN'T IT DO?
  22. No cut'n'paste. I had to put a zero in the long double type, not sure why, it didn't
  23. like the undefined values. No choices for other than Hex (no Octal, no Binary, no Decimal)
  24. in the upper two entry boxes and decimal in the lower. No NaNs or infs. No online help
  25. (I don't count 1 dialog box).
  26.  
  27. HOW DO I INSTALL IT?
  28. All you need is the exe file (pmfloat.exe). Run it from the command line (start pmfloat),
  29. create a program object for it (drag a program object from the templates folder,
  30. use "find" to find the exe, change the icon text to "PMFLOAT", close the dialog box
  31. then double click on the PMFLOAT ICON).
  32.  
  33. HOW DO I USE IT?
  34. Select the Type you want from the "View" menu. Choose from:
  35.    short (2 byte) +/-32768 integer
  36.    long  (4 byte) +/-2147483648 integer
  37.    float (4 byte) +/-.(7 digits precision)+/-(38 max) floating point
  38.    double (8 byte)   +/-.(15 digits precision)+/-(308 max) floating point
  39.    long double (10 byte)   +/-.(17 digits of precision)+/-(4932 max) floating point
  40.  
  41. You can enter the following characters into the "Value" entry box:
  42. 0123456789eE+-.
  43. Other characters cause beeps.
  44. If you enter more than one 'e' or 'E', and more than a total of two '+' or '-', the
  45. input will not be accepted. However, the input is not checked for syntax, you
  46. could enter "+e+1". It will probably crash the program. The entry box is limited
  47. to the maximum precision with maximum mantissa - you can't type in more characters
  48. than that. For integral types (short and long), you can enter exponential,
  49. but everything including and after the 'e' will be ignored.
  50.  
  51. In either of the Hex boxes, you can enter the following characters
  52. 0123456789aAbBcCdDeEfF<space>
  53. Anything else -> beep!
  54. When you press enter or select OK, the input will be checked to ensure that there
  55. are a correct number of hex numbers. So for "double" there must be 8 1-or-2 character
  56. numbers. Each must be separated by at least one space. There can be spaces leading
  57. and trailing. The entry box is limited to one space between each characted plus two
  58. for each hex byte, so "double" allows 23 characters (8 bytes = 16 hex characters plus
  59. 7 spaces). You can enter a single character, omitting the leading 0 for byte values < 16.
  60. By "gaining" characters in this way, it is possible and permissible to have more
  61. than one space between hex bytes. Otherwise "123" could be "1 2 3", "12 3" or "1 23".
  62.  
  63. It would have been a lot easier to just take the input in a single block, but that is not
  64. so easy to read, especially for doubles and long doubles. Alternatively, i could have used
  65. a different entry box for each byte, but that would involve a great deal of mouse
  66. clicking/tabbing to navigate.
  67.  
  68. WHAT NEXT?
  69. I'd like to work out how to use online help. I'd also like to work out how cut'n'paste
  70. works. So i might add them. I did think of adding x86 opcodes as an opton for the value
  71. entry box.
  72.  
  73. HOW MUCH DOES IT COST?
  74. How much money do you have? This package is essentially free, mainly because it is
  75. still "beta", because it doesn't do anything that I think would be generally useful.
  76. Though it is free, I still retain copyright.
  77.  
  78. If you are rich and generous, feel free to send donations to my CD-ROM fund. I can
  79. accept donations in sterling and French francs.
  80.  
  81. If you are not rich, or are a git, I am interested in hearing feedback.
  82.  
  83. This package does NOT include the C source. If you want that, then I will want
  84. money, something like £10 a go. It does include the object, and all the dialog
  85. stuff, so it you want to change fonts, colours, sizes, and you have IBM C Set ++
  86. or the IBM OS/2 Toolkit, you can.
  87.  
  88. I believe that is all.
  89.  
  90. Paul Floyd
  91. Information Storage Research Group
  92. Department of Electrical Engineering
  93. University of Manchester
  94. Dover Street
  95. Manchester
  96. M13 9PL
  97.  
  98. e-mail
  99. mbhpfpj@hpc.ee.man.ac.uk
  100.  
  101. phone
  102. 44-61-275-4532
  103.