.\" Modified Sun Sep 24 20:15:46 2000 by aeb, following Petter Reinholdtsen.
.\" Modified 2001-12-26 by aeb, following Joey. Added versionsort.
.\"
-.\" FIXME glibc 2.15 adds scandirat()
+.\"*******************************************************************
.\"
-.\" Japanese Version Copyright (c) 1998 Hiroaki Nagoya all rights reserved.
-.\" Translated Thu May 28 1998 by Hiroaki Nagoya <nagoya@is.titech.ac.jp>
-.\" Updated & Modified Sat Jan 19 18:22:21 JST 2002
-.\" by Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated & Modified Sun Jan 16 08:12:04 JST 2005
-.\" by Yuichi SATO <ysato444@yahoo.co.jp>
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH SCANDIR 3 2011-09-08 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\"*******************************************************************
+.TH SCANDIR 3 2012\-03\-20 GNU "Linux Programmer's Manual"
.SH 名前
-.\"O scandir, alphasort, versionsort \- scan a directory for matching entries
scandir, alphasort, versionsort \- ディレクトリを走査する
-.\"O .SH SYNOPSIS
.SH 書式
.nf
-.B #include <dirent.h>
+\fB#include <dirent.h>\fP
.sp
-.BI "int scandir(const char *" dirp ", struct dirent ***" namelist ,
+\fBint scandir(const char *\fP\fIdirp\fP\fB, struct dirent ***\fP\fInamelist\fP\fB,\fP
.RS
-.BI "int (*" filter ")(const struct dirent *),"
-.BI "int (*" compar ")(const struct dirent **, const struct dirent **));"
+\fBint (*\fP\fIfilter\fP\fB)(const struct dirent *),\fP
+\fBint (*\fP\fIcompar\fP\fB)(const struct dirent **, const struct dirent **));\fP
.RE
.sp
-.BI "int alphasort(const void *" a ", const void *" b );
+\fBint alphasort(const void *\fP\fIa\fP\fB, const void *\fP\fIb\fP\fB);\fP
.sp
-.BI "int versionsort(const void *" a ", const void *" b );
+\fBint versionsort(const void *\fP\fIa\fP\fB, const void *\fP\fIb\fP\fB);\fP
.fi
.sp
.in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR scandir (),
-.BR alphasort ():
-_BSD_SOURCE || _SVID_SOURCE
+\fBscandir\fP(), \fBalphasort\fP(): _BSD_SOURCE || _SVID_SOURCE
.br
-.BR versionsort ():
-_GNU_SOURCE
-.\"O .SH DESCRIPTION
+\fBversionsort\fP(): _GNU_SOURCE
.SH 説明
-.\"O The
-.\"O .BR scandir ()
-.\"O function scans the directory \fIdirp\fP, calling
-.\"O \fIfilter\fP() on each directory entry.
-.\"O Entries for which
-.\"O \fIfilter\fP() returns nonzero are stored in strings allocated via
-.\"O .BR malloc (3),
-.\"O sorted using
-.\"O .BR qsort (3)
-.\"O with the comparison
-.\"O function \fIcompar\fP() and collected in array \fInamelist\fP
-.\"O which is allocated via
-.\"O .BR malloc (3).
-.\"O If \fIfilter\fP is NULL, all entries are selected.
-関数
-.BR scandir ()
-はディレクトリ \fIdirp\fP を走査し、
-ディレクトリの各エントリを引き数として
-.BR filter ()
-を呼び出す。
-.BR filter ()
-が 0 以外の値を返すエントリは
-.BR malloc (3)
-によって
-確保された文字列に保存され、比較関数
-.BR compar ()
-を用いて
-.BR qsort (3)
-によりソートされ、
-.BR malloc (3)
-により確保された配列
-\fInamelist\fP にまとめられる。
-\fIfilter\fP が NULL ならば、すべてのエントリが選択される。
+関数 \fBscandir\fP() はディレクトリ \fIdirp\fP を走査し、 ディレクトリの各エントリを引き数として \fBfilter\fP()
+を呼び出す。 \fBfilter\fP() が 0 以外の値を返すエントリは \fBmalloc\fP(3) によって 確保された文字列に保存され、比較関数
+\fBcompar\fP() を用いて \fBqsort\fP(3) によりソートされ、 \fBmalloc\fP(3) により確保された配列
+\fInamelist\fP にまとめられる。 \fIfilter\fP が NULL ならば、すべてのエントリが選択される。
.LP
-.\"O The
-.\"O .BR alphasort ()
-.\"O and
-.\"O .BR versionsort ()
-.\"O functions can be used as the comparison function
-.\"O .IR compar ().
-比較関数
-.IR compar ()
-には
-.BR alphasort ()
-関数と
-.BR versionsort ()
-関数を使うことができる。
-.\"O The former sorts directory entries using
-.\"O .BR strcoll (3),
-.\"O the latter using
-.\"O .BR strverscmp (3)
-.\"O on the strings \fI(*a)\->d_name\fP and \fI(*b)\->d_name\fP.
-.BR alphasort ()
-は
-.BR strcoll (3)
-を用いてディレクトリエントリをソートし、
-.BR versionsort ()
-は文字列 \fI(*a)\->d_name\fP と \fI(*b)\->d_name\fP に対して
-.BR strverscmp (3)
-を用いる。
-.\"O .SH "RETURN VALUE"
+比較関数 \fIcompar\fP() には \fBalphasort\fP() 関数と \fBversionsort\fP() 関数を使うことができる。
+\fBalphasort\fP() は \fBstrcoll\fP(3) を用いてディレクトリエントリをソートし、 \fBversionsort\fP() は文字列
+\fI(*a)\->d_name\fP と \fI(*b)\->d_name\fP に対して \fBstrverscmp\fP(3) を用いる。
.SH 返り値
-.\"O The
-.\"O .BR scandir ()
-.\"O function returns the number of directory entries
-.\"O selected or \-1 if an error occurs.
-関数
-.BR scandir ()
-は選択されたエントリの数か、
-(エラーが発生した場合) \-1 を返す。
+関数 \fBscandir\fP() は選択されたエントリの数か、 (エラーが発生した場合) \-1 を返す。
.PP
-.\"O The
-.\"O .BR alphasort ()
-.\"O and
-.\"O .BR versionsort ()
-.\"O functions return an integer less than, equal to,
-.\"O or greater than zero if the first argument is considered to be
-.\"O respectively less than, equal to, or greater than the second.
-関数
-.BR alphasort ()
-と
-.BR versionsort ()
-は 1 番目の引き数が 2 番目の引き数に対して、
+関数 \fBalphasort\fP() と \fBversionsort\fP() は 1 番目の引き数が 2 番目の引き数に対して、
[小さい/等しい/大きい] かに応じて、0 より [小さい/等しい/大きい] 値を返す。
-.\"O .SH ERRORS
.SH エラー
-.TP
-.B ENOENT
-.\"O The path in \fIdirp\fR does not exist.
-\fIdirp\fR で指定されたパスが存在しない。
-.TP
-.B ENOMEM
-.\"O Insufficient memory to complete the operation.
-動作を完遂するにはメモリが足りない。
-.TP
-.B ENOTDIR
-.\"O The path in \fIdirp\fR is not a directory.
-\fIdirp\fR で指定されたパスがディレクトリではない。
-.\"O .SH VERSIONS
+.TP
+\fBENOENT\fP
+\fIdirp\fP で指定されたパスが存在しない。
+.TP
+\fBENOMEM\fP
+操作を完了するのに十分なメモリがない。
+.TP
+\fBENOTDIR\fP
+\fIdirp\fP で指定されたパスがディレクトリではない。
.SH バージョン
-.\"O .BR versionsort ()
-.\"O was added to glibc in version 2.1.
-.BR versionsort ()
-は、glibc バージョン 2.1 で追加された。
-.\"O .SH "CONFORMING TO"
+\fBversionsort\fP() は、glibc バージョン 2.1 で追加された。
.SH 準拠
-.\"O .BR alphasort ()
-.\"O and
-.\"O .BR scandir ()
-.\"O are specified in POSIX.1-2008, and are widely available.
-.\"O .BR versionsort ()
-.\"O is a GNU extension.
-.BR alphasort ()
-と
-.BR scandir ()
-は POSIX.1-2008 で規定されており、広く利用可能である。
-.BR versionsort ()
-は GNU 拡張である。
+\fBalphasort\fP() と \fBscandir\fP() は POSIX.1\-2008 で規定されており、広く利用可能である。
+\fBversionsort\fP() は GNU 拡張である。
.LP
-.\"O The functions
-.\"O .BR scandir ()
-.\"O and
-.\"O .BR alphasort ()
-.\"O are from 4.3BSD, and have been available under Linux since libc4.
-関数
-.BR scandir ()
-と
-.BR alphasort ()
-は 4.3BSD から取り入れられ、Linux では libc4 から使用可能になった。
-.\"O Libc4 and libc5 use the more precise prototype
-libc4 と libc5 では以下のようなもっと詳細なプロトタイプを使っている。
+関数 \fBscandir\fP() と \fBalphasort\fP() は 4.3BSD から取り入れられ、Linux では libc4
+から使用可能になった。 libc4 と libc5 では以下のようなもっと詳細なプロトタイプを使っている。
.sp
.nf
int alphasort(const struct dirent ** a,
const struct dirent **b);
.fi
.sp
-.\"O but glibc 2.0 returns to the imprecise BSD prototype.
しかし glibc 2.0 では不正確な BSD のプロトタイプに戻った。
.LP
-.\"O The function
-.\"O .BR versionsort ()
-.\"O is a GNU extension, available since glibc 2.1.
-関数
-.BR versionsort ()
-は GNU の拡張であり、glibc 2.1 以降で使用可能である。
+関数 \fBversionsort\fP() は GNU の拡張であり、glibc 2.1 以降で使用可能である。
.LP
-.\"O Since glibc 2.1,
-.\"O .BR alphasort ()
-.\"O calls
-.\"O .BR strcoll (3);
-.\"O earlier it used
-.\"O .BR strcmp (3).
-glibc 2.1 以降では
-.BR alphasort ()
-は
-.BR strcoll (3)
-を呼び出す。
-.BR alphasort ()
-は以前は
-.BR strcmp (3)
-を使っていた。
-.\"O .SH EXAMPLE
+glibc 2.1 以降では \fBalphasort\fP() は \fBstrcoll\fP(3) を呼び出す。 \fBalphasort\fP() は以前は
+\fBstrcmp\fP(3) を使っていた。
.SH 例
.nf
#define _SVID_SOURCE
-.\"O /* print files in current directory in reverse order */
/* カレントディレクトリのファイルを逆順に出力する */
#include <dirent.h>
}
}
.fi
-.\"O .SH "SEE ALSO"
.SH 関連項目
-.BR closedir (3),
-.BR fnmatch (3),
-.BR opendir (3),
-.BR readdir (3),
-.BR rewinddir (3),
-.BR seekdir (3),
-.BR strcmp (3),
-.BR strcoll (3),
-.BR strverscmp (3),
-.BR telldir (3)
+\fBclosedir\fP(3), \fBfnmatch\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3),
+\fBrewinddir\fP(3), \fBscandirat\fP(3), \fBseekdir\fP(3), \fBstrcmp\fP(3),
+\fBstrcoll\fP(3), \fBstrverscmp\fP(3), \fBtelldir\fP(3)