v2.0-a049 + Built-in Object functions changes

[Coco]

Due to the latest (as of 07/28/2014) changes in the built-in object functions, I thought I'd share my understanding of how they're used and their counterpart for v1.1 as reference.
Remarks: obj, arr and stack are simply objects

Code: Select all

v2.0-a049                                 v1.1
obj.Remove(Key)                           obj.Remove(Key) / obj.Remove(IntKey, "")
arr.RemoveAt(Index)                       arr.Remove(Index)
obj.Remove(FirstKey, Lastkey)             obj.Remove(FirstKey, Lastkey)
arr.RemoveAt(Index, vCount)               arr.Remove(LowIndex, HighIndex)
stack.Push(Value1, ...)                   stack.Insert(Value1, ...)
stack.Pop()                               stack.Remove()
arr.InsertAt(Index, Value1, ...)          arr.Insert(1, Value1, ...)

Remove / RemoveAt -- for single key
v1.1

Code: Select all

arr := ["A", "B", "C"]
arr.Remove(2)          ;// arr becomes ["A", "C"]
arr.Remove(2, "")      ;// arr becomes {1:"A", 3:"C"}

v2.0-a049

Code: Select all

arr := ["A", "B", "C"]
arr.Remove(2)          ;// arr becomes {1:"A", 3:"C"}
arr.RemoveAt(2)        ;// arr becomes ["A", "C"]

Remove / RemoveAt -- for range of keys
v1.1

Code: Select all

arr := ["A", "B", "C", "D", "E"]
arr.Remove(2, 4)       ;// arr becomes ["A", "E"]

v2.0-a049

Code: Select all

arr := ["A", "B", "C", "D", "E"]
arr.Remove(2, 4)       ;// arr becomes {1:"A", 4:"D", 5:"E"}
;// To replicate the behavior in v1.1, use .RemoveAt()
arr.RemoveAt(2, 3)     ;// arr becomes ["A", "E"]

Insert / Push
v1.1

Code: Select all

arr := ["A", "B", "C"]
arr.Insert("D")        ;// arr becomes ["A", "B", "C", "D"]

v2.0-a049

Code: Select all

arr := ["A", "B", "C"]
arr.Push("D")          ;// arr becomes ["A", "B", "C", "D"]

Remove / Pop
v1.1

Code: Select all

arr := ["A", "B", "C", "D"]
arr.Remove()           ;// arr becomes ["A", "B", "C"]

v2.0-a049

Code: Select all

arr := ["A", "B", "C", "D"]
arr.Pop()              ;// arr becomes ["A", "B", "C"]

[toralf]

Regarding push/pop examples above. I assume the insert/remove methods still work in v2 but push/pop are just shortcuts for lifo stack.

Is there a shortcut for fifo stack?

[guest3456]

excellent summary, thank you

[nnnik]

Is there a shortcut for fifo stack?

I guess not.
The fastest I could think of would be:

Code: Select all

fifo.remove(1)
fifo.insert(Val)

[toralf]

I guess this would work too

Code: Select all

fifo.push(val)
fifo.remove(1)

Are the words push/pop used in other languages? They do not seem to have any "link" to other ahk commands. Append/get/set/add/choose/check are more common

[joedf]

Assembly language
http://en.m.wikipedia.org/wiki/Assembly_language
Or better yet, JavaScript
http://www.w3schools.com/jsref/jsref_push.asp
PHP
http://php.net/manual/en/function.array-push.php
Perl
http://perldoc.perl.org/functions/push.html

[fincs]

"fifo stack" is a contradiction. The term you're looking for is 'queue'. And it can be implemented: Push(value) and RemoveAt(1,1).

[nnnik]

Assembly language
http://en.m.wikipedia.org/wiki/Assembly_language
Or better yet, JavaScript
http://www.w3schools.com/jsref/jsref_push.asp
PHP
http://php.net/manual/en/function.array-push.php
Perl
http://perldoc.perl.org/functions/push.html

I dont get what you want to say.
You either want to say that Push and Pop functions are more common in a different way, or you just wanted to say something.

[lexikos]

Do you see the conflict between stack.Insert(Value1, ...) and arr.Insert(1, Value1, ...)? There is no way to "push" multiple values simultaneously in v1 without specifying the index. So: stack.Insert(val) and stack.Insert(Round(stack.MaxIndex())+1, val1, val2, ...).

I assume the insert/remove methods still work in v2

No. They were commonly misunderstood. You may refer to v2-changes or Object for clarification.

Are the words push/pop used in other languages?

Not just other languages, but programming theory in general. They go hand in hand with the term "stack".

They do not seem to have any "link" to other ahk commands.

Do half the other method names have any link to other commands? What they're doing is unique to objects.

Append/get/set/add/choose/check are more common

I chose "Push" rather than "Append" for symmetry with "Pop". As far as I can tell, none of those other names have anything to do with Push/Pop. I'm not aware of any other term for removing and returning the last element of an array/stack.

RemoveAt(1,1)

That will return 0 or 1 depending on whether it removed something. You want val := queue.RemoveAt(1).

There is no shortcut for it because it is already quite short and does not require any calculations. By contrast, Push would require something like what I showed at the top of this post.

I dont get what you want to say.

joedf was answering toralf's question by listing the languages, implying "Yes".

[RobertL]

At used on Array (which key is index), would change index related.
Stack with pop/push used on a special array, would only change the last/max index.
Object is a common basic data struct with any/general key without changing other keys (even a adjoining numerical key).