Help:ArrayExtension

{{#arraydefine:a|red}}

• members: red
• size(expect 1): 1

{{#arraydefine:a1|0}}

• members: 0
• size(expect 1): 1

{{#arraydefine:b|orange,red ,yellow, yellow|,|print=list}}

• members:orange, red, yellow, yellow
• size(expect 4): 4

{{#arraydefine:b1|orange,red ,yellow, yellow|,|unique, print=list}}

• members:orange, red, yellow
• size(expect 3): 3

{{#arraydefine:b2|orange,red ,yellow, yellow|,|unique, sort=desc, print=list}}

• members:yellow, red, orange
• size(expect 3): 3

{{#arraydefine:b3|0,1,2|,|unique, print=list}}

• members:0, 1, 2
• size(expect 3): 3

{{#arraydefine:c}}

• members:
• size(expect 0): 0

{{#arraydefine:d|apple, pear}}

• members: apple, pear
• size(expect 2): 2

{{#arraydefine:d1|apple, pear|}}

• members: apple, pear
• size(expect 1): 1

{{#arraydefine:e|apple ; pear, orange|;}}

• members: apple, pear
• size(expect 2): 2

see also:http://us2.php.net/manual/en/function.preg-split.php

{{#arraydefine:f|apple ; pear, orange|/\s*[;,]\s*/}}

• members: apple, pear, orange
• size(expect 3): 3

{{#arrayprint:b}}

orange, red, yellow, yellow

{{#arrayprint:b|}}

orangeredyellowyellow

{{#arrayprint:b|<br/>}}

orange
red
yellow
yellow

{{#arrayprint:b|<br/>|@@@@|[[@@@@]]}}

orange
red
yellow
yellow

{{#arrayprint:b|<br/>|@@@@|[[prop1::@@@@]]}}

orange
red
yellow
yellow

{{#arrayprint:b|<br/>|@@@@|length of @@@@:{{#len:@@@@}}}}

length of orange:6
length of red:3
length of yellow:6
length of yellow:6

{{#arrayprint:b|<br/>|@@@@|{{f.tag{{f.print.vbar}}prop2{{f.print.vbar}}@@@@}}}}

• prop2: orange
  
• prop2: red
  
• prop2: yellow
  
• prop2: yellow

http://www.php.net/manual/en/function.count.php

{{#arraysize:b}}

5

http://www.php.net/manual/en/function.array-search.php

{{#arraysearch:b|white}}
{{#arraysearch:b|red}}
{{#arraysearch:f|0}}

{{#arraysearch:b|white|0|yes|no}}
{{#arraysearch:b|yellow|0|yes|no}}

{{#arraysearch:b|red|0}}
{{#arraysearch:b|red|2}}

{{#arraysearch:b|/low/}}
{{#arraysearch:b|low}}

{{#arraysearch:b|/ack/i}}
{{#arraysearch:b|/ack/}}
{{#arraysearch:b|/ACK/}}

• case1 (expect -1): -1
• case2 (expect 2): 2
• case3 (expect 1): 1

use yes/no option

• case1 (expect no): no
• case2 (expect yes): yes

use offset option

• case1 (expect 1): 1
• case2 (expect -1): -1

use regular expression needle

• case1 (expect 2): 2
• case2 (expect -1): -1

• case3 (expect 4): 4
• case4 (expect -1): -1
• case5 (expect 4): 4

*expect "yellow": {{#arrayindex:b|2}}
*expect (empty string): {{#arrayindex:b|-2}}
*expect "bad value":{{#arrayindex:b|-2|default=bad value}}

• expect "yellow": yellow
• expect (empty string):
• expect "bad value":bad value

{{#arraymerge:x|a|b}}

red, orange, red, yellow, yellow, BLACK

{{#arraymerge:x|b}}

orange, red, yellow, yellow, BLACK

{{#arraymerge:c|c|b}}

before: DARK

after: DARK, orange, red, yellow, yellow, BLACK

{{#arrayslice:x|b|abd|2}}
{{#arrayslice:x|b|0|0}}
{{#arrayslice:x|b|0|2}}
{{#arrayslice:x|b|1|2}}
{{#arrayslice:x|b|-3|2}}
{{#arrayslice:x|b|5}}
{{#arrayslice:x|b|-10}}

• before:

• after: (expect empty because the offset is not a number)

• after: (expect empty because the length is zero)

• after: orange, red (expect orange,red )

• after: red, yellow (expect red, yellow)

• after: yellow, yellow (expect yellow, yellow)

• after: (expect empty because the offset if beyond the index of the array)

• after: orange, red, yellow, yellow, BLACK (expect orange, red, yellow, yellow, BLACK)- all element will be selected

{{#arrayintersect:x|a|b}}

red

{{#arrayunion:x|a|b}}

red, orange, yellow, BLACK

{{#arraydiff:x|b|a}}

orange, yellow, BLACK

{{#arraydiff:x|a|b}}

{{#arraysort:b|desc}}

before: orange, red, yellow, yellow, BLACK --b[2]= yellow

after: yellow, yellow, red, orange, BLACK --b[2]= red

{{#arraysort:b|random}}

before: yellow, yellow, red, orange, BLACK --b[2]= red

after: yellow, BLACK, orange, red, yellow --b[2]= orange

{{#arraysort:b|reverse}}

before: yellow, BLACK, orange, red, yellow --b[2]= orange

after: yellow, red, orange, BLACK, yellow --b[2]= orange

{{#arrayunique:b}}

before (b): yellow, red, orange, BLACK, yellow

after (b): yellow, red, orange, BLACK

before (x): a, b, , , c, c

after (x): a, b, , c

{{#arraydefine:0|0,2,3,4}}
{{#arrayprint:0}}
{{#arrayreset:0}}
{{#arrayprint:0}}

before: 0, 2, 3, 4

after: undefined array: 0

{{#arrayreset:}}

before: yellow, red, orange, BLACK

after: undefined array: b