एक्सएमएल Element
नोड का इलस्ट्रेशन.
// Adds up the values listed in a sample XML document and adds a new element with the total. var xml = '<things>' + '<plates>12</plates>' + '<bowls>18</bowls>' + '<cups>25</cups>' + '</things>'; var document = XmlService.parse(xml); var root = document.getRootElement(); var items = root.getChildren(); var total = 0; for (var i = 0; i < items.length; i++) { total += Number(items[i].getText()); } var totalElement = XmlService.createElement('total').setText(total); root.addContent(totalElement); xml = XmlService.getPrettyFormat().format(document); Logger.log(xml);
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
addContent(content) | Element | दिए गए नोड को Element नोड के आखिरी चाइल्ड के रूप में जोड़ता है. |
addContent(index, content) | Element | दिए गए नोड को सभी नोड के बीच में डालता है, जो Element नोड से तुरंत जुड़े होते हैं. |
cloneContent() | Content[] | उन सभी नोड की ऐसी कॉपी बनाता है जो अटैच नहीं हैं जो {@code Element} नोड के मौजूदा चाइल्ड नोड से जुड़े हैं. |
detach() | Content | नोड को उसके पैरंट Element नोड से अलग करता है. |
getAllContent() | Content[] | उन सभी नोड की जानकारी देता है जो {@code Element} नोड से तुरंत जुड़े हैं. |
getAttribute(name) | Attribute | इस Element नोड के लिए एट्रिब्यूट को, दिए गए नाम के साथ मिलता है. इसमें कोई नेमस्पेस नहीं होता. |
getAttribute(name, namespace) | Attribute | दिए गए नाम और नेमस्पेस के साथ, इस Element नोड के लिए एट्रिब्यूट मिलता है. |
getAttributes() | Attribute[] | इस Element नोड के सभी एट्रिब्यूट उसी क्रम में दिखाता है जिस क्रम में वे दस्तावेज़ में दिखते हैं. |
getChild(name) | Element | दिए गए नाम वाला पहला Element नोड पाता है. इसमें कोई ऐसा नेमस्पेस नहीं होता जो इस Element नोड का मौजूदा चाइल्ड नोड हो. |
getChild(name, namespace) | Element | दिए गए नाम और नेमस्पेस के साथ पहला Element नोड पाता है, जो इस Element नोड का तुरंत चाइल्ड है. |
getChildText(name) | String | अगर नोड, Element नोड का इंटरमीडिएट चाइल्ड है, तो दिए गए नाम के साथ नोड की टेक्स्ट वैल्यू मिलती है और इसमें कोई नेमस्पेस नहीं होता. |
getChildText(name, namespace) | String | अगर नोड, Element नोड का तुरंत चाइल्ड है, तो दिए गए नाम और नेमस्पेस के साथ नोड का टेक्स्ट वैल्यू पाता है. |
getChildren() | Element[] | सभी Element नोड दिखाता है, जो इस Element नोड से जुड़े हुए हैं. ये उसी क्रम में होते हैं जिस क्रम में वे दस्तावेज़ में दिखते हैं. |
getChildren(name) | Element[] | इसमें, दिए गए नाम वाले सभी Element नोड मिलते हैं. साथ ही, ऐसा कोई नेमस्पेस भी नहीं होता जो इस Element नोड के तुरंत चाइल्ड हो. ऐसा उस क्रम में होता है जिस क्रम में वे दस्तावेज़ में दिखते हैं. |
getChildren(name, namespace) | Element[] | दिए गए नाम और नेमस्पेस वाले सभी Element नोड दिखाता है, जो इस Element नोड के तुरंत चाइल्ड हैं. ये उसी क्रम में होते हैं जिस क्रम में वे दस्तावेज़ में दिखते हैं. |
getContent(index) | Content | यह फ़ंक्शन, दिए गए इंडेक्स पर उन सभी नोड के बीच नोड हासिल करता है जो {@code Element} नोड से तुरंत जुड़े हैं. |
getContentSize() | Integer | उन नोड की संख्या का पता लगाता है जो {@code Element} नोड के तुरंत चाइल्ड नोड हैं. |
getDescendants() | Content[] | इसमें वे सभी नोड मिलते हैं जो {@code Element} नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड हैं. |
getDocument() | Document | उस एक्सएमएल दस्तावेज़ को पाता है जिसमें {@code Element} नोड शामिल होता है. |
getName() | String | Element नोड का लोकल नाम पाता है. |
getNamespace() | Namespace | Element नोड के लिए नेमस्पेस की जानकारी देता है. |
getNamespace(prefix) | Namespace | Element नोड के लिए दिए गए प्रीफ़िक्स वाला नेमस्पेस पाता है. |
getParentElement() | Element | नोड के पैरंट Element नोड को पाता है. |
getQualifiedName() | String | Element नोड के लोकल नाम और नेमस्पेस के प्रीफ़िक्स [namespacePrefix]:[localName] के तौर पर मिलता है. |
getText() | String | Element नोड की टेक्स्ट वैल्यू दिखाता है. |
getValue() | String | उन सभी नोड की टेक्स्ट वैल्यू दिखाता है जो नोड से सीधे तौर पर या सीधे तौर पर नहीं जुड़ी हैं. यह उसी क्रम में होती है जिस क्रम में वे दस्तावेज़ में दिखती हैं. |
isAncestorOf(other) | Boolean | इससे पता चलता है कि यह Element नोड, किसी Element नोड का डायरेक्ट या इनडायरेक्ट पैरंट है. |
isRootElement() | Boolean | इससे पता चलता है कि Element नोड, दस्तावेज़ का रूट नोड है या नहीं. |
removeAttribute(attribute) | Boolean | अगर ऐसा कोई एट्रिब्यूट मौजूद है, तो इस Element नोड के लिए दिए गए एट्रिब्यूट को हटा देता है. |
removeAttribute(attributeName) | Boolean | अगर ऐसा कोई एट्रिब्यूट मौजूद है, तो दिए गए नाम और बिना नेमस्पेस के इस Element नोड के लिए एट्रिब्यूट को हटाता है. |
removeAttribute(attributeName, namespace) | Boolean | अगर ऐसा कोई एट्रिब्यूट मौजूद है, तो दिए गए नाम और नेमस्पेस के साथ इस Element नोड के लिए एट्रिब्यूट को हटा देता है. |
removeContent() | Content[] | उन सभी नोड को हटाता है जो {@code Element} नोड के तुरंत चाइल्ड नोड हैं. |
removeContent(content) | Boolean | अगर नोड {@code Element} नोड का तुरंत चाइल्ड नोड है, तो दिए गए नोड को हटा देता है. |
removeContent(index) | Content | दिए गए इंडेक्स से उन सभी नोड में से नोड को हटाता है जो {@code Element} नोड के करीबी से जुड़े हैं. |
setAttribute(attribute) | Element | इस Element नोड के लिए दिए गए एट्रिब्यूट को सेट करता है. |
setAttribute(name, value) | Element | इस Element नोड के लिए एट्रिब्यूट को दिए गए नाम, वैल्यू, और बिना किसी नेमस्पेस के सेट करता है. |
setAttribute(name, value, namespace) | Element | इस Element नोड के लिए एट्रिब्यूट को दिए गए नाम, वैल्यू, और नेमस्पेस के साथ सेट करता है. |
setName(name) | Element | Element नोड का स्थानीय नाम सेट करता है. |
setNamespace(namespace) | Element | Element नोड के लिए नेमस्पेस सेट करता है. |
setText(text) | Element | Element नोड की टेक्स्ट वैल्यू सेट करता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
addContent(content)
दिए गए नोड को Element
नोड के आखिरी चाइल्ड के रूप में जोड़ता है. content
तर्क, Element
ऑब्जेक्ट या ऐसा कोई भी नोड ऑब्जेक्ट हो सकता है जो ContentType
में दिए गए टाइप से जुड़ा हो.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
content | Content | जोड़ने के लिए नोड |
रिटर्न
चेन बनाने के लिए, Element
— Element
नोड
addContent(index, content)
दिए गए नोड को सभी नोड के बीच में डालता है, जो Element
नोड से तुरंत जुड़े होते हैं. content
आर्ग्युमेंट, Element
ऑब्जेक्ट या
कोई ऐसा नोड ऑब्जेक्ट हो सकता है जो ContentType
में दिए गए टाइप से जुड़ा हो.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
index | Integer | वह इंडेक्स जिस पर नोड को उन सभी नोड के बीच डालना है जो Element नोड से तुरंत जुड़े हैं |
content | Content | वह नोड जिसे शामिल करना है |
रिटर्न
चेन बनाने के लिए, Element
— Element
नोड
cloneContent()
उन सभी नोड की ऐसी कॉपी बनाता है जो अटैच नहीं हैं जो {@code Element} नोड के मौजूदा चाइल्ड नोड से जुड़े हैं.
रिटर्न
Content[]
— सभी नोड की अटैच नहीं की गई कॉपी की कैटगरी, जो
{@code Element} नोड के तुरंत चाइल्ड हैं
detach()
getAllContent()
उन सभी नोड की जानकारी देता है जो {@code Element} नोड से तुरंत जुड़े हैं.
रिटर्न
Content[]
— उन सभी नोड का कलेक्शन जो {@code Element} नोड के तुरंत चाइल्ड नोड हैं
getAttribute(name)
इस Element
नोड के लिए एट्रिब्यूट को, दिए गए नाम के साथ मिलता है. इसमें कोई नेमस्पेस नहीं होता. अगर ऐसा कोई एट्रिब्यूट नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | एट्रिब्यूट का नाम |
रिटर्न
Attribute
— एट्रिब्यूट या null
अगर दिए गए नाम वाला कोई एट्रिब्यूट न हो और
कोई नेमस्पेस न हो
getAttribute(name, namespace)
दिए गए नाम और नेमस्पेस के साथ, इस Element
नोड के लिए एट्रिब्यूट मिलता है. अगर ऐसा कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | एट्रिब्यूट का नाम |
namespace | Namespace | एट्रिब्यूट का नेमस्पेस |
रिटर्न
Attribute
— एट्रिब्यूट या null
अगर दिए गए नाम और नेमस्पेस वाला कोई एट्रिब्यूट न हो
getAttributes()
इस Element
नोड के सभी एट्रिब्यूट उसी क्रम में दिखाता है जिस क्रम में वे दस्तावेज़ में दिखते हैं.
रिटर्न
Attribute[]
— इस Element
नोड के लिए सभी एट्रिब्यूट की कैटगरी
getChild(name)
दिए गए नाम वाला पहला Element
नोड पाता है. इसमें कोई ऐसा नेमस्पेस नहीं होता जो इस Element
नोड का मौजूदा चाइल्ड नोड हो. अगर ऐसा कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | चाइल्ड Element नोड का नाम |
रिटर्न
Element
— Element
नोड या null
, अगर दिए गए नाम और बिना नेमस्पेस वाला कोई चाइल्ड Element
नोड न हो
getChild(name, namespace)
दिए गए नाम और नेमस्पेस के साथ पहला Element
नोड पाता है, जो इस Element
नोड का तुरंत चाइल्ड है. अगर ऐसा कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | चाइल्ड Element नोड का नाम |
namespace | Namespace | चाइल्ड Element नोड का नेमस्पेस |
रिटर्न
Element
— Element
नोड या null
, अगर दिए गए नाम और नेमस्पेस वाला Element
नोड तुरंत नहीं है
getChildText(name)
अगर नोड, Element
नोड का इंटरमीडिएट चाइल्ड है, तो दिए गए नाम के साथ नोड की टेक्स्ट वैल्यू मिलती है और इसमें कोई नेमस्पेस नहीं होता. अगर ऐसा कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | चाइल्ड नोड का नाम |
रिटर्न
String
— चाइल्ड नोड की टेक्स्ट वैल्यू या null
अगर दिए गए नाम और बिना नेमस्पेस वाला
तुरंत चाइल्ड नोड नहीं है
getChildText(name, namespace)
अगर नोड, Element
नोड का तुरंत चाइल्ड है, तो दिए गए नाम और नेमस्पेस के साथ नोड का टेक्स्ट वैल्यू पाता है. अगर ऐसा कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | चाइल्ड नोड का नाम |
namespace | Namespace | चाइल्ड नोड का नेमस्पेस |
रिटर्न
String
— चाइल्ड नोड की टेक्स्ट वैल्यू या null
, अगर दिए गए नाम और नेमस्पेस के साथ
तुरंत कोई चाइल्ड नोड नहीं होता
getChildren()
सभी Element
नोड दिखाता है, जो इस Element
नोड से जुड़े हुए हैं. ये उसी क्रम में होते हैं जिस क्रम में वे दस्तावेज़ में दिखते हैं.
रिटर्न
Element[]
— सभी Element
नोड की कैटगरी, जो इस Element
नोड के तुरंत चाइल्ड हैं
getChildren(name)
इसमें, दिए गए नाम वाले सभी Element
नोड मिलते हैं. साथ ही, ऐसा कोई नेमस्पेस भी नहीं होता जो इस Element
नोड के तुरंत चाइल्ड हो. ऐसा उस क्रम में होता है जिस क्रम में वे दस्तावेज़ में दिखते हैं.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | चाइल्ड Element नोड का नाम |
रिटर्न
Element[]
— दिए गए नाम वाले सभी Element
नोड का कलेक्शन. इसमें कोई ऐसा नेमस्पेस नहीं है जो
इस Element
नोड के मौजूदा चाइल्ड नोड हों
getChildren(name, namespace)
दिए गए नाम और नेमस्पेस वाले सभी Element
नोड दिखाता है, जो इस Element
नोड के तुरंत चाइल्ड हैं. ये उसी क्रम में होते हैं जिस क्रम में वे दस्तावेज़ में दिखते हैं.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | चाइल्ड Element नोड का नाम |
namespace | Namespace | चाइल्ड Element नोड का नेमस्पेस |
रिटर्न
Element[]
— दिए गए नाम और नेमस्पेस वाले सभी Element
नोड की कैटगरी, जो
इस Element
नोड के तुरंत चाइल्ड हैं
getContent(index)
यह फ़ंक्शन, दिए गए इंडेक्स पर उन सभी नोड के बीच नोड हासिल करता है जो
{@code Element} नोड से तुरंत जुड़े हैं. अगर दिए गए इंडेक्स में कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
index | Integer | उन सभी नोड में से नोड के लिए इंडेक्स जो {@code Element} नोड से तुरंत जुड़े हैं |
रिटर्न
Content
— नोड या अगर दिए गए इंडेक्स में कोई नोड नहीं है, तो null
getContentSize()
उन नोड की संख्या का पता लगाता है जो {@code Element} नोड के तुरंत चाइल्ड नोड हैं.
रिटर्न
Integer
— उन नोड की संख्या जो {@code Element} नोड के तुरंत से जुड़े हैं
getDescendants()
इसमें वे सभी नोड मिलते हैं जो {@code Element} नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड हैं.
रिटर्न
Content[]
— उन सभी नोड की कैटगरी जो {@code Element} नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड हैं
getDocument()
उस एक्सएमएल दस्तावेज़ को पाता है जिसमें {@code Element} नोड शामिल होता है.
रिटर्न
Document
— वह दस्तावेज़ जिसमें {@code Element} नोड शामिल है
getName()
Element
नोड का लोकल नाम पाता है. अगर नोड में नेमस्पेस प्रीफ़िक्स है, तो getQualifiedName()
या getNamespace()
का इस्तेमाल करें.प्रीफ़िक्स
पाने के लिए getPrefix()
.
रिटर्न
String
— Element
नोड का स्थानीय नाम
getNamespace()
getNamespace(prefix)
Element
नोड के लिए दिए गए प्रीफ़िक्स वाला नेमस्पेस पाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
prefix | String | नेमस्पेस के लिए प्रीफ़िक्स |
रिटर्न
Namespace
— Element
नोड के लिए दिए गए प्रीफ़िक्स वाला नेमस्पेस
getParentElement()
getQualifiedName()
Element
नोड के लोकल नाम और नेमस्पेस के प्रीफ़िक्स [namespacePrefix]:[localName]
के तौर पर मिलता है. अगर नोड में नेमस्पेस प्रीफ़िक्स नहीं है, तो getName()
का इस्तेमाल करें.
रिटर्न
String
— Element
नोड के लोकल नाम और नेमस्पेस प्रीफ़िक्स, [namespacePrefix]:[localName]
फ़ॉर्म में
getText()
Element
नोड की टेक्स्ट वैल्यू दिखाता है.
रिटर्न
String
— Element
नोड की टेक्स्ट वैल्यू
getValue()
उन सभी नोड की टेक्स्ट वैल्यू दिखाता है जो नोड से सीधे तौर पर या सीधे तौर पर नहीं जुड़ी हैं. यह उसी क्रम में होती है जिस क्रम में वे दस्तावेज़ में दिखती हैं.
रिटर्न
String
— उन सभी नोड की टेक्स्ट वैल्यू जो नोड के डायरेक्ट या इनडायरेक्ट चाइल्ड हैं
isAncestorOf(other)
इससे पता चलता है कि यह Element
नोड, किसी Element
नोड का डायरेक्ट या इनडायरेक्ट पैरंट है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
other | Element | दूसरा Element नोड |
रिटर्न
Boolean
— true
, अगर यह Element
नोड, दिए गए Element
नोड का डायरेक्ट या इनडायरेक्ट पैरंट है, तो false
नहीं
isRootElement()
इससे पता चलता है कि Element
नोड, दस्तावेज़ का रूट नोड है या नहीं.
रिटर्न
Boolean
— true
, अगर Element
नोड दस्तावेज़ का रूट नोड है; अगर नहीं है, तो false
removeAttribute(attribute)
अगर ऐसा कोई एट्रिब्यूट मौजूद है, तो इस Element
नोड के लिए दिए गए एट्रिब्यूट को हटा देता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
attribute | Attribute | एट्रिब्यूट |
रिटर्न
Boolean
— true
, अगर एट्रिब्यूट मौजूद था और उसे हटा दिया गया था; अगर एट्रिब्यूट मौजूद नहीं है, तो false
removeAttribute(attributeName)
अगर ऐसा कोई एट्रिब्यूट मौजूद है, तो दिए गए नाम और बिना नेमस्पेस के इस Element
नोड के लिए एट्रिब्यूट को हटाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
attributeName | String | एट्रिब्यूट का नाम |
रिटर्न
Boolean
— true
, अगर एट्रिब्यूट मौजूद था और उसे हटा दिया गया था; अगर एट्रिब्यूट मौजूद नहीं है, तो false
removeAttribute(attributeName, namespace)
अगर ऐसा कोई एट्रिब्यूट मौजूद है, तो दिए गए नाम और नेमस्पेस के साथ इस Element
नोड के लिए एट्रिब्यूट को हटा देता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
attributeName | String | एट्रिब्यूट का नाम |
namespace | Namespace | एट्रिब्यूट का नेमस्पेस |
रिटर्न
Boolean
— true
, अगर एट्रिब्यूट मौजूद था और उसे हटा दिया गया था; अगर एट्रिब्यूट मौजूद नहीं है, तो false
removeContent()
उन सभी नोड को हटाता है जो {@code Element} नोड के तुरंत चाइल्ड नोड हैं.
रिटर्न
Content[]
— उन सभी नोड की कैटगरी जो हटाए जाने से पहले {@code Element} नोड के तुरंत चाइल्ड थे
removeContent(content)
अगर नोड {@code Element} नोड का तुरंत चाइल्ड नोड है, तो दिए गए नोड को हटा देता है. content
तर्क, Element
ऑब्जेक्ट या ऐसा कोई भी नोड ऑब्जेक्ट हो सकता है जो ContentType
में दिए गए टाइप से जुड़ा हो.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
content | Content | वह नोड जिसे हटाना है |
रिटर्न
Boolean
— true
अगर नोड हाल ही का चाइल्ड नोड था और इसे हटा दिया गया था, तो false
अगर नहीं था
removeContent(index)
दिए गए इंडेक्स से उन सभी नोड में से नोड को हटाता है जो
{@code Element} नोड के करीबी से जुड़े हैं. अगर दिए गए इंडेक्स में कोई नोड नहीं है, तो यह तरीका null
दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
index | Integer | उन सभी नोड में से नोड के लिए इंडेक्स जो {@code Element} नोड से तुरंत जुड़े हैं |
रिटर्न
Content
— हटाया गया नोड या अगर दिए गए इंडेक्स में कोई नोड नहीं है, तो null
setAttribute(attribute)
setAttribute(name, value)
इस Element
नोड के लिए एट्रिब्यूट को दिए गए नाम, वैल्यू, और बिना किसी नेमस्पेस के सेट करता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | सेट की जाने वाली विशेषता का नाम |
value | String | सेट की जाने वाली विशेषता का मान |
रिटर्न
चेन बनाने के लिए, Element
— Element
नोड
setAttribute(name, value, namespace)
setName(name)
Element
नोड का स्थानीय नाम सेट करता है. नोड के लिए नेमस्पेस प्रीफ़िक्स सेट करने के लिए, XmlService.getNamespace(prefix, uri)
के साथ setNamespace(namespace)
का इस्तेमाल करें.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
name | String | सेट किया जाने वाला स्थानीय नाम |
रिटर्न
चेन बनाने के लिए, Element
— Element
नोड
setNamespace(namespace)
setText(text)
Element
नोड की टेक्स्ट वैल्यू सेट करता है. अगर नोड में पहले से ही कोई टेक्स्ट वैल्यू या
कोई चाइल्ड नोड है, तो यह तरीका पुराने कॉन्टेंट को ओवरराइट कर देता है. इसके बजाय, कॉन्टेंट जोड़ने या शामिल करने के लिए,
addContent(content)
या addContent(index, content)
का इस्तेमाल करें.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
text | String | सेट किया जाने वाला टेक्स्ट |
रिटर्न
चेन बनाने के लिए, Element
— Element
नोड