argra****@users*****
argra****@users*****
2009年 1月 3日 (土) 03:53:34 JST
Index: docs/perl/5.10.0/perlapi.pod diff -u docs/perl/5.10.0/perlapi.pod:1.5 docs/perl/5.10.0/perlapi.pod:1.6 --- docs/perl/5.10.0/perlapi.pod:1.5 Sat Dec 27 04:58:23 2008 +++ docs/perl/5.10.0/perlapi.pod Sat Jan 3 03:53:34 2009 @@ -664,8 +664,8 @@ =end original -Sort an array. Here is an example: -(TBT) +配列をソートします。 +以下は例です: sortsv(AvARRAY(av), av_len(av)+1, Perl_sv_cmp_locale); @@ -676,9 +676,8 @@ =end original -Currently this always uses mergesort. See sortsv_flags for a more -flexible routine. -(TBT) +現在のところ、これは常にマージソートを使います。 +さらに柔軟なルーチンのためには sortsv_flags を参照してください。 void sortsv(SV** array, size_t num_elts, SVCOMPARE_t cmp) @@ -694,8 +693,7 @@ =end original -Sort an array, with various options. -(TBT) +様々なオプション付きで配列をソートします。 void sortsv_flags(SV** array, size_t num_elts, SVCOMPARE_t cmp, U32 flags) @@ -1749,9 +1747,9 @@ =end original -The engine implementing pack() Perl function. Note: parameters next_in_list and -flags are not used. This call should not be used; use packlist instead. -(TBT) +Perl 関数 unpack() を実装しているエンジンです。 +注意: 引数 next_in_list と flags は使われません。 +この呼び出しは使うべきではなりません; 代わりに packlist を使ってください。 void pack_cat(SV *cat, const char *pat, const char *patend, SV **beglist, SV **endlist, SV ***next_in_list, U32 flags) @@ -2194,9 +2192,9 @@ =end original -The engine implementing unpack() Perl function. Note: parameters strbeg, new_s -and ocnt are not used. This call should not be used, use unpackstring instead. -(TBT) +Perl 関数 unpack() を実装しているエンジンです。 +注意: 引数 strbeg, new_s, ocnt は使われません。 +この呼び出しは使うべきではなりません; 代わりに unpackstring を使ってください。 I32 unpack_str(const char *pat, const char *patend, const char *s, const char *strbeg, const char *strend, char **new_s, I32 ocnt, U32 flags) @@ -2250,7 +2248,7 @@ =end original -pack() Perl 関数を実装しているエンジンです。 +Perl 関数 pack() を実装しているエンジンです。 void packlist(SV *cat, const char *pat, const char *patend, SV **beglist, SV **endlist) @@ -2268,8 +2266,8 @@ =end original -The engine implementing unpack() Perl function. C<unpackstring> puts the -extracted list items on the stack and returns the number of elements. +Perl 関数 unpack() を実装しているエンジンです。 +C<unpackstring> puts the extracted list items on the stack and returns the number of elements. Issue C<PUTBACK> before and C<SPAGAIN> after the call to this function. (TBT) @@ -2495,9 +2493,8 @@ =end original 指定されたパッケージに対するスタッシュへのポインタを返します。 -Uses C<strlen> to -determine the length of C<name>, then calls C<gv_stashpvn()>. -(TBT) +C<name> の長さを決定するために C<strlen> を使い、それから +C<gv_stashpvn()> を呼び出します。 HV* gv_stashpv(const char* name, I32 flags) @@ -3075,7 +3072,8 @@ =end original -C<hv_fetch> と同様ですが、文字列/長さの組ではなくリテラルな文字列を取ります。 +C<hv_fetch> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取ります。 SV** hv_fetchs(HV* tb, const char* key, I32 lval) @@ -3334,9 +3332,8 @@ =end original -Evaluates the hash in scalar context and returns the result. +ハッシュをスカラコンテキストで評価して、結果を返します。 ハッシュが tie された場合は magic を扱います。 -(TBT) SV* hv_scalar(HV* hv) @@ -3410,9 +3407,8 @@ =end original -Like C<hv_store>, but takes a literal string instead of a string/length pair -and omits the hash parameter. -(TBT) +C<hv_store> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取り、ハッシュパラメータを除外します。 SV** hv_stores(HV* tb, const char* key, NULLOK SV* val) @@ -4162,8 +4158,8 @@ =end original -Like C<savepvn>, but takes a literal string instead of a string/length pair. -(TBT) +C<savepvn> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取ります。 char* savepvs(const char* s) @@ -4238,8 +4234,8 @@ =end original -This is an architecture-independent macro to copy one structure to another. -(TBT) +これはある構造体をもう一つにコピーするためのアーキテクチャに依存しない +マクロです。 void StructCopy(type src, type dest, type) @@ -4351,8 +4347,7 @@ =end original -can be used any place a string (char *) is required: -(TBT) +は文字列 (char *) が必要なあらゆる場所で使えます: char * s = Perl_form("%d.%d",major,minor); @@ -4383,8 +4378,7 @@ =end original -Fill the sv with current working directory -(TBT) +sv をカレントワーキングディレクトリで埋めます int getcwd_sv(SV* sv) @@ -4473,8 +4467,7 @@ =end original -Returns a new version object based on the passed in SV: -(TBT) +SV で渡されたものを基として新しいバージョンオブジェクトを返します: SV *sv = new_version(SV *ver); @@ -4516,8 +4509,7 @@ =end original -Function must be called with an already existing SV like -(TBT) +関数は以下のように、既に存在する SV と共に呼び出されなければなりません sv = newSV(0); s = scan_version(s, SV *sv, bool qv); @@ -4884,8 +4876,7 @@ =end original -Validates that the SV contains a valid version object. -(TBT) +SV が正当なバージョンオブジェクトを含んでいるかを検証します。 bool vverify(SV *vobj); @@ -5057,8 +5048,8 @@ =end original -Declare local variables for a multicall. See L<perlcall/Lightweight Callbacks>. -(TBT) +多重呼び出しのための局所変数を宣言します。 +L<perlcall/Lightweight Callbacks> を参照してください。 dMULTICALL; @@ -5092,9 +5083,8 @@ =end original -Closing bracket for a lightweight callback. -See L<perlcall/Lightweight Callbacks>. -(TBT) +軽量コールバックのための大かっこを閉じます。 +L<perlcall/Lightweight Callbacks> を参照してください。 POP_MULTICALL; @@ -5996,7 +5986,8 @@ =end original Push an integer onto the stack. The stack must have room for this element. -Handles 'set' magic. Does not use C<TARG>. See also C<PUSHi>, C<mXPUSHi> +'set' magic をハンドルします。 +Does not use C<TARG>. See also C<PUSHi>, C<mXPUSHi> and C<XPUSHi>. (TBT) @@ -6017,7 +6008,8 @@ =end original Push a double onto the stack. The stack must have room for this element. -Handles 'set' magic. Does not use C<TARG>. See also C<PUSHn>, C<mXPUSHn> +'set' magic をハンドルします。 +Does not use C<TARG>. See also C<PUSHn>, C<mXPUSHn> and C<XPUSHn>. (TBT) @@ -6038,7 +6030,9 @@ =end original Push a string onto the stack. The stack must have room for this element. -The C<len> indicates the length of the string. Handles 'set' magic. Does +The C<len> indicates the length of the string. +'set' magic をハンドルします。 +Does not use C<TARG>. See also C<PUSHp>, C<mXPUSHp> and C<XPUSHp>. (TBT) @@ -6058,8 +6052,10 @@ =end original -Push an unsigned integer onto the stack. The stack must have room for this -element. Handles 'set' magic. Does not use C<TARG>. See also C<PUSHu>, +Push an unsigned integer onto the stack. +The stack must have room for this element. +'set' magic をハンドルします。 +Does not use C<TARG>. See also C<PUSHu>, C<mXPUSHu> and C<XPUSHu>. (TBT) @@ -6122,7 +6118,9 @@ =end original Push a string onto the stack, extending the stack if necessary. The C<len> -indicates the length of the string. Handles 'set' magic. Does not use +indicates the length of the string. +'set' magic をハンドルします。 +Does not use C<TARG>. See also C<XPUSHp>, C<mPUSHp> and C<PUSHp>. (TBT) @@ -6143,7 +6141,8 @@ =end original Push an unsigned integer onto the stack, extending the stack if necessary. -Handles 'set' magic. Does not use C<TARG>. See also C<XPUSHu>, C<mPUSHu> +'set' magic をハンドルします。 +Does not use C<TARG>. See also C<XPUSHu>, C<mPUSHu> and C<PUSHu>. (TBT) @@ -6298,7 +6297,7 @@ 整数をスタックへプッシュします。 スタックは、プッシュする要素を収めるのに十分な大きさを 持っていなければなりません。 -'set' magicをハンドルします。 +'set' magic をハンドルします。 Uses C<TARG>, so C<dTARGET> or C<dXSTARG> should be called to declare it. Do not call multiple C<TARG>-oriented macros to return lists from XSUB's - see C<mPUSHi> instead. @@ -6444,7 +6443,8 @@ スタックに符号なし整数をプッシュします。 スタックにはこの要素を収めるだけの空きがなければなりません。 -Handles 'set' magic. Uses C<TARG>, so C<dTARGET> or C<dXSTARG> +'set' magic をハンドルします。 +Uses C<TARG>, so C<dTARGET> or C<dXSTARG> should be called to declare it. Do not call multiple C<TARG>-oriented macros to return lists from XSUB's - see C<mPUSHu> instead. See also C<XPUSHu> and C<mXPUSHu>. @@ -6594,8 +6594,7 @@ =end original -文字列をスタックにプッシュし、必要があればスタックの拡張を -行います。 +文字列をスタックにプッシュし、必要があればスタックの拡張を行います。 C<len> はプッシュする文字列の長さを示します。 'set' magic をハンドルします。 Uses C<TARG>, so @@ -6646,7 +6645,8 @@ スタックに符号なし整数をプッシュします。 必要があればスタックを拡張します。 -Handles 'set' magic. Uses C<TARG>, so C<dTARGET> or C<dXSTARG> should be +'set' magic をハンドルします。 +Uses C<TARG>, so C<dTARGET> or C<dXSTARG> should be called to declare it. Do not call multiple C<TARG>-oriented macros to return lists from XSUB's - see C<mXPUSHu> instead. See also C<PUSHu> and C<mPUSHu>. @@ -7512,8 +7512,8 @@ =end original -Set the value of the MAGIC pointer in sv to val. See C<SvIV_set>. -(TBT) +sv の MAGIC ポインタの値を val にセットします。 +C<SvIV_set> を参照してください。 void SvMAGIC_set(SV* sv, MAGIC* val) @@ -7724,8 +7724,8 @@ =end original -Set the value of the NV pointer in sv to val. See C<SvIV_set>. -(TBT) +sv の NV ポインタの値を val にセットします。 +C<SvIV_set> を参照してください。 void SvNV_set(SV* sv, NV val) @@ -7913,8 +7913,7 @@ =end original -Like C<SvPV>, but converts sv to byte representation first if necessary. -(TBT) +C<SvPV> と同様ですが、もし必要ならまず sv をバイト表現に変換します。 char* SvPVbyte(SV* sv, STRLEN len) @@ -7932,10 +7931,9 @@ =end original -Like C<SvPV>, but converts sv to byte representation first if necessary. -Guarantees to evaluate sv only once; use the more efficient C<SvPVbyte> -otherwise. -(TBT) +C<SvPV> と同様ですが、もし必要ならまず sv をバイト表現に変換します。 +sv を 1 度だけ評価することを保証します; さもなければより効率のよい +C<SvPVbyte> を使ってください。 char* SvPVbytex(SV* sv, STRLEN len) @@ -7953,10 +7951,9 @@ =end original -Like C<SvPV_force>, but converts sv to byte representation first if necessary. -Guarantees to evaluate sv only once; use the more efficient C<SvPVbyte_force> -otherwise. -(TBT) +C<SvPV_force> と同様ですが、もし必要ならまず sv をバイト表現に変換します。 +sv を 1 度だけ評価することを保証します; さもなければより効率のよい +C<SvPVbyte_force> を使ってください。 char* SvPVbytex_force(SV* sv, STRLEN len) @@ -7972,8 +7969,7 @@ =end original -Like C<SvPV_force>, but converts sv to byte representation first if necessary. -(TBT) +C<SvPV_force> と同様ですが、もし必要ならまず sv をバイト表現に変換します。 char* SvPVbyte_force(SV* sv, STRLEN len) @@ -7989,8 +7985,7 @@ =end original -Like C<SvPV_nolen>, but converts sv to byte representation first if necessary. -(TBT) +C<SvPV_nolen> と同様ですが、もし必要ならまず sv をバイト表現に変換します。 char* SvPVbyte_nolen(SV* sv) @@ -8006,8 +8001,7 @@ =end original -Like C<SvPV>, but converts sv to utf8 first if necessary. -(TBT) +C<SvPV> と同様ですが、もし必要ならまず sv を utf8 に変換します。 char* SvPVutf8(SV* sv, STRLEN len) @@ -8025,10 +8019,9 @@ =end original -Like C<SvPV>, but converts sv to utf8 first if necessary. -Guarantees to evaluate sv only once; use the more efficient C<SvPVutf8> -otherwise. -(TBT) +C<SvPV> と同様ですが、もし必要ならまず sv を utf8 に変換します。 +sv を 1 度だけ評価することを保証します; さもなければより効率のよい +C<SvPVutf8> を使ってください。 char* SvPVutf8x(SV* sv, STRLEN len) @@ -8046,10 +8039,9 @@ =end original -Like C<SvPV_force>, but converts sv to utf8 first if necessary. -Guarantees to evaluate sv only once; use the more efficient C<SvPVutf8_force> -otherwise. -(TBT) +C<SvPV_force> と同様ですが、もし必要ならまず sv を utf8 に変換します。 +sv を 1 度だけ評価することを保証します; さもなければより効率のよい +C<SvPVutf8_force> を使ってください。 char* SvPVutf8x_force(SV* sv, STRLEN len) @@ -8065,8 +8057,7 @@ =end original -Like C<SvPV_force>, but converts sv to utf8 first if necessary. -(TBT) +C<SvPV_force> と同様ですが、もし必要ならまず sv を utf8 に変換します。 char* SvPVutf8_force(SV* sv, STRLEN len) @@ -8082,8 +8073,7 @@ =end original -Like C<SvPV_nolen>, but converts sv to utf8 first if necessary. -(TBT) +C<SvPV_nolen> と同様ですが、もし必要ならまず sv を utf8 に変換します。 char* SvPVutf8_nolen(SV* sv) @@ -8140,7 +8130,7 @@ =end original -C<SvPV> に似ていますが、SV を強制的に文字列(C<SvPOK_only>)を含みます。 +C<SvPV> と同様ですが、SV を強制的に文字列(C<SvPOK_only>)を含みます。 C<SvPVX> を直接更新したい場合にはあなたは強制することを望むでしょう。 char* SvPV_force(SV* sv, STRLEN len) @@ -8215,8 +8205,8 @@ =end original -Set the value of the PV pointer in sv to val. See C<SvIV_set>. -(TBT) +sv の PV ポインタの値を val にセットします。 +C<SvIV_set> を参照してください。 void SvPV_set(SV* sv, char* val) @@ -8500,8 +8490,8 @@ =end original -Set the value of the RV pointer in sv to val. See C<SvIV_set>. -(TBT) +sv の RV ポインタの値を val にセットします。 +C<SvIV_set> を参照してください。 void SvRV_set(SV* sv, SV* val) @@ -8533,8 +8523,8 @@ =end original -Set the value of the STASH pointer in sv to val. See C<SvIV_set>. -(TBT) +sv の STASH ポインタの値を val にセットします。 +C<SvIV_set> を参照してください。 void SvSTASH_set(SV* sv, HV* val) @@ -8721,8 +8711,7 @@ =end original -Unsets the UTF-8 status of an SV. -(TBT) +SV の UTF-8 状態をリセットします。 void SvUTF8_off(SV *sv) @@ -8833,8 +8822,8 @@ =end original -Set the value of the UV pointer in sv to val. See C<SvIV_set>. -(TBT) +sv の UV ポインタの値を val にセットします。 +C<SvIV_set> を参照してください。 void SvUV_set(SV* sv, UV val) @@ -8940,8 +8929,8 @@ =end original -Dump the contents of all SVs not yet freed. (Debugging aid). -(TBT) +開放されていない全ての SV の内容をダンプします。 +(デバッグの助けとなります)。 void sv_report_used() @@ -9208,8 +9197,8 @@ =end original -Like C<newSVpvn>, but takes a literal string instead of a string/length pair. -(TBT) +C<newSVpvn> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取ります。 SV* newSVpvs(const char* s) @@ -9226,9 +9215,8 @@ =end original -Like C<newSVpvn_share>, but takes a literal string instead of a string/length -pair and omits the hash parameter. -(TBT) +C<newSVpvn_share> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取り、ハッシュパラメータを除外します。 SV* newSVpvs_share(const char* s) @@ -9465,8 +9453,7 @@ =end original -Usually accessed via the C<SvPVbyte> macro. -(TBT) +普通は C<SvPVbyte> マクロ経由でアクセスされます。 char* sv_2pvbyte(SV* sv, STRLEN* lp) @@ -9493,8 +9480,7 @@ =end original -Usually accessed via the C<SvPVutf8> macro. -(TBT) +普通は C<SvPVutf8> マクロ経由でアクセスされます。 char* sv_2pvutf8(SV* sv, STRLEN* lp) @@ -9651,7 +9637,7 @@ =end original -C<sv_catpvf> に似ていますが、'set' magic もハンドルします。 +C<sv_catpvf> と同様ですが、'set' magic もハンドルします。 void sv_catpvf_mg(SV *sv, const char* pat, ...) @@ -9719,8 +9705,8 @@ =end original -Like C<sv_catpvn>, but takes a literal string instead of a string/length pair. -(TBT) +C<sv_catpvn> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取ります。 void sv_catpvs(SV* sv, const char* s) @@ -9736,7 +9722,7 @@ =end original -C<sv_catpv> に似ていますが、'set' magic もハンドルします。 +C<sv_catpv> と同様ですが、'set' magic もハンドルします。 void sv_catpv_mg(SV *sv, const char *ptr) @@ -10298,8 +10284,7 @@ =end original -(This is now used as a subroutine by C<sv_magic>.) -(TBT) +(これは今では C<sv_magic> によってサブルーチンとして使われます。) MAGIC * sv_magicext(SV* sv, SV* obj, int how, const MGVTBL *vtbl, const char* name, I32 namlen) @@ -10364,9 +10349,8 @@ =end original -Increment an SV's reference count. Use the C<SvREFCNT_inc()> wrapper -instead. -(TBT) +SV の参照カウントをインクリメントします。 +代わりに C<SvREFCNT_inc()> ラッパーを使ってください。 SV* sv_newref(SV* sv) @@ -10428,8 +10412,8 @@ =end original -The backend for the C<SvPVbytex_force> macro. Always use the macro instead. -(TBT) +C<SvPVbytex_force> マクロのバックエンドです。 +代わりに、常にマクロを使ってください。 char* sv_pvbyten_force(SV* sv, STRLEN* lp) @@ -10494,8 +10478,8 @@ =end original -The backend for the C<SvPVutf8x_force> macro. Always use the macro instead. -(TBT) +C<SvPVutf8x_force> マクロのバックエンドです。 +代わりに、常にマクロを使ってください。 char* sv_pvutf8n_force(SV* sv, STRLEN* lp) @@ -10619,7 +10603,7 @@ =end original -C<sv_setiv> に似ていますが、'set' magic をハンドルします。 +C<sv_setiv> と同様ですが、'set' magic をハンドルします。 void sv_setiv_mg(SV *sv, IV i) @@ -10655,7 +10639,7 @@ =end original -C<sv_setnv> に似ていますが、'set' magic をハンドルします。 +C<sv_setnv> と同様ですが、'set' magic をハンドルします。 void sv_setnv_mg(SV *sv, NV num) @@ -10712,7 +10696,7 @@ =end original -C<sv_setpvf> に似ていますが、'set' magic をハンドルします。 +C<sv_setpvf> と同様ですが、'set' magic をハンドルします。 void sv_setpvf_mg(SV *sv, const char* pat, ...) @@ -10747,7 +10731,7 @@ =end original -C<sv_setpviv> に似ていますが、'set' magic をハンドルします。 +C<sv_setpviv> と同様ですが、'set' magic をハンドルします。 void sv_setpviv_mg(SV *sv, IV iv) @@ -10787,7 +10771,7 @@ =end original -C<sv_setpvn> に似ていますが、'set' magic をハンドルします。 +C<sv_setpvn> と同様ですが、'set' magic をハンドルします。 void sv_setpvn_mg(SV *sv, const char *ptr, STRLEN len) @@ -10803,8 +10787,8 @@ =end original -Like C<sv_setpvn>, but takes a literal string instead of a string/length pair. -(TBT) +C<sv_setpvn> と同様ですが、文字列/長さの組ではなく、リテラルな文字列を +取ります。 void sv_setpvs(SV* sv, const char* s) @@ -10820,7 +10804,7 @@ =end original -C<sv_setpv> に似ていますが、'set' magic をハンドルします。 +C<sv_setpv> と同様ですが、'set' magic をハンドルします。 void sv_setpv_mg(SV *sv, const char *ptr) @@ -11089,7 +11073,7 @@ =end original -C<sv_setsv> に似ていますが、'set' magic をハンドルします。 +C<sv_setsv> と同様ですが、'set' magic をハンドルします。 void sv_setsv_mg(SV *dstr, SV *sstr) @@ -11126,7 +11110,7 @@ =end original -C<sv_setsv> に似ていますが、'set' magic をハンドルします。 +C<sv_setsv> と同様ですが、'set' magic をハンドルします。 void sv_setuv_mg(SV *sv, UV u) @@ -11536,8 +11520,7 @@ =end original -Like C<sv_vcatpvf>, but also handles 'set' magic. -(TBT) +C<sv_vcatpvf> と同様ですが、'set' magic をハンドルします。 =begin original @@ -11615,8 +11598,7 @@ =end original -Like C<sv_vsetpvf>, but also handles 'set' magic. -(TBT) +C<sv_vsetpvf> と同様ですが、'set' magic をハンドルします。 =begin original