Object 內建對象

對象RedisSet

Redis資料庫客戶端Set 對象,此對象為包含指定key 的客戶端,只有呼叫其方法才會操作資料庫

用以操作Redis的Set 對象,建立方法:

1 2 3
var db = require("db"); var rdb = new db.openRedis("redis-server"); var set = rdb.getSet("test");

繼承關係

成員函數

add

將一個或多個member 元素加入集合key 當中,已經存在於集合的member 元素將被忽略

1
Integer RedisSet.add(Array members);

呼叫參數:

  • members: Array, 指定要新增的元素數組

回傳結果:

  • Integer, 被加到集合中的新元素的數量,不包括被忽略的元素

同時將多個field-value (域-值)對設定到哈希表中,此指令會覆寫哈希表中已存在的域

1
Integer RedisSet.add(...members);

呼叫參數:

  • members: ..., 指定要新增的元素列表

回傳結果:

  • Integer, 被加到集合中的新元素的數量,不包括被忽略的元素

remove

移除集合中的一個或多個member 元素

1
Integer RedisSet.remove(Array members);

呼叫參數:

  • members: Array, 指定要移除的元素數組

回傳結果:

  • Integer, 被成功移除的元素的數量,不包括被忽略的元素

移除集合中的一個或多個member 元素

1
Integer RedisSet.remove(...members);

呼叫參數:

  • members: ..., 指定要移除的元素列表

回傳結果:

  • Integer, 被成功移除的元素的數量,不包括被忽略的元素

len

傳回集合中元素的數量

1
Integer RedisSet.len();

回傳結果:

  • Integer, 傳回集合的長度

exists

判斷member 元素是否集合的成員

1
Boolean RedisSet.exists(Buffer member);

呼叫參數:

  • member:Buffer, 指定檢查的member

回傳結果:

  • Boolean, 如果member 元素是集合的成員,回傳true

members

傳回集合中的所有成員

1
NArray RedisSet.members();

回傳結果:

  • NArray, 集合中所有成員的列表

pop

移除並傳回集合中的一個隨機元素

1
Buffer RedisSet.pop();

回傳結果:

  • Buffer, 被移除的隨機元素。當集合是空集合時,回傳null

randMember

從集合中取得隨機的一個元素

1
Value RedisSet.randMember();

回傳結果:

  • Value, 傳回一個元素;如果集合為空,則傳回null

從集合中取得隨機的若干元素

1
Value RedisSet.randMember(Integer count);

呼叫參數:

  • count: Integer, 指定傳回的元素個數。正數,傳回一個包含count 個元素的陣列;負數,傳回一個數組,數組中的元素可能會重複出現多次,而數組的長度為count 的絕對值

回傳結果:

  • Value, 傳回一個列表;如果集合為空,則傳回空列表

toString

傳回物件的字串表示,一般回傳"[Native Object]",物件可以根據自己的特性重新實現

1
String RedisSet.toString();

回傳結果:

  • String, 傳回物件的字串表示

toJSON

傳回物件的JSON 格式表示,一般傳回物件定義的可讀屬性集合

1
Value RedisSet.toJSON(String key = "");

呼叫參數:

  • key: String, 未使用

回傳結果:

  • Value, 傳回包含可JSON 序列化的值