Compatibility Notes

Some updates include certain changes which require existing projects to be modified to retain compatibility with updated versions. This section documents those changes as well as the remedies to any incompatibilities they create.

1.1.2#

  • Improved foreach syntax and behavior
    • Parentheses now close before call keyword rather than after
    • Existing instances of this function must be updated to match the new syntax
    • (Recommended: Use regex global search & replace in external code editor)

1.1.0#

  • Changed timer_get and timer_set to timer_get_time and timer_set_time for clarity and consistency with other get and set functions.
    • Existing instances of these functions must be renamed to match the updated syntax
    • (Recommended: Use global search & replace)
  • Replaced array_create_2d with array_create_ext, now supporting arbitrary dimensions
    • Existing instances of the old function must be renamed to match the new function.
    • Instances providing two dimensions and a default value require no further changes.
    • Setting a default value is now required, as additional arguments are treated as new dimensions preferentially. Instances which previously set no default value must be updated to include one.
    • (Recommended: Use global search & replace)
  • Replaced array_fill_2d with array_fill, now supporting arbitrary dimensions
    • Existing instances of the old function must be renamed to match the new function.
    • (Recommended: Use global search & replace)
  • Replaced array_width and array_height with array_depth to complement the new built-in array_length function
    • array_width generally maps to array_length and array_height generally maps to array_depth. However, behaviors may not be identical in all cases due to multidimensional arrays now acting as arrays within arrays. Evaluate existing code and update as needed.
    • (Recommended: Use global search & replace)
  • Replaced array_find_col and array_find_row with array_find_index and array_find_dim
    • array_find_col generally maps to array_find_index and array_find_row generally maps to array_find_dim. However, behaviors may not be identical in all cases due to multidimensional arrays now acting as arrays within arrays. Evaluate existing code and update as needed.
    • (Recommended: Use global search & replace)