duplocale

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

duplocale - ロケールオブジェクトを複製する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <locale.h>

locale_t duplocale(locale_t locobj);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

duplocale():

    Since glibc 2.10:
        _XOPEN_SOURCE >= 700
    Before glibc 2.10:
        _GNU_SOURCE
 

説明

duplocale() 関数は locobj が参照するロケールオブジェクトの複製を作成する。

locobj が LC_GLOBAL_LOCALE の場合、 duplocale() は setlocale(3) により判定されたグローバルロケールのコピーを含むロケールオブジェクトを作成する。  

返り値

On success, duplocale() returns a handle for the new locale object. On error, it returns (locale_t) 0, and sets errno to indicate the error.  

エラー

ENOMEM
ロケールオブジェクトの複製を作成するのに十分なメモリーがない。
 

標準規格

POSIX.1-2008.  

歴史

glibc 2.3.  

注意

ロケールの複製は以下のことを行う際に役立つ。
•
ロケールオブジェクトのコピーを作成し、 (newlocale(3) を使って) いくつかのカテゴリーだけを変更する。
•
現在のロケールに対するハンドルを取得する。 このハンドルはロケールハンドルを受け取る他の関数 (toupper_l(3) など) で使用できる。 これを行うには、 以下の呼び出しが返した値を duplocale() に渡せばよい。
loc = uselocale((locale_t) 0);
上記の uselocale(3) の呼び出しは値 LC_GLOBAL_LOCALE を返すことがあり、 この値を toupper_l(3) などの関数に渡した場合の動作は不定なので、 この方法は必要である。 duplocale() を呼び出すことで、確実に LC_GLOBAL_LOCALE が使用可能なロケールオブジェクトに変換することができる。 下記の「例」を参照。

duplocale() で作成された各ロケールオブジェクトは freelocale(3) を使って解放すべきである。  

例

以下のプログラムでは、 toupper_l(3) に渡す現在のロケールのハンドルを取得するのに uselocale(3) と duplocale() を使用する。 このプログラムはコマンドライン引数として文字列を一つ取る。この文字列は、大文字に変換され、標準出力に表示される。 以下は使用例である。

$ ./a.out abc;
ABC
 

プログラムのソース

#define _XOPEN_SOURCE 700
#include <ctype.h>
#include <err.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>

int
main(int argc, char *argv[])
{
    locale_t loc, nloc;

    if (argc != 2) {
        fprintf(stderr, "Usage: %s string\n", argv[0]);
        exit(EXIT_FAILURE);
    }

    /* This sequence is necessary, because uselocale() might return
       the value LC_GLOBAL_LOCALE, which can't be passed as an
       argument to toupper_l().  */

    loc = uselocale((locale_t) 0);
    if (loc == (locale_t) 0)
        err(EXIT_FAILURE, "uselocale");

    nloc = duplocale(loc);
    if (nloc == (locale_t) 0)
        err(EXIT_FAILURE, "duplocale");

    for (char *p = argv[1]; *p; p++)
        putchar(toupper_l(*p, nloc));

    printf("\n");

    freelocale(nloc);

    exit(EXIT_SUCCESS);
}
 

関連項目

freelocale(3), newlocale(3), setlocale(3), uselocale(3), locale(5), locale(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
標準規格
歴史
注意
例
プログラムのソース
関連項目

This document was created by man2html, using the manual pages.