X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=draft%2Fman3%2Fstrxfrm.3;h=8aa0cda528758e1316c97caa0b54fa05616ce0cf;hb=c1dfa2f6ab1bbed84992d3c59ee9925f4d453668;hp=8e4011c384ec363eab86587d9ae9890e9e171a09;hpb=ce024239a1d8e74a7a44f7c24cee4375cb13b3ef;p=linuxjm%2FLDP_man-pages.git diff --git a/draft/man3/strxfrm.3 b/draft/man3/strxfrm.3 index 8e4011c3..8aa0cda5 100644 --- a/draft/man3/strxfrm.3 +++ b/draft/man3/strxfrm.3 @@ -1,5 +1,6 @@ .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" +.\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. @@ -19,97 +20,47 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:41:28 1993 by Rik Faith (faith@cs.unc.edu) +.\"******************************************************************* .\" -.\" Japanese Version Copyright (c) 1998 SHOJI Yasushi all rights reserved. -.\" Translated Fri Jun 26 1998 by SHOJI Yasushi -.\" Updated & Modefied Sun Mar 7 1999 by Shouichi Saito +.\" This file was generated with po4a. Translate the source file. .\" -.TH STRXFRM 3 2011-09-28 "GNU" "Linux Programmer's Manual" -.\"O .SH NAME -.\"O strxfrm \- string transformation +.\"******************************************************************* +.TH STRXFRM 3 2012\-05\-10 GNU "Linux Programmer's Manual" .SH 名前 strxfrm \- 文字列の変換 .SH 書式 .nf -.B #include +\fB#include \fP .sp -.BI "size_t strxfrm(char *" dest ", const char *" src ", size_t " n ); +\fBsize_t strxfrm(char *\fP\fIdest\fP\fB, const char *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP .fi -.\"O .SH DESCRIPTION -.\"O The -.\"O .BR strxfrm () -.\"O function transforms the \fIsrc\fP string into a -.\"O form such that the result of -.\"O .BR strcmp (3) -.\"O on two strings that have -.\"O been transformed with -.\"O .BR strxfrm () -.\"O is the same as the result of -.\"O .BR strcoll (3) -.\"O on the two strings before their transformation. -.\"O The first \fIn\fP characters of the transformed string are placed in -.\"O \fIdest\fP. -.\"O The transformation is based on the program's current -.\"O locale for category \fBLC_COLLATE\fP. (See -.\"O .BR setlocale (3)). .SH 説明 -.BR strxfrm () -関数は文字列 \fIsrc\fP に対して、次の条件を満たすよう -な変換をする: 「ある二つの文字列に対して、それぞれを -.BR strxfrm () -で変換してから -.BR strcmp (3) -した結果と、 -.BR strxfrm () -による変換 -を行わずに -.BR strcoll (3) -した結果と同じ」 -変換した文字列の先頭から \fIn\fP 文字分が \fIdest\fP に代入される。 -変換は、カテゴリ \fBLC_COLLATE\fP に対する、プログラムの現在のロケール -に基づいて行われる -.RB ( setlocale (3) -を参照のこと)。 -.\"O .SH "RETURN VALUE" -.\"O The -.\"O .BR strxfrm () -.\"O function returns the number of bytes required to -.\"O store the transformed string in \fIdest\fP excluding the -.\"O terminating null byte (\(aq\\0\(aq). -.\"O If the value returned is \fIn\fP or more, the -.\"O contents of \fIdest\fP are indeterminate. +\fBstrxfrm\fP() 関数は、文字列 \fIsrc\fP に対して、次のような変換を行う。 +変換は、ある二つの文字列に対して、それぞれを \fBstrxfrm\fP() で変換 +した文字列に対して \fBstrcmp\fP(3) を行った結果が、 +変換を行わずに\fBstrcoll\fP(3) を行った結果と同じとなるように行う。 +変換された文字列の先頭から \fIn\fP バイト分が \fIdest\fP に代入される。 +変換は、プログラムの現在のロケールのカテゴリ \fBLC_COLLATE\fP に +基づいて行われる (\fBsetlocale\fP(3) を参照)。 .SH 返り値 -.BR strxfrm () -関数は、変換された文字列を \fIdest\fP に代入するときに -必要なバイト数から、終端の NULL バイト (\(aq\\0\(aq) の分を -引いたものを返す。もし返り値が \fIn\fP 以上の場合、 -\fIdest\fP の内容は不定となる。 +\fBstrxfrm\fP() 関数は、変換された文字列を \fIdest\fP に代入するときに 必要なバイト数から、終端の NULL バイト +(\(aq\e0\(aq) の分を 引いたものを返す。もし返り値が \fIn\fP 以上の場合、 \fIdest\fP の内容は不定となる。 .SH 準拠 SVr4, 4.3BSD, C89, C99. -.\"O .SH NOTES -.\"O In the \fI"POSIX"\fP or \fI"C"\fP locales -.\"O .BR strxfrm () -.\"O is equivalent to -.\"O copying the string with -.\"O .BR strncpy (3). .SH 注意 -\fI"POSIX"\fP または \fI"C"\fP ロケールでは、関数 -.BR strxfrm () -は、 -関数 -.BR strncpy (3) +\fIPOSIX\fP または \fIC\fP ロケールでは、関数 \fBstrxfrm\fP() は、 関数 \fBstrncpy\fP(3) を使って文字列をコピーするのと同じである。 .SH 関連項目 -.BR bcmp (3), -.BR memcmp (3), -.BR setlocale (3), -.BR strcasecmp (3), -.BR strcmp (3), -.BR strcoll (3), -.BR string (3) +\fBbcmp\fP(3), \fBmemcmp\fP(3), \fBsetlocale\fP(3), \fBstrcasecmp\fP(3), \fBstrcmp\fP(3), +\fBstrcoll\fP(3), \fBstring\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。