home *** CD-ROM | disk | FTP | other *** search
/ Planet Source Code Jumbo …e CD Visual Basic 1 to 7 / 7_2009-2012.ISO / data / zips / Hex_string219759262011.psc / @PSC_ReadMe_73717_1.txt next >
Text File  |  2011-02-06  |  4KB  |  35 lines

  1. Title: Hex string & byte array conversions
  2. Description: <p>These functions convert hex strings from/to byte arrays. A quick introduction to each:</p>
  3. <ul>
  4. <li><b>HexStringToBytes_A1</b>: one of the most common ways to turn hex string to byte string using "&H" string conversion to a byte value.</li>
  5. <li><b>HexStringToBytes_A2</b>: an optimized version of A1, grabs bigger values in one go and reduces amount of strings created.</li>
  6. <li><b>HexStringToBytes_A1</b>: fills byte array using AscW & MidB$</li>
  7. <li><b>HexStringToBytes_A2</b>: same as before, but uses the passed string as a buffer instead just for comparison. Slower as creates more strings than A1.</li>
  8. <li><b>HexStringToBytes_C1</b>: uses Windows CryptStringToBinary API.</li>
  9. <li><b>HexStringToBytes_S1</b>: uses a lot of advanced VB6 tricks to achieve the greatest speed. API just can't compete with this one.</li>
  10. <li><b>HexStringToBytes_F1</b>: uses advanced VB6 tricks like last one, but allows for any formatting in the passed hex string (such as spaces, line changes or anything else ΓÇô simply looks for any valid hex pairs it can find).
  11. </ul>
  12. <p>Shortly put: the C1 and F1 functions can parse "41 00 42 00 43 00", with formatting. The others only accept "410042004300", no formatting. Those hex strings would convert into a byte array:</p>
  13. <ul>
  14. <li>B(0) = 65</li>
  15. <li>B(1) = 0</li>
  16. <li>B(2) = 66</li>
  17. <li>B(3) = 0</li>
  18. <li>B(4) = 67</li>
  19. <li>B(5) = 0</li>
  20. </ul>
  21. <p>Or "ABC" as a string (Dim S As String: S = B).</p>
  22. <p>There are also functions working the other way around, BytesToHexString_C1 & BytesToHexString_F1. C1 is a version using CryptBinaryToString API while F1 is an optimized function that <b>allows for custom output formatting</b>! You can have any kind of formatting: none at all, just spaces between each hex pair, HTML, XML, C notation, JSON... use your imagination.</p>
  23. <p>Not only that, the F1 version is way faster than the C1 version with the exact same output!</p>
  24. <p>The following tricks are generally used for speed in the S1 and F1 functions:</p>
  25. <ul>
  26. <li><b>Safe arrays</b>: VB6 stores arrays internally as safe arrays. The function creates "fake" Long and Integer arrays. <b>Integer array</b> for accessing the string data (1 character = 2 bytes = Integer) and a <b>Long array</b> for memory manipulation (PutMem4 & GetMem4 replacement) as well as saving the decoded hex string to the byte array.</li>
  27. <li><b>SysAllocStringByteLen</b>: this API creates a BSTR and it does that very fast, especially if pointer is set to 0, in which case you get any free point from memory. That memory is not touched in any way except for setting up the minimal BSTR structure information (4 bytes string length & 2 bytes null terminator). This memory is <b>not</b> given to a string however! Instead it is given to the resulting <b>Byte array</b>. Why? It saves an unnecessary step of nullifying all the bytes that are reserved, and this always happens if you just ReDim an array.</li>
  28. </ul>
  29. <p>Long is the fastest datatype in VB6 in current processors. This is why a Long array is used to store the new bytes into the Byte array instead of just using it directly.</p>
  30. <p>Summa summarum: these functions should give good knowledge for anyone who wants to understand how memory can be handled so that you achieve better performance code in VB6. It isn't pretty though.</p>
  31. This file came from Planet-Source-Code.com...the home millions of lines of source code
  32. You can view comments on this code/and or vote on it at: http://www.Planet-Source-Code.com/vb/scripts/ShowCode.asp?txtCodeId=73717&lngWId=1
  33.  
  34. The author may have retained certain copyrights to this code...please observe their request and the law by reviewing all copyright conditions at the above URL.
  35.