MongoDB में, $tan एग्रीगेशन पाइपलाइन ऑपरेटर रेडियन में मापे गए मान की स्पर्शरेखा लौटाता है।
$tan किसी भी मान्य व्यंजक को स्वीकार करता है जो किसी संख्या का समाधान करता है।
$tan ऑपरेटर को MongoDB 4.2 में पेश किया गया था।
उदाहरण
मान लीजिए हमारे पास test . नामक संग्रह है निम्नलिखित दस्तावेज़ के साथ:
{ "_id" : 1, "data" : 2 }
हम $tan . का उपयोग कर सकते हैं ऑपरेटर data की स्पर्शरेखा वापस करने के लिए फ़ील्ड:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
tangent: { $tan: "$data" }
}
}
]
) परिणाम:
{ "tangent" : -2.185039863261519 } रेडियंस में कनवर्ट करें
जैसा कि बताया गया है, $tan रेडियन में मापे गए मान की स्पर्शरेखा लौटाता है। यदि मान डिग्री में है, तो आप $degreesToRadians . का उपयोग कर सकते हैं इसे रेडियन में बदलने के लिए ऑपरेटर।
उदाहरण:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
tangent: { $degreesToRadians: { $tan: "$data" } }
}
}
]
) परिणाम:
{ "tangent" : -0.038136139901240186 } 128-बिट दशमलव मान
डिफ़ॉल्ट रूप से, $tan ऑपरेटर मानों को double . के रूप में लौटाता है , लेकिन यह 128-बिट दशमलव के रूप में भी मान लौटा सकता है, जब तक कि व्यंजक 128-बिट दशमलव मान पर हल हो जाता है।
मान लीजिए हम अपने संग्रह में निम्नलिखित दस्तावेज़ जोड़ते हैं:
{ "_id" : 2, "data" : NumberDecimal("2.1301023541559787031443874490659") }
चलिए $tan चलाते हैं उस दस्तावेज़ के विरुद्ध ऑपरेटर:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
tangent: { $tan: "$data" }
}
}
]
) परिणाम:
{ "tangent" : NumberDecimal("-1.597486946407534452195921861435753") } आउटपुट 128-बिट दशमलव है।
शून्य मान
शून्य मान null लौटाते हैं $tan . का उपयोग करते समय ऑपरेटर।
मान लीजिए हम अपने संग्रह में निम्नलिखित दस्तावेज़ जोड़ते हैं:
{ "_id" : 3, "data" : null }
चलिए $tan चलाते हैं उस दस्तावेज़ के विरुद्ध ऑपरेटर:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $tan: "$data" }
}
}
]
) परिणाम:
{ "result" : null }
हम देख सकते हैं कि परिणाम null है .
NaN मान
अगर तर्क का समाधान NaN . हो जाता है , $tan रिटर्न NaN ।
उदाहरण:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $tan: 1 * "$data" }
}
}
]
) परिणाम:
{ "result" : NaN } गैर-मौजूद फ़ील्ड
अगर $tan ऑपरेटर को उस फ़ील्ड के विरुद्ध लागू किया जाता है जो मौजूद नहीं है, null लौटा दिया गया है।
उदाहरण:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $tan: "$name" }
}
}
]
) परिणाम:
{ "result" : null } इन्फिनिटी
Infinity प्रदान करना या -Infinity एक त्रुटि देता है।
मान लीजिए हम संग्रह में निम्नलिखित दस्तावेज़ जोड़ते हैं:
{ "_id" : 4, "data" : Infinity }
{ "_id" : 5, "data" : -Infinity }
आइए लागू करते हैं $tan इन दस्तावेज़ों के लिए:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 4, 5 ] } } },
{ $project: {
tangent: { $tan: "$data" }
}
}
]
) परिणाम:
uncaught exception: Error: command failed: {
"ok" : 0,
"errmsg" : "cannot apply $tan to inf, value must in (-inf,inf)",
"code" : 50989,
"codeName" : "Location50989"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1
इस मामले में, $tan त्रुटि होने से पहले केवल पहले दस्तावेज़ (दस्तावेज़ 4) के रूप में मिला। हम इसे जानते हैं क्योंकि त्रुटि संदेश इंगित करता है कि यह $tan . लागू करने का प्रयास कर रहा था inf करने के लिए (Infinity )।
यदि हम क्वेरी फ़िल्टर से दस्तावेज़ 4 को हटाते हैं, तो हम देख सकते हैं कि यह दस्तावेज़ 5 में आगे बढ़ता है और वही त्रुटि देता है।
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
tangent: { $tan: "$data" }
}
}
]
) परिणाम:
uncaught exception: Error: command failed: {
"ok" : 0,
"errmsg" : "cannot apply $tan to -inf, value must in (-inf,inf)",
"code" : 50989,
"codeName" : "Location50989"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:618:17
example@sqldat.com/mongo/shell/assert.js:708:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1046:12
@(shell):1:1
इस बार त्रुटि से पता चलता है कि यह $tan . लागू करने का प्रयास कर रहा था to -inf (-Infinity )।