Man page - sys_errlist(3)

Packages contains this manual

Available languages:

en fr ja ro de

Manual

PERROR

名 前
書 åŧ
čĒŦ 明
æē– 拠
æŗ¨ 意
é–ĸ 逪 項 į›Ž
こ ぎ 文 書 ãĢ つ い ãĻ

名 前

perror - ã‚ˇ ゚ テ ム エ ナ ãƒŧ ãƒĄ ッ ã‚ģ ãƒŧ ジ を å‡ē 力 す る

書 åŧ

#include <stdio.h>

void perror(const char * s );

#include <errno.h>

const char * const sys_errlist [];
int
sys_nerr ;
int
errno ; /* 原 際 ãĢ こ ぎ よ う ãĢ åŽŖ 言 さ れ ãĻ い る わ け で は ãĒ い 。 errno(3) 参 į…§ */

glibc 向 け ぎ 抟 čƒŊ 検 æŸģ マ ク ロ ぎ čρ äģļ ( feature_test_macros (7) 参 į…§ ):

sys_errlist , sys_nerr : _BSD_SOURCE

čĒŦ 明

é–ĸ 数 perror () は 、 ã‚ˇ ゚ テ ム ã‚ŗ ãƒŧ ãƒĢ や ナ イ ブ ナ ãƒĒ é–ĸ 数 ぎ å‘ŧ ãŗ å‡ē し ãĢ お い ãĻ 、 最 垌 ãĢ į™ē į”Ÿ し た エ ナ ãƒŧ ãĢ é–ĸ す る čĒŦ 明 ãƒĄ ッ ã‚ģ ãƒŧ ジ を į”Ÿ 成 し 、 標 æē– エ ナ ãƒŧ å‡ē 力 ãĢ å‡ē 力 す る 。 ( s が NULL で ãĒ く 、 *s が ヌ ãƒĢ バ イ ト ('\0') で ãĒ い å ´ 合 ãĢ は ) åŧ• き 数 ぎ 文 字 列 s が ぞ ず å‡ē 力 さ れ 、 įļš ã„ ãĻ ã‚ŗ ロ ãƒŗ 、 įŠē į™Ŋ が å‡ē 力 さ れ 、 そ れ か ら ãƒĄ ッ ã‚ģ ãƒŧ ジ と 攚 行 が å‡ē 力 さ れ る 。

こ ぎ ãƒĄ ッ ã‚ģ ãƒŧ ジ を 最 大 限 æ´ģ ᔍ す る た め ãĢ は 、 åŧ• き 数 文 字 列 ãĢ エ ナ ãƒŧ が į™ē į”Ÿ し た é–ĸ 数 名 を å…Ĩ れ ãĻ お く と よ い 。 エ ナ ãƒŧ į•Ē åˇ は 外 部 変 数 errno か ら 取 åž— さ れ る 。 errno は エ ナ ãƒŧ が į™ē į”Ÿ し た 時 ãĢ 設 厚 さ れ 、 成 功 し た å‘ŧ ãŗ å‡ē し で は ク ãƒĒ ã‚ĸ さ れ ãĒ い 。

大 域 変 数 ぎ エ ナ ãƒŧ ãƒĒ ゚ ト sys_errlist [] は errno を æˇģ 字 と す る 配 列 で 、 こ ぎ 配 列 か ら 攚 行 į„Ą し ぎ エ ナ ãƒŧ ãƒĄ ッ ã‚ģ ãƒŧ ジ が 取 åž— さ れ る 。 テ ãƒŧ ブ ãƒĢ で ぎ 最 大 ぎ ãƒĄ ッ ã‚ģ ãƒŧ ジ į•Ē åˇ は sys_nerr -1 と ãĒ る 。 こ ぎ テ ãƒŧ ブ ãƒĢ を į›´ æŽĨ 参 į…§ す る 際 ãĢ は æŗ¨ 意 す る こ と 。 ãĒ ぜ ãĒ ら 、 新 し い エ ナ ãƒŧ į•Ē åˇ が sys_errlist [] ãĢ čŋŊ 加 済 と は 限 ら ãĒ い か ら で あ る 。 įž 在 で は 、 sys_errlist [] ぎ äŊŋ ᔍ は 非 推 åĨ¨ と ãĒ ãŖ ãĻ い る 。

ã‚ˇ ゚ テ ム ã‚ŗ ãƒŧ ãƒĢ が å¤ą 敗 し た å ´ 合 、 通 常 、 čŋ” り 値 と し ãĻ -1 が čŋ” り 、 errno ãĢ エ ナ ãƒŧ を 識 åˆĨ す る 値 が 設 厚 さ れ る (設 厚 さ れ る エ ナ ãƒŧ į•Ē åˇ は <errno.h> ãĢ 記 čŧ‰ さ れ ãĻ い る )。 多 く ぎ ナ イ ブ ナ ãƒĒ é–ĸ 数 も 同 様 ぎ 動 äŊœ と ãĒ る 。 é–ĸ 数 perror () は 、 こ ぎ エ ナ ãƒŧ ã‚ŗ ãƒŧ ド ぎ 可 čĒ­ ãĒ ãƒĄ ッ ã‚ģ ãƒŧ ジ へ ぎ 変 換 を 行 う 。 errno は 、 ナ イ ブ ナ ãƒĒ å‘ŧ ãŗ å‡ē し が 成 功 し た 垌 ãĢ は æœĒ 厚 įžŠ で あ る こ と ãĢ æŗ¨ 意 が åŋ… čρ で あ る : そ ぎ å‘ŧ ãŗ å‡ē し č‡Ē čēĢ ã¯ 成 功 し た と し ãĻ も 、 内 部 で å‘ŧ ãŗ å‡ē し た äģ– ãŽ ナ イ ブ ナ ãƒĒ é–ĸ 数 が å¤ą 敗 し ãĻ 、 そ ぎ įĩ 果 を こ ぎ 変 数 ãĢ 設 厚 す る こ と が あ る か ら だ 。 よ ãŖ ãĻ 、 å¤ą 敗 し た å‘ŧ ãŗ å‡ē し ぎ į›´ 垌 ãĢ perror () を å‘ŧ ば ãĒ い å ´ 合 ãĢ は errno ぎ 値 を äŋ 存 し ãĻ お か ãĒ け れ ば ãĒ ら ãĒ い 。

æē– 拠

é–ĸ 数 perror () と 外 部 変 数 errno ( errno (3) 参 į…§ ) は C89, 4.3BSD, POSIX.1-2001 ãĢ æē– 拠 し ãĻ い る 。 外 部 変 数 sys_nerr と sys_errlist は BSD ãĢ æē– 拠 し ãĻ い る 。

æŗ¨ 意

外 部 変 数 sys_nerr と sys_errlist は glibc で 厚 įžŠ さ れ ãĻ い る が 、 <stdio.h> ãĢ åĢ ぞ れ ãĻ い る 。

é–ĸ 逪 項 į›Ž

err (3), errno (3), error (3), strerror (3)

こ ぎ 文 書 ãĢ つ い ãĻ

こ ぎ man ペ ãƒŧ ジ は Linux man-pages プ ロ ジ ェ ク ト ぎ ãƒĒ ãƒĒ ãƒŧ ゚ 3.79 ぎ 一 部 で あ る 。 プ ロ ジ ェ ク ト ぎ čĒŦ 明 と バ グ å ą 告 ãĢ é–ĸ す る 情 å ą は http://www.kernel.org/doc/man-pages/ ãĢ 書 か れ ãĻ い る 。