Namespace: queryOperators

ink/probe. queryOperators

Query operators (this is not a real namespace, but a document artifact to organize the symbols)

Source:

Members

<static> $all

$all checks to see if all of the members of the query are included in an array {array: {$all: [val1, val2, val3]}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"categories" : {$all : ["cat4", "cat2", "cat1"]}} );

<static> $and

Returns true if all of the conditions of the query are met {$and: [query1, query2, query3]}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {$and : [
    		{"name.first" : "Mildred"},
    		{"name.last" : "Graves"}
    	]} );

<static> $elemMatch

This is like $all except that it works with an array of objects or value. It checks to see the array matches all of the conditions of the query {array: {$elemMatch: {path: value, path: {$operation: value2}}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {attr : {$elemMatch : [
    		{color : "red", "hand" : "left"}
    	]}} );

<static> $eq

$eq performs a === comparison by comparing the value directly if it is an atomic value. otherwise if it is an array, it checks to see if the value looked for is in the array. {field: value} or {field: {$eq : value}} or {array: value} or {array: {$eq : value}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {categories : "cat1"} );
    // is the same as
    probe.find( data, {categories : {$eq: "cat1"}} );

<static> $exists

$exists Sees if a field exists. {field: {$exists: true|false}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"name.middle" : {$exists : true}} );

<static> $gt

$gt Sees if a field is greater than the value {field: {$gt: value}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$gt : 24}} );

<static> $gte

$gte Sees if a field is greater than or equal to the value {field: {$gte: value}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$gte : 50}} );

<static> $in

$in Sees if a field has one of the values in the query {field: {$in: [test1, test2, test3,...]}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$in : [24, 28, 60]}} );

<static> $lt

$lt Sees if a field is less than the value {field: {$lt: value}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$lt : 24}} );

<static> $lte

$lte Sees if a field is less than or equal to the value {field: {$lte: value}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$lte : 50}} );

<static> $mod

Checks equality to a modulus operation on a field {field: {$mod: [divisor, remainder]}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$mod : [2, 0]}} );

<static> $ne

$ne performs a !== comparison by comparing the value directly if it is an atomic value. Otherwise, if it is an array this is performs a "not in array". '{field: {$ne : value}}or '{array: {$ne : value}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"name.first" : {$ne : "Sheryl"}} );

<static> $nin

$nin Sees if a field has none of the values in the query {field: {$nin: [test1, test2, test3,...]}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"age" : {$nin : [24, 28, 60]}} );

<static> $nor

Returns true if none of the conditions of the query are met {$nor: [query1, query2, query3]}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {$nor : [
    		{"age" : {$in : [24, 28, 60]}},
    		{categories : "cat1"}
    	]} );

<static> $not

Logical NOT on the conditions of the query {$not: [query1, query2, query3]}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {$not : {"age" : {$lt : 24}}} );

<static> $or

Returns true if any of the conditions of the query are met {$or: [query1, query2, query3]}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {$or : [
    		{"age" : {$in : [24, 28, 60]}},
    		{categories : "cat1"}
    	]} );

<static> $regex

Performs a regular expression test againts the field {field: {$regex: re, $options: reOptions}}

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {"name.first" : {$regex : "m*", $options : "i"}} );

<static> $size

Compares the size of the field/array to the query. This can be used on arrays, strings and objects (where it will count keys) {'field|array: {$size: value}}`

Source:
Example
    var probe = require("ink-probe");
    probe.find( data, {attr : {$size : 3}} );
ink-probe Copyright © 2012-2013 Terry Weiss. All rights reserved.
Documentation generated by JSDoc 3.2.0-dev on Sun Jun 09 2013 11:55:26 GMT-0400 (EDT) using the DocStrap template.