ऑब्जेक्ट
JSON ऑब्जेक्ट, दूसरी भाषाओं की शब्दावली में कहें तो, एक "हैश", "मैप" या "डिक्शनरी" है।
JSON ऑब्जेक्ट को इस तरह परिभाषित करता है:
ऑब्जेक्ट नाम/वैल्यू जोड़ों का एक समुच्चय है जिसका कोई निश्चित क्रम नहीं होता।
ऑब्जेक्ट { बाएँ ब्रेस से शुरू होता है और } दाएँ ब्रेस पर खत्म होता है।
हर नाम के बाद : कोलन आता है और नाम/वैल्यू जोड़ों को , कॉमा से अलग किया जाता है।
नाम एक स्ट्रिंग ही होना चाहिए।
नाम का दूसरा शब्द की है।
वैल्यू किसी भी JSON टाइप की हो सकती है।
एक ही ऑब्जेक्ट में अलग-अलग वैल्यू अलग-अलग टाइप की हो सकती हैं, जैसे इस उदाहरण में।
{
"name": "Jane",
"age": 42,
"pets": ["cat", "fish"],
"address": {"street": "123 Main St", "city": "Springfield"}
}
ध्यान रखिए कि अंतिम की-वैल्यू जोड़े के बाद कोई कॉमा नहीं होना चाहिए।
ऑब्जेक्ट बनाना
नाम/वैल्यू जोड़ों को इकट्ठा करने के लिए ब्रेस का उपयोग कीजिए।
हालाँकि नाम स्ट्रिंग ही होने चाहिए, लेकिन अगर नाम आइडेंटिफायर जैसे हों (अल्फान्यूमेरिक अक्षरों और अंडरस्कोर से बने हों, और किसी अंक से शुरू न हों) तो उन्हें कोट में लिखने की ज़रूरत नहीं है।
{name: "Jane", age: 42}
ऐसी की का उपयोग करना भी मान्य है जो आइडेंटिफायर जैसी न हों।
बस उन्हें कोट में लिख दीजिए।
{"first name": "Jane", "last name": "Lopez", age: 42}
अगर नाम किसी एक्सप्रेशन का परिणाम है, तो एक्सप्रेशन अवश्य कोष्ठकों में होना चाहिए।
$ echo "Jane" | jq -Rc '{.: 42}'
# verbose error message ...
$ echo "Jane" | jq -Rc '{(.): 42}'
{"Jane":42}
इंडेक्सिंग
ऑब्जेक्ट से वैल्यू डॉट नोटेशन से निकाली जाती हैं।
{name: "Jane", age: 42} | .age # => 42
अगर आप की को किसी आइडेंटिफायर की तरह नहीं लिख सकते, तो ब्रैकेट नोटेशन का उपयोग कीजिए।
"name" as $key | {name: "Jane", age: 42} | .$key # => error
"name" as $key | {name: "Jane", age: 42} | .[$key] # => "Jane"
की-वैल्यू जोड़े जोड़ना या बदलना
किसी ऐरे में नया की-वैल्यू जोड़ा जोड़ने के लिए, या किसी मौजूदा की की वैल्यू बदलने के लिए, = असाइनमेंट ऑपरेटर का उपयोग कीजिए, जिसके बाईं ओर एक इंडेक्स एक्सप्रेशन हो।
{name: "Jane", age: 42} | .sport = "tennis" | .age = 21
# => {
# "name": "Jane",
# "age": 21,
# "sport": "tennis"
# }
+ ऑपरेटर ऑब्जेक्ट को मर्ज करता है।
{Richard: 54} + {Jane: 42}
# => {
# "Richard": 54,
# "Jane": 42
# }
कोई की हटाना
किसी की को हटाने के लिए del फंक्शन का उपयोग कीजिए।
यह अपडेट किया गया ऑब्जेक्ट लौटाता है।
{name: "Jane", age: 42} | del(.age) # => {"name": "Jane"}
del को दिया जाने वाला पैरामीटर एक इंडेक्स एक्सप्रेशन होता है (जो डॉट या ब्रैकेट नोटेशन का उपयोग करता है), जो ऑब्जेक्ट में किसी की पर लागू होता है।
jq इसे पाथ एक्सप्रेशन कहता है।
सिर्फ एक स्ट्रिंग देना काफी नहीं है।
{name: "Jane", age: 42} | del(name) # error: name/0 is not defined
{name: "Jane", age: 42} | del("name") # error: Invalid path expression with result "name"
{name: "Jane", age: 42} | del(.name) # OK
{name: "Jane", age: 42} | del(.["name"]) # OK
सदस्यता
-
यह जाँचने के लिए कि ऑब्जेक्ट में कोई की है या नहीं, has फंक्शन का उपयोग कीजिए।
{name: "Jane", age: 42} as $example
|
($example | has("name")), # => true
($example | has("sport")) # => false
-
in से जाँचिए कि कोई की ऑब्जेक्ट में है या नहीं।
{name: "Jane", age: 42} as $example
|
("name" | in($example)), # => true
("sport" | in($example)) # => false
सभी की की सूची बनाना
सभी की की सूची देने के लिए keys फंक्शन का उपयोग कीजिए।
{name: "Jane", age: 42} | keys # => ["age", "name"]
ध्यान दीजिए कि keys फंक्शन की को सॉर्ट कर देता है।
की को मूल क्रम में पाने के लिए keys_unsorted का उपयोग कीजिए।
सभी वैल्यू को सूचीबद्ध करने वाला कोई समान फंक्शन नहीं है।
लेकिन .[] फिल्टर ऑब्जेक्ट की वैल्यू को एक स्ट्रीम के रूप में देता है, और उस स्ट्रीम को [...] ऐरे कंस्ट्रक्टर से पकड़ा जा सकता है।
[{first: "Jane", last: "Lopez", status: "awesome!"} | .[]]
# => ["Jane", "Lopez", "awesome!"]
इटरेशन करना
-
map_values(filter) फंक्शन ऑब्जेक्ट की हर वैल्यू पर फिल्टर लागू करता है।
{first: "Jane", last: "Lopez", status: "awesome!"}
| map_values(ascii_upcase)
# => {"first": "JANE", "last": "LOPEZ", "status": "AWESOME!"}
-
किसी ऑब्जेक्ट पर इटरेशन करने के लिए, हमें पहले उसे की-वैल्यू ऑब्जेक्ट के ऐरे में बदलना होगा।
to_entries फंक्शन यही करता है।
{name: "Jane", age: 42} | to_entries'
# => [
# {
# "key": "name",
# "value": "Jane"
# },
# {
# "key": "age",
# "value": 42
# }
# ]
अब हम ऐरे पर इटरेशन करने वाले फंक्शन, जैसे map, उपयोग कर सकते हैं।
-
from_entries फंक्शन इसका उल्टा है: की-वैल्यू ऑब्जेक्ट के ऐरे को ऑब्जेक्ट में बदलना।
[
{"key":"name", "value":"Jane"},
{"key":"age", "value":42}
] | from_entries # =>{"name": "Jane", "age": 42}
-
ऑब्जेक्ट में हर की-वैल्यू जोड़े पर फिल्टर लागू करने के लिए, with_entries(filter) फंक्शन का उपयोग कीजिए।
उदाहरण के लिए, मान लीजिए एक ऑब्जेक्ट है जो नाम को उम्र से जोड़ता है, तो की और वैल्यू को इस तरह आपस में बदला जा सकता है।
{"Jane": 42, "Richard": 54}
| with_entries({key: (.value | tostring), value: .key})
इसका आउटपुट है
{
"42": "Jane",
"54": "Richard"
}
with_entries(filter) वही है जो
to_entries | map(filter) | from_entries
सीखने का अभ्यास
