salzkartoffeeel/tostr.ahk

An AutoHotkey function for displaying any type of value as a string, so that it can be worked with easily.

tostr.ahk's Issues

Menu Objects need a way to retrieve all menu items, not just the amount

This is a painfully difficult thing to implement, but I really want to get it to work :(

Here is the documentation that's most interesting: https://docs.microsoft.com/windows/desktop/api/winuser/nf-winuser-getmenuiteminfow

GUI Objects need a better way of retrieving the name/title that can't fail

Currently, the algorithm used is guiObj.name || guiObj.title, which generally works. However, when guiObj.name is a string that is considered false, but not an empty string, this fails and will fall back to guiObj.title.
For example, when guiObj.title is "0", this algorithm fails and falls back, because the string is considered false.

Bound Func Objects need a way to retrieve the function name

Regular Func Objects implement a name property, which holds the name of the function they point to. Bound Func Objects, however, only implement the call() method.
This will require some low-level digging around in the source code of AHK.

File Objects need a way to retrieve the second parameter of fileOpen()

Currently, this is not implemented and it will need some serious work, since this is not an official feature of AHK.

Variables without values

When I reload a script that contains #include , I get the error

Warning: This variable appears to never be assigned a value.

Specifically: local varSetCapacity

	---- D:\the good stuff... 3\AutoHotKey\Lib\toStr.ahk
	087: }
	090: {
▶	091: hFile := fileObj.handle , varSetCapacity(lpszFilePath, 260 * 2 + 1) , cchFilePath := 260 * 2 , dwFlags := 0x0 , ret := dllCall("GetFinalPathNameByHandleW", "Ptr", hFile, "Str", lpszFilePath, "UInt", cchFilePath, "UInt", dwFlags)
	097: If (ret > 260 * 2)
	097: {

For more details, read the documentation for #Warn.

and

Warning: This variable appears to never be assigned a value.

Specifically: local lpszFilePath

	---- D:\the good stuff... 3\AutoHotKey\Lib\toStr.ahk
	087: }
	090: {
▶	091: hFile := fileObj.handle , varSetCapacity(lpszFilePath, 260 * 2 + 1) , cchFilePath := 260 * 2 , dwFlags := 0x0 , ret := dllCall("GetFinalPathNameByHandleW", "Ptr", hFile, "Str", lpszFilePath, "UInt", cchFilePath, "UInt", dwFlags)
	097: If (ret > 260 * 2)
	097: {

For more details, read the documentation for #Warn.

I am running v2 and forced your script to run it too with #Requires AutoHotkey v2.0. What should I change in your script to fix this?

_objIsLinear() is inefficient

The utility function _objIsLinear() could probably be made more efficient by doing some fancy business with obj.count() and other object methods.
The current function works well for small objects, but takes a bit of time for bigger ones.
It is O(n) in the worst case (not too bad), but could potentially be made O(1).