Class ilib.Name

A class to parse names of people. Different locales have different conventions when it comes to naming people.

The options can contain any of the following properties:

locale - use the rules and conventions of the given locale in order to parse the name
style - explicitly use the named style to parse the name. Valid values so far are "western" and "asian". If this property is not specified, then the style will be gleaned from the name itself. This class will count the total number of Latin or Asian characters. If the majority of the characters are in one style, that style will be used to parse the whole name.
order - explicitly use the given order for names. In some locales, such as Russian, names may be written equally validly as "givenName familyName" or "familyName givenName". This option tells the parser which order to prefer, and overrides the default order for the locale. Valid values are "gf" (given-family) or "fg" (family-given).
useSpaces - explicitly specifies whether to use spaces or not between the given name , middle name and family name.
onLoad - a callback function to call when the name info is fully loaded and the name has been parsed. When the onLoad option is given, the name object will attempt to load any missing locale data using the ilib loader callback. When the constructor is done (even if the data is already preassembled), the onLoad function is called with the current instance as a parameter, so this callback can be used with preassembled or dynamic loading or a mix of the two.
sync - tell whether to load any missing locale data synchronously or asynchronously. If this option is given as "false", then the "onLoad" callback must be given, as the instance returned from this constructor will not be usable for a while.
loadParams - an object containing parameters to pass to the loader callback function when locale data is missing. The parameters are not interpretted or modified in any way. They are simply passed along. The object may contain any property/value pairs as long as the calling code is in agreement with the loader callback function as to what those parameters mean.

When the parser has completed its parsing, it fills in the fields listed below.

For names that include auxilliary words, such as the family name "van der Heijden", all of the auxilliary words ("van der") will be included in the field.

For names in Spanish locales, it is assumed that the family name is doubled. That is, a person may have a paternal family name followed by a maternal family name. All family names will be listed in the familyName field as normal, separated by spaces. When formatting the short version of such names, only the paternal family name will be used. Depends directive: !depends nameprs.js
Defined in: ilib-dyn-full.js.

Class Summary
Constructor Attributes	Constructor Name and Description
	ilib.Name(name, options)

Method Summary
Method Attributes	Method Name and Description
	clone()
	getSortFamilyName() When sorting names with auxiliary words (like "van der" or "de los"), determine which is the "head word" and return a string that can be easily sorted by head word.

Class Detail

ilib.Name(name, options)

Parameters:
{string|ilib.Name=} name: the name to parse
{Object=} options: Options governing the construction of this name instance

Method Detail

clone()

{string|undefined} getSortFamilyName()

When sorting names with auxiliary words (like "van der" or "de los"), determine which is the "head word" and return a string that can be easily sorted by head word. In English, names are always sorted by initial characters. In places like the Netherlands or Germany, family names are sorted by the head word of a list of names rather than the first element of that name.

Returns:: {string|undefined} a string containing the family name[s] to be used for sorting in the current locale, or undefined if there is no family name in this object

Classes

Class ilib.Name