182 lines
12 KiB
HTML
182 lines
12 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="concept" />
|
|
<meta name="DC.Title" content="Locale categories" />
|
|
<meta name="abstract" content="This table describes the locale categories that are supported on i5/OS." />
|
|
<meta name="description" content="This table describes the locale categories that are supported on i5/OS." />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslocale.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslccollatecategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslcctypecategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslcmessagescategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslcmonetarycategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslcnumericcategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslctimecategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslctodcategory.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagssyssuplocalesourcedef.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagsposixexample.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbagslocaleprogexamp.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rbagslocalecatdetail" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Locale categories</title>
|
|
</head>
|
|
<body id="rbagslocalecatdetail"><a name="rbagslocalecatdetail"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Locale categories</h1>
|
|
<div><p>This table describes the locale categories that are supported on i5/OS™.</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" id="d0e27">Locale category</th>
|
|
<th valign="top" id="d0e29">Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" headers="d0e27 ">LC_COLLATE</td>
|
|
<td valign="top" headers="d0e29 ">Defines character or string collation information</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e27 ">LC_CTYPE</td>
|
|
<td valign="top" headers="d0e29 ">Defines character classification, case conversion, and other character
|
|
attributes.</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e27 ">LC_MESSAGES</td>
|
|
<td valign="top" headers="d0e29 ">Defines the format for affirmative and negative responses.</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e27 ">LC_MONETARY</td>
|
|
<td valign="top" headers="d0e29 ">Defines rules and symbols for formatting monetary numeric information.</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e27 ">LC_NUMERIC</td>
|
|
<td valign="top" headers="d0e29 ">Defines a list of rules and symbols for formatting non-monetary numeric
|
|
information.</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e27 ">LC_TIME</td>
|
|
<td valign="top" headers="d0e29 ">Defines a list of rules and symbols for formatting time and date information.</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e27 ">LC_TOD</td>
|
|
<td valign="top" headers="d0e29 ">Defines rules for daylight saving time and time zone information.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note"><span class="notetitle">Note:</span> A locale source file cannot contain duplicate categories.</div>
|
|
<div class="section" id="rbagslocalecatdetail__HDRLOCALECATDETAIL"><a name="rbagslocalecatdetail__HDRLOCALECATDETAIL"><!-- --></a><h4 class="sectiontitle">Locale category source definitions:</h4><p>The
|
|
category source definition consists of:</p>
|
|
<ul><li>The category header (<var class="varname">category name</var>), where the category
|
|
name must be all uppercase characters.</li>
|
|
<li>The associated keyword/value pairs that comprise the category body. Keywords
|
|
can be all uppercase, all lowercase, or mixed case characters.</li>
|
|
<li>The category trailer (which consists of END <var class="varname">category-name</var>)</li>
|
|
</ul>
|
|
<p>For example:</p>
|
|
<pre><span class="uicontrol">LC_CTYPE</span>
|
|
<var class="varname">source for LC_CTYPE category</var>
|
|
<span class="uicontrol">END LC_CTYPE</span></pre>
|
|
<p>Lines preceding
|
|
the first category header can be used to change the comment character and
|
|
the escape character. The comment_char (the default is #) and escape_char
|
|
(the default is \) keywords can be used to change these characters. The following
|
|
example shows how to change the comment character and escape character to
|
|
* and / :</p>
|
|
<pre>comment_char <asterisk>
|
|
escape_char <slash></pre>
|
|
<div class="note"><span class="notetitle">Note:</span> This example uses symbolic names
|
|
to represent the '*' and '/' characters.</div>
|
|
<p>The source for all categories
|
|
is specified using the following:</p>
|
|
<dl><dt class="dlterm">Keywords</dt>
|
|
<dd>Each keyword identifies either a definition or a rule. The remainder of
|
|
the statement containing the keyword contains the operands to the keyword.
|
|
Operands are separated from the keyword by one or more blank characters. A
|
|
statement may be continued on the next line by placing an escape_char as the
|
|
last character before the newline or linefeed character that ends the line. <p>Lines
|
|
containing the comment_char in the first column are treated as comment lines.
|
|
Comment lines cannot be continued on a subsequent line using an escape character.
|
|
\ is the default escape character. However, the escape character can be defined
|
|
to be any character by the user.</p>
|
|
</dd>
|
|
<dt class="dlterm">Strings</dt>
|
|
<dd>Strings must be enclosed in quotation marks. Quotation
|
|
marks within strings can be represented in two ways: <ul><li>Literally. The escape character can be followed by quotation
|
|
marks.</li>
|
|
<li>A symbolic name. For example, <quotation-mark>.</li>
|
|
</ul>
|
|
<p>A string can be continued on the next line by placing an escape_char
|
|
as the last character before the newline or linefeed character that ends the
|
|
line.</p>
|
|
<p>A string is a sequence of character symbols or literals enclosed
|
|
by quotation ("") characters. For example:</p>
|
|
<pre>"<A><B><C>"</pre>
|
|
</dd>
|
|
<dt class="dlterm">Character literals</dt>
|
|
<dd>A character literal is the character itself.</dd>
|
|
<dt class="dlterm">Character symbols</dt>
|
|
<dd>A character symbol begins with the < (less-than) character, followed
|
|
by non-control characters, and ends with the > (greater-than) character.
|
|
For example, <A> is a valid character symbol (symbolic name). Any character
|
|
symbol referenced in the source file should be one of the predefined system-supplied
|
|
symbols. The system-supplied symbolic names are in the source file member
|
|
QLGSYMBOL in the QLOCALESRC source file in the optionally installable library
|
|
QSYSLOCALE. <p>In the event that the system does not contain
|
|
a predefined symbolic name for a character, the UCS-2 level-1 format is allowed.
|
|
The UCS-2 format is based on the character set defined in ISO/IEC 10646. The
|
|
UCS-2 format may also be used in place of the predefined symbolic names. Here
|
|
is an example of the UCS-2 symbolic name format:</p>
|
|
<pre><Uxxxx></pre>
|
|
<p>where
|
|
'xxxx' are 4 hexadecimal digits. For example, <U0041>. The hexadecimal
|
|
number 0041 within this symbolic name is the UCS-2 code point that represents
|
|
the character 'A'.</p>
|
|
</dd>
|
|
</dl>
|
|
<p>Each locale category must be explicitly defined in a locale
|
|
definition source file.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rbagslccollatecategory.htm">LC_COLLATE category</a></strong><br />
|
|
The LC_COLLATE category defines character or string collation information.
|
|
Within LC_COLLATE you can specify a sort sequence to use using the cpysyscol
|
|
keyword. The <dfn class="term">cpysyscol</dfn> keyword value is used in place of the
|
|
LC_COLLATE category definitions.</li>
|
|
<li class="ulchildlink"><strong><a href="rbagslcctypecategory.htm">LC_CTYPE category</a></strong><br />
|
|
The LC_CTYPE category defines character classification, case conversion, and other character attributes.</li>
|
|
<li class="ulchildlink"><strong><a href="rbagslcmessagescategory.htm">LC_MESSAGES category</a></strong><br />
|
|
The LC_MESSAGES category of a locale definition source file defines the format for affirmative and negative system responses. This category begins with an LC_MESSAGES category header and ends with an END LC_MESSAGES category trailer.</li>
|
|
<li class="ulchildlink"><strong><a href="rbagslcmonetarycategory.htm">LC_MONETARY category</a></strong><br />
|
|
The LC_MONETARY category of a locale definition source file defines rules and symbols for formatting monetary numeric information. This category begins with an LC_MONETARY category header and ends with an END LC_MONETARY category trailer.</li>
|
|
<li class="ulchildlink"><strong><a href="rbagslcnumericcategory.htm">LC_NUMERIC category</a></strong><br />
|
|
LC_NUMERIC category of a locale definition source file defines rules and symbols for formatting non-monetary numeric information.</li>
|
|
<li class="ulchildlink"><strong><a href="rbagslctimecategory.htm">LC_TIME category</a></strong><br />
|
|
The LC_TIME category of a locale definition source file defines rules and symbols for formatting time and date information. This category begins with an LC_TIME category header and ends with an END LC_TIME category trailer.</li>
|
|
<li class="ulchildlink"><strong><a href="rbagslctodcategory.htm">LC_TOD category</a></strong><br />
|
|
The LC_TOD category defines the rules used to define the start
|
|
and end time of daylight saving time, the difference between local time and
|
|
Greenwich Mean time, the time zone name, and the daylight saving time name.
|
|
This category is an IBM<sup>®</sup> extension and must appear after all other category
|
|
definitions in the source file.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbagslocale.htm" title="Locales are used primarily in ILE-based application programs. Additionally, the Retrieve Locale Information (OPM, QLGRTVLC; ILE, QlgRetrieveLocaleInformation) API retrieves one or all categories of a locale.">Work with locales</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rbagssyssuplocalesourcedef.htm" title="The system-supplied locale source definition file members are in the optionally installable library QSYSLOCALE in the QLOCALESRC source file. The source file members are encoded in CCSID 37 and are read only.">System-supplied locales and recommended CCSIDs</a></div>
|
|
<div><a href="rbagsposixexample.htm" title="This example shows the POSIX (or C) locale categories and the source.">Example: POSIX locale</a></div>
|
|
<div><a href="rbagslocaleprogexamp.htm" title="In addition to the examples in this topic, The locale categories information provides programming examples for each of the different locale categories.">Examples: Locale programming</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |