summaryrefslogtreecommitdiff
path: root/includes/external/school/node_modules/xml-name-validator/README.md
diff options
context:
space:
mode:
authorMinteck <contact@minteck.org>2023-02-23 19:34:56 +0100
committerMinteck <contact@minteck.org>2023-02-23 19:34:56 +0100
commit3d1cd02f27518f1a04374c7c8320cd5d82ede6e9 (patch)
tree75be5fba4368472fb11c8015aee026b2b9a71888 /includes/external/school/node_modules/xml-name-validator/README.md
parent8cc1f13c17fa2fb5a4410542d39e650e02945634 (diff)
downloadpluralconnect-3d1cd02f27518f1a04374c7c8320cd5d82ede6e9.tar.gz
pluralconnect-3d1cd02f27518f1a04374c7c8320cd5d82ede6e9.tar.bz2
pluralconnect-3d1cd02f27518f1a04374c7c8320cd5d82ede6e9.zip
Updated 40 files, added 37 files, deleted 1103 files and renamed 3905 files (automated)
Diffstat (limited to 'includes/external/school/node_modules/xml-name-validator/README.md')
-rw-r--r--includes/external/school/node_modules/xml-name-validator/README.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/includes/external/school/node_modules/xml-name-validator/README.md b/includes/external/school/node_modules/xml-name-validator/README.md
new file mode 100644
index 0000000..eb413f9
--- /dev/null
+++ b/includes/external/school/node_modules/xml-name-validator/README.md
@@ -0,0 +1,36 @@
+# Validate XML Names and Qualified Names
+
+This package simply tells you whether or not a string matches the [`Name`](http://www.w3.org/TR/xml/#NT-Name) or [`QName`](http://www.w3.org/TR/xml-names/#NT-QName) productions in the XML Namespaces specification. We use it for implementing the [validate](https://dom.spec.whatwg.org/#validate) algorithm in jsdom, but you can use it for whatever you want.
+
+## Usage
+
+This package's main module's default export takes a string and will return an object of the form `{ success, error }`, where `success` is a boolean and if it is `false`, then `error` is a string containing some hint as to where the match went wrong.
+
+```js
+"use strict":
+var xnv = require("xml-name-validator");
+var assert = require("assert");
+
+// Will return { success: true, error: undefined }
+xnv.name("x");
+xnv.name(":");
+xnv.name("a:0");
+xnv.name("a:b:c");
+
+// Will return { success: false, error: <an explanatory string> }
+xnv.name("\\");
+xnv.name("'");
+xnv.name("0");
+xnv.name("a!");
+
+// Will return { success: true, error: undefined }
+xnv.qname("x");
+xnv.qname("a0");
+xnv.qname("a:b");
+
+// Will return { success: false, error: <an explanatory string> }
+xnv.qname(":a");
+xnv.qname(":b");
+xnv.qname("a:b:c");
+xnv.qname("a:0");
+```