R语言 rmongodb包 mongo.find.one()函数中文帮助文档(中英文对照)

loveR

mongo.find.one(rmongodb)
mongo.find.one()所属R语言包：rmongodb

                                        Find one record in a collection
                                         查找一个记录集合中的

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Find the first record in a collection that matches a given query.
查找匹配给定查询集合中的第一条记录。

This is a simplified version of mongo.find() which eliminates the need  to step through returned records with a cursor.
这是一个简化版本的mongo.find（），从而消除了需要加强通过游标返回的记录。

See http://www.mongodb.org/display/DOCS/Querying.
请参阅http://www.mongodb.org/display/DOCS/Querying。


用法----------Usage----------


mongo.find.one(mongo, ns, query=mongo.bson.empty(),
                          fields=mongo.bson.empty())



参数----------Arguments----------

参数：mongo
(mongo) A mongo connection object.
（蒙戈）蒙戈的连接对象。


参数：ns
(string) The namespace of the collection from in which to find a record.
（字符串）的命名空间的集合中，找到一条记录。


参数：query
(mongo.bson) The criteria with which to match the record that is to be found. The default of mongo.bson.empty() will cause the the very first record in the collection to be returned.  Alternately, query may be a list which will be converted to a mongo.bson object  by mongo.bson.from.list().
（mongo.bson）的标准相匹配的记录，是被发现。默认情况下，的mongo.bson.empty（）会返回集合中的第一个记录。或者，query可能是由mongo.bson.from.list()到mongo.bson对象的列表将被转换。


参数：fields
(mongo.bson) The desired fields which are to be returned frtom the matching record. The default of mongo.bson.empty() will cause all fields of the matching record to be returned;  however, specific fields may be specified to cut down on network traffic and memory overhead.  Alternately, fields may be a list which will be converted to a mongo.bson object by mongo.bson.from.list().
（mongo.bson）所需的域，它是要返回frtom匹配的记录。默认情况下，的mongo.bson.empty（）将导致所有要返回的字段匹配的记录，但是，可以指定特定领域，以减少网络流量和内存开销。或者，fields可能是由mongo.bson.from.list()到mongo.bson对象的列表将被转换。


值----------Value----------

NULL if no record matching the criteria is found; otherwise,
NULL如果没有记录匹配的标准，否则，

(mongo.bson) The matching record/fields.
（mongo.bson）相匹配的记录/字段。

Note that NULL may also be returned if a database error occurred (when a badly formed query is used, for example). mongo.get.server.err and mongo.get.server.err.string may be examined in that case.
请注意，如果发生了一个数据库错误，还可以返回NULL（使用时，不正确的查询，例如）。 mongo.get.server.err和mongo.get.server.err.string在这种情况下，可以检查。


参见----------See Also----------

mongo.find,<br> mongo.index.create,<br> mongo.insert,<br> mongo.update,<br> mongo.remove,<br> mongo,<br> mongo.bson.
mongo.find，参考mongo.index.create，参考mongo.insert，参考mongo.update，参考mongo.remove，参考蒙戈，参考mongo.bson。


实例----------Examples----------


mongo <- mongo.create()
if (mongo.is.connected(mongo)) {
    buf <- mongo.bson.buffer.create()
    mongo.bson.buffer.append(buf, "name", "Jeff")
    query <- mongo.bson.from.buffer(buf)

    # find the first record where name is "Jeff"\[找到的第一个记录的名字是“杰夫”\]
    #    in collection people of database test[在收集的数据库测试的人]
    b <- mongo.find.one(mongo, "test.people", query)
    if (!is.null(b))
        print(b)

    buf <- mongo.bson.buffer.create()
    mongo.bson.buffer.append(buf, "_id", 1L)
    mongo.bson.buffer.append(buf, "age", 1L)
    fields <- mongo.bson.from.buffer(buf)

    # find the first record where name is "Jeff"[找到的第一个记录的名字是“杰夫”]
    #    in collection people of database test[在收集的数据库测试的人]
    # return only the _id and age fields of the matched record[只返回_id和年龄字段匹配的记录]
    b <- mongo.find.one(mongo, "test.people", query, fields)
    if (!is.null(b))
        print(b)

    # find the first record in collection cars of database test[找到的第一条记录的数据库测试的收集车]
    have.car <- !is.null(mongo.find.one(mongo, "test.cars"))

    # shorthand using a list:[速记使用一个列表：]
    b <- mongo.find.one(mongo, "test.people", list(name="Jose"))
}

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。