Locale Helper

Define the appropriate representation of a person’s name and title. The operand consists of a string, and can contain any combination of characters and field descriptors. In addition, the string can contain field descriptors defined below.

%f

Family names.

%F

Family names in uppercase.

%g

First given name.

%G

First given initial.

%l

First given name with latin letters. In some cultures, eg on Taiwan it is customary to also have a first name written with Latin letters, although the rest of the name is written in another script.

%o

Other shorter name, eg. "Bill".

%m

Additional given names.

%M

Initials for additional given names.

%p

Profession.

%s

Salutation, such as "Doctor"

%S

Abbreviated salutation, such as "Mr." or "Dr."

%d

Salutation, using the FDCC-sets conventions, with 1 for the name_gen, 2 for name_mr, 3 for name_mrs, 4 for name_miss, 5 for name_ms.

%t

If the preceding field descriptor resulted in an empty string, then the empty string, else a .

Each field descriptor may have an after the <%> to specify that the information is taken from a Romanized version string of the entity. An initial is any string, normally consisting of one letter and a punctuation mark; the Dutch "IJ" is an example of a two character initial.

Define the appropriate representation of a postal address such as street and city. The proper formatting of a person’s name and title is done with the "name_fmt" keyword of the LC_NAME category. The operand consists of a string, and can contain any combination of characters and field descriptors. In addition, the string can contain field descriptors defined below.

%n

Person’s name, possibly constructed with LC_NAME.

%a

Care of person, or organization.

%f

Firm name.

%d

Department name.

%b

Building name.

%s

Street or block (eg. Japanese) name.

%h

House number or designation.

%N

Insert an <end-of-line> if the previous descriptor’s value was not an empty string; otherwise ignore.

%t

Insert a <space> if the previous descriptor’s value was not an empty string; otherwise ignore.

%r

Room number, door designation.

%e

Floor number.

%C

Country designation, from the keyword.

%l

Local township within town or city

%z

Zip number, postal code.

%T

Town, city.

%S

State, province, or prefecture.

%c

Country, as taken from data record.

Each field descriptor may have an <R> after the <%> to specify that the information is taken from a Romanized version string of the entity.

NOTE: There are a number of variations for specifying a location among the cultures. Some of the information, like the middle names, or even the family name, is not used in some cultures. The specification here should be regarded as a starting point for this problem.