BUI

其它版本:

API for BUI 1.4.8

Show:

bui.array Class

常用小方法

Item Index

Methods

compare

(
  • name
  • arr
  • [key]
)
Boolean

比对数组是否已经存在,支持普通数组及JSON数组

Parameters:

  • name String

    [字符串]

  • arr Array

    [数组]

  • [key] String optional

    [object的键名]

Returns:

Boolean:

[返回true|false]

Example:

   //普通数组:
   var arr = ["hello","bui","hi","bui"];
   var isExist = bui.array.compare( "bui", arr );

   // console.log(isExist) //结果: true

   //JSON数组: 
   var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
   var isExist = bui.array.compare( "bui", arr, "value" );
   // console.log(isExist) //结果: true 

copy

(
  • arr
  • from
  • [length]
)
Array

复制数组某一部分

Parameters:

  • arr Array

    [数组]

  • from Number

    [从第几个复制]

  • [length] Number optional

    [复制多少个,不填则是到最后一个]

Returns:

Array:

[返回一个新的数组]

Example:

   var arr = ["hello","bui","hi","easybui"];
   var newArr = bui.array.copy( arr, 1 );
   var newArr2 = bui.array.copy( arr, 1,2 );

   // console.log(newArr) //结果: ["bui","hi","easybui"]
   // console.log(newArr2) //结果: ["bui","hi"]

excess

(
  • name
  • arr
  • [key]
)
Array

去除数组的多余数据,支持普通数组及JSON数组

Parameters:

  • name String

    [字符串]

  • arr Array

    [数组]

  • [key] String optional

    [object的键名]

Returns:

Array:

[返回一个没有重复数据的数组]

Example:

    //普通数组:
    var arr = ["hello","bui","hi","bui"];
    var newArr = bui.array.excess( "bui", arr );

    // console.log(newArr) //结果: ["hello","bui","hi"]

    //JSON数组: 
    var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"},{ "id":3,value:"bui"}];
    var newArr = bui.array.excess( "bui", arr, "value" );
    // console.log(newArr) //结果: [{ "id":1,value:"hello"},{ "id":2,value:"bui"}] 

filter

(
  • name
  • arr
  • [key]
)
Array

筛选数组,支持普通数组及JSON数组

Parameters:

  • name String

    [字符串]

  • arr Array

    [数组]

  • [key] String optional

    [object的键名]

Returns:

Array:

[返回筛选的元素]

Example:

    //普通数组:
    var arr = ["hello","bui","hi","easybui"];
    var newArr = bui.array.filter( "bui", arr );

    // console.log(newArr) //结果: ["bui","easybui"]

    //JSON数组: 
    var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"},{ "id":3,value:"easybui"}];
    var newArr = bui.array.filter( "bui", arr, "value" );
    // console.log(newArr) //结果: [{ "id":2,value:"bui"},{ "id":3,value:"easybui"}] 

index

(
  • name
  • arr
  • [key]
)
Number

返回存在的第1个位置,支持普通数组及JSON数组

Parameters:

  • name String

    [字符串]

  • arr Array

    [数组]

  • [key] String optional

    [object的键名]

Returns:

Number:

[返回的位置如果大于0,则存在]

Example:

   //普通数组:
   var arr = ["hello","bui","hi","bui"];
   var index = bui.array.index( "bui", arr );

   // console.log(index) //结果: 1

   //JSON数组: 
   var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
   var index = bui.array.index( "bui", arr, "value" );
   // console.log(index) //结果: 1 

indexs

(
  • name
  • arr
  • [key]
)
Array

返回数组的所有索引,支持普通数组及JSON数组

Parameters:

  • name String

    [字符串]

  • arr Array

    [数组]

  • [key] String optional

    [object的键名]

Returns:

Array:

[返回存在的索引数组]

Example:

   //普通数组:
   var arr = ["hello","bui","hi","bui"];
   var index = bui.array.indexs( "bui", arr );

   // console.log(index) //结果: [1,3]

   //JSON数组: 
   var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
   var index = bui.array.indexs( "bui", arr, "value" );
   // console.log(index) //结果: [1]

remove

(
  • name
  • arr
  • [key]
)
Array

删除数组的某个值或者对象,支持普通数组及JSON数组

Parameters:

  • name String

    [字符串]

  • arr Array

    [数组]

  • [key] String optional

    [object的键名]

Returns:

Array:

[返回删除后的数组]

Example:

   //普通数组:
   var arr = ["hello","bui","hi","bui"];
   var newArr = bui.array.remove( "bui", arr );

   // console.log(newArr) //结果: ["hello","hi"]

   //JSON数组: 
   var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
   var newArr = bui.array.remove( "bui", arr, "value" );
   // console.log(newArr) //结果: [{ "id":1,value:"hello"}]