Royalty Title Style

Validate a rendered royal reference against supplied title-use policy.

Description

Royalty title style depends on the chosen title and name rendering.

Royalty title style depends on the chosen title and name rendering. This checker constructs an expected string and separately counts title repetitions.^[1]

Validate a rendered royal reference against supplied title-use policy.

When to use Royalty Title Style

Use this tool to validate a rendered royal reference against supplied title-use policy.

Prepare the text, recorded observations, aligned figures or editorial criteria requested. Confirm what each label, count, timestamp or supplied flag represents before interpreting the result.

How to use Royalty Title Style and understand its results

Prepare the text, recorded observations, aligned figures or editorial criteria requested. Confirm what each label, count, timestamp or supplied flag represents before interpreting the result.
Enter royalTitle, personName, renderedReference, titleRequired using the field table and calculation rules, then run the tool.
Read expectedReference, matchesExpected, titleOccurrenceCount. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
royalTitle	Royal title	string	Required
personName	Person name	string	Required
renderedReference	Rendered reference	string	Required
titleRequired	Title required on this reference	boolean	Required

Enter a nonblank name, title, rendered text and title-required flag. Trim title/name/rendering; compare expected text exactly. Count case-sensitive, nonoverlapping title substrings in the rendering; a blank title has zero occurrences.

expected=requireTitle ? trim(title)+space+trim(name) : trim(name)

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
expectedReference	Expected reference	string
matchesExpected	Matches expected reference	boolean
titleOccurrenceCount	Title occurrence count	integer; minimum: 0

json

{
  "input": {
    "royalTitle": "King",
    "personName": "Charles III",
    "renderedReference": "King Charles III",
    "titleRequired": true
  },
  "output": {
    "expectedReference": "King Charles III",
    "matchesExpected": true,
    "titleOccurrenceCount": 1
  }
}

Limitations and assumptions

No royal rank, honorific convention or publication style is inferred. Title matching has no word boundaries.

Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Extremely large text inputs are rejected. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors. A successfully returned false flag is an evaluated outcome; its meaning is explained above.

Alternative or Complementary methods

Use Religious Title Style: Validate a religious-title reference against supplied title-use policy. For a complementary task, use Military Rank Style: Validate a military-rank reference against supplied full or abbreviated form.

References

Royalty Title Style — tool.io

Similar or alternative tools

Religious Title Style
Validate a religious-title reference against supplied title-use policy.
Military Rank Style
Validate a military-rank reference against supplied full or abbreviated form.