Results 1 to 1 of 1

Thread: Help_File, Dictionary-Equates documented wrongly

Threaded View

Previous Post Previous Post   Next Post Next Post
  1. #1
    thinBasic MVPs
    Join Date
    Oct 2012
    Location
    Germany
    Age
    55
    Posts
    1,555
    Rep Power
    174

    Thumbs up Help_File, Dictionary-Equates documented wrongly

    Help documents
    ThinBASIC-Modules> Dictionary> Dictionary-Equates
    and also
    ThinBASIC-Modules> Dictionary> cDictionary-Class> Dictionary-Equates

    wrong:

    %HT_MemInfo_Total
    %HT_MemInfo_Keys
    %HT_MemInfo_Data

    probably should be

    %DICTIONARY_MEMINFO_TOTAL
    %DICTIONARY_MEMINFO_KEYS
    %DICTIONARY_MEMINFO_DATA


    ________________________________________________________

    also to dictionary-module,
    >Dictionary_Exists
    Current Remark is wrong, it says:

    "To retrieve length of stored data use StrPtrLen function passing pointer returned by Dictionary_Exists"

    This is wrong because the function returns the position where to read out the StrPtr, but it's not the StrPtr itself!
    Using this the way it's described in help leads to crash.
    It should say:

    To retrieve length of stored data use StrPtrLen function passing a DWord At pointer returned by Dictionary_Exists.

    It's the programmers responsibility to make sure by Dictionary_Exists returned pointer is valid before accessing memory. (not zero)

    Example:
    Dim pData As DWord At Dictionary_Exists(pDictionary, KeyName)
    
    If GetAt(pData) <> 0 Then
      SizeOfData = StrPtrLen(pData)
    EndIf
    
    Last edited by ReneMiner; 05-05-2015 at 09:00.
    I think there are missing some Forum-sections as beta-testing and support

Similar Threads

  1. The Skeptics Dictionary
    By Charles Pegge in forum Shout Box Area
    Replies: 0
    Last Post: 12-07-2011, 00:14
  2. Equates
    By Charles Pegge in forum O2h Compiler
    Replies: 0
    Last Post: 18-03-2009, 09:26
  3. Dictionary speed example
    By ErosOlmi in forum Dictionary module
    Replies: 10
    Last Post: 22-04-2007, 22:48
  4. Dictionary example
    By Petr Schreiber in forum Dictionary module
    Replies: 12
    Last Post: 22-04-2007, 12:59

Members who have read this thread: 0

There are no members to list at the moment.

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •