confstr
Section: C Library Functions (3)
Updated: 2026-02-08
Index
JM Home Page
roff page
名前
confstr - コンフィグレーションに依存した文字列変数の取得
ライブラリ
標準 C ライブラリ (libc,~-lc)
書式
#include <unistd.h>
size_t confstr(size_t size;
int name, char buf[size], size_t size);
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
confstr():
_POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE
説明
confstr() はコンフィグレーションに依存した文字列変数の値を取得する。
引数 name は、問い合わせ内容を表すシステム変数である。 以下の変数がサポートされている。
- _CS_GNU_LIBC_VERSION (GNU C library 限定; glibc 2.3.2 以降)
-
そのシステムの GNU C ライブラリのバージョンを示す文字列 (例えば "glibc 2.3.4")。
- _CS_GNU_LIBPTHREAD_VERSION (GNU C library 限定; glibc 2.3.2 以降)
-
その C ライブラリが提供している POSIX 実装を示す文字列 (例えば "NPTL 2.3.4" や "linuxthreads-0.10")。
- _CS_PATH
-
すべての POSIX.2 標準ユーティリティが見つかるような PATH の値。
If buf is not NULL and size is not zero, confstr() copies the
value of the string to buf truncated to size - 1 bytes if necessary,
with a null byte ('\0') as terminator. This can be detected by
comparing the return value of confstr() against size.
If size is zero and buf is NULL, confstr() just returns the value
as defined below.
返り値
If name is a valid configuration variable, confstr() returns the
number of bytes (including the terminating null byte) that would be
required to hold the entire value of that variable. This value may be
greater than size, which means that the value in buf is truncated.
name が有効なコンフィギュレーション変数だが、 変数が値を持っていない場合、 confstr() は 0 を返す。 name
が有効なコンフィグレーション変数に対応していなければ、 confstr() は 0 を返し、 errno に EINVAL
を設定する。
エラー
- EINVAL
-
name の値が不正である。
属性
この節で使用されている用語の説明については、 attributes(7) を参照。
| インターフェース | 属性 | 値
|
|
confstr()
| Thread safety | MT-Safe
|
標準規格
POSIX.1-2008.
歴史
POSIX.1-2001.
例
次の部分的なコードは、 POSIX.2 システムのユーティリティがあるパス を取得するものである。
char *pathbuf;
size_t n;
n = confstr(_CS_PATH, NULL, (size_t) 0);
pathbuf = malloc(n);
if (pathbuf == NULL)
abort();
confstr(_CS_PATH, pathbuf, n);
関連項目
getconf(1), sh(1), exec(3), fpathconf(3), pathconf(3),
sysconf(3), system(3)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 属性
-
- 標準規格
-
- 歴史
-
- 例
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.