language-tags

 * @author Matthew Caruana Galizia <m@m.cg>

 * @license MIT: http://mattcg.mit-license.org/

var index = require('language-subtag-registry/data/json/index');

var registry = require('language-subtag-registry/data/json/registry');

	// Lowercase for consistency (case is only a formatting convention, not a standard requirement).

		error(Subtag.ERR_NONEXISTENT, 'Non-existent subtag \'' + subtag + '\'.');

		error(Subtag.ERR_NONEXISTENT, 'Non-existent subtag \'' + subtag + '\' of type \'' + type + '\'.');

		error(Subtag.ERR_TAG, '\'' + subtag + '\' is a \'' + type + '\' tag.');

Subtag.prototype.descriptions = function() {

	// Every record has one or more descriptions (stored as an array).

Subtag.prototype.preferred = function() {

	var type, preferred = this.data.record['Preferred-Value'];

	var script = this.data.record['Suppress-Script'];

Subtag.prototype.deprecated = function() {

	return this.data.record.Deprecated || null;

	// Comments don't always occur for records, so switch to an empty array if missing.

		return subtag[0].toUpperCase() + subtag.substr(1);

	"description": "Work with IANA language tags.",

	"homepage": "https://github.com/mattcg/language-tags",

		"url": "git://github.com/mattcg/language-tags.git"

			"url": "http://mattcg.mit-license.org/"

[![Build Status](https://travis-ci.org/mattcg/language-tags.png?branch=master)](https://travis-ci.org/mattcg/language-tags)

[![Coverage Status](https://coveralls.io/repos/mattcg/language-tags/badge.png)](https://coveralls.io/r/mattcg/language-tags)

Based on [BCP 47](http://tools.ietf.org/html/bcp47) ([RFC 5646](http://tools.ietf.org/html/rfc5646)) and the latest [IANA language subtag registry](http://www.iana.org/assignments/language-subtag-registry).

This project will be updated as the standards change.

See the [language-subtag-registry](https://github.com/mattcg/language-subtag-registry) project for the underlying JSON data.

Note that all lookups and checks for tags and subtags are case insensitive. For formatting according to common conventions, see `tag.format`.

Check whether a hyphen-separated tag is valid and well-formed. Always returns a `Tag`, which can be checked using the `valid` method.

Shortcut for `tags(tag).valid()`. Return `true` if the tag is valid, `false` otherwise. For meaningful error output see `tag.errors()`.

### tags.subtags(subtag), tags.subtags(subtags) ###

Look up one or more subtags. Returns an array of `Subtag` objects. Returns an empty array if all of the subtags are non-existent.

Calling `tags.subtags('mt')` will return an array with two `Subtag` objects: one for Malta (the 'region' type subtag) and one for Maltese (the 'language' type subtag).

To get or check a single subtag by type use `tags.language(subtag)`, `tags.region(subtag)` or `tags.type(subtag, type)`.

The opposite of `tags.subtags(subtags)`. Returns an array of codes that are not registered subtags, otherwise returns an empty array.

Search for tags and subtags by description. Supports either a RegExp object or a string for `description`. Returns an array of `Subtag` and `Tag` objects or an empty array if no results were found.

Note that `Tag` objects in the results represent 'grandfathered' or 'redundant' tags. These are excluded by default. Set the `all` parameter to `true` to include them.

Search is case-insensitive if `description` is a string.

Returns an array of `Subtag` objects representing all the 'language' type subtags belonging to the given 'macrolanguage' type subtag.

Throws an error if `macrolanguage` is not a macrolanguage.

Error: 'en' is not a valid macrolanguage.

Convenience method to get a single 'language' type subtag. Can be used to validate an input value as a language subtag. Returns a `Subtag` object or `null`.

As above, but with 'region' type subtags.

Get a subtag by type. Returns the subtag matching `type` as a `Subtag` object otherwise returns `null`.

- [Python version by the Flanders Heritage Agency](https://github.com/OnroerendErfgoed/language-tags)

- [Language Subtag Lookup tool by Richard Ishida](http://rishida.net/utils/subtags/)

- [W3C Internationalization Checker](http://validator.w3.org/i18n-checker/)

- [RFC 5646](http://tools.ietf.org/html/rfc5646)

The software part of this project is licensed under an [MIT licence](http://mattcg.mit-license.org/).

Comments, feedback and suggestions are welcome. Please feel free to raise an issue or pull request. Enjoy.

		@@ -41,3 +41,3 @@ /**
		i = types[type];
		if (!i) {
		if (!i && 0 !== i) {
		error(Subtag.ERR_NONEXISTENT, 'Non-existent subtag \'' + subtag + '\' of type \'' + type + '\'.');
		@@ -44,0 +44,0 @@ }

		{
		"name": "language-tags",
		"version": "1.0.2",
		"version": "1.0.3",
		"implements": ["CommonJS/Modules/1.0"],
		@@ -5,0 +5,0 @@ "description": "Work with IANA language tags.",

		@@ -250,2 +250,3 @@ # IANA Language Tags for JavaScript #

		- [Python version by the Flanders Heritage Agency](https://github.com/OnroerendErfgoed/language-tags)
		- [Language Subtag Lookup tool by Richard Ishida](http://rishida.net/utils/subtags/)
		@@ -252,0 +253,0 @@ - [W3C Internationalization Checker](http://validator.w3.org/i18n-checker/)

Improved metrics