(Possible) Breaking change: local variables references inside nested function definitions

[d.healey]

@christoph-hart Would using reg or var in place of local be the way to go, or should we place the variable outside of the inline function entirely?

[Christoph Hart]

@d-healey This is the same actually - if you define a var inside a inline function, it will get added to the global scope anyway, but sure, writing it in the global scope is a bit cleaner.

inline function setX()
{
    //  ugly as f***
    var x = 90;
}

setX();
Console.print(x);

[d.healey]

@christoph-hart Would it be possible to pass arbitrary values as parameters into the nested function?

[Christoph Hart]

@d-healey Depends on the context, but if the API call expects a function with a certain amount of parameters, it's impossible. But I can understand the rationale of it to avoid polluting the global namespace with variables that hold internal information.

[d.healey]

@christoph-hart said in (Possible) Breaking change: local variables references inside nested function definitions:

But I can understand the rationale of it to avoid polluting the global namespace with variables that hold internal information.

Maybe using a single global object for these things would help keep it contained.

[d.healey]

reg seems to work, anything wrong with that? Nope, doesn't always work

[d.healey]

@Christoph-Hart Now that we have this error message I'm aware of how often I'm doing this kind of thing :p I'm just going to put vars everywhere, to hell with scope, who needs it!

[ustk]

Ouch! that might explain a few things indeed!

[d.healey]

What happens if an inline function contains a nested function which calls another inline function and that second inline function contains local variables? I ask because I'm getting some suspicious crashes :)

[Christoph Hart]

@d-healey This shouldn't affect this example - it would if you would define that second inline function inside the first one, but that's not possible anyway.

[d.healey]

I'm adding reg nest = {}; at the top of each namespace and putting my nested function variables inside there, not ideal but keeps things tidy.

[Fortune]

@christoph-hart said in (Possible) Breaking change: local variables references inside nested function definitions:

So the fix is pretty easy: don't allow local references in nested function calls.

What about previously finished projects? All of them must be modified now, because you can't fix?

Sorry but the above suggestion is not a "fix", it is a prevention workaround. I think rather than telling us to not allowing local references in nested function calls, this issue should be really fixed first. You should fix it.

[Christoph Hart]

@fortune said in (Possible) Breaking change: local variables references inside nested function definitions:

Sorry but the above suggestion is not a "fix", it is a prevention workaround

Of course it is a fix. There was a problem in the language that lead to unintentional behaviour so now it throws a proper error and prevents users from facing this issue.

And if your finished project doesn't have any issues that come from this problem, you don't need to do anything, but the next time you'll update it and it start throwing these errors, you can fix them and sleep better.

[DanH]

@christoph-hart I'm getting an error in my expansion installer callback on the line "local origin = hr;". I think this was largely copied from one of the example projects provided by @Christoph-Hart.

Just so I'm crystal clear, do I want to be using something other than 'local'?

I've had some users reporting that the expansion installer gets stuck trying to install the samples - I wonder if this is related...

inline function onINSTALLEXPControl(component, value)
    {
        
        if (value == 1)
        {
    
  local msg = "SELECT EXPANSION .hr1 FILE";

  Engine.showYesNoWindow("SELECT .HR1 FILE", msg, function(response)
  {
    if (response)
    {
      FileSystem.browse(FileSystem.Downloads, false, "*.hr1", function(hr)
      {
        if (hr.toString(2) == ".hr1")
        {
          local origin = hr; // Scoped copy
          msg = "SELECT A LOCATION FOR THE SAMPLE FILES";

          Engine.showYesNoWindow("SAMPLE LOCATION", msg, function(response)
          {
            if (response)
            {
              FileSystem.browseForDirectory(FileSystem.Samples, function(dir)
              {
                 expHandler.installExpansionFromPackage(origin, dir);
              });
            }
          });
        }
      });
    }
  });
}
    }

Content.getComponent("INSTALLEXP").setControlCallback(onINSTALLEXPControl);

[d.healey]

@danh You need to declare that variable as a reg outside of the function, put it at the top of your script/namespace

[DanH]

@d-healey ok so just:

reg origin = hr; // Scoped copy

inline function onINSTALLEXPControl(component, value)
    {
        
        if (value == 1)
        {
    
  local msg = "SELECT EXPANSION .hr1 FILE";

  Engine.showYesNoWindow("SELECT .HR1 FILE", msg, function(response)
  {
    if (response)
    {
      FileSystem.browse(FileSystem.Downloads, false, "*.hr1", function(hr)
      {
        if (hr.toString(2) == ".hr1")
        {
          
          msg = "SELECT A LOCATION FOR THE SAMPLE FILES";

          Engine.showYesNoWindow("SAMPLE LOCATION", msg, function(response)
          {
            if (response)
            {
              FileSystem.browseForDirectory(FileSystem.Samples, function(dir)
              {
                 expHandler.installExpansionFromPackage(origin, dir);
              });
            }
          });
        }
      });
    }
  });
}
    }

Content.getComponent("INSTALLEXP").setControlCallback(onINSTALLEXPControl);

[Christoph Hart]

@DanH yes this is example ticks all boxes for that issue, but I can't guarantee that there is nothing else wrong :)

But there is another code smell - you're declaring the local variable inside the nested function definition, which should not be possible (and I think the recent change will also prevent that, but I'll have to check).

In your case you might get away with just changing local to var for the origin definition.

[DanH]

@christoph-hart yes I changed 'local origin = hr;' to 'var origin = hr;' and the errors were gone.

EDIT: It's all going wrong when trying to install an expansion now though :face_with_tears_of_joy:

[d.healey]

@danh said in (Possible) Breaking change: local variables references inside nested function definitions:

if (hr.toString(2) == ".hr1")

Magic number alert!!! You should use hr.toString(hr.OnlyExtension)

[d.healey]

@danh said in (Possible) Breaking change: local variables references inside nested function definitions:

ok so just:

Yes, but it's no longer scoped now so you can change that comment ;)

Also hr does exist at init so you can't assign the value there, you have to do that within your function like you were before.