perlapi - クラウド上のオンライン

プログラム：

NAME

perlapi - Perl パブリック API の自動生成ドキュメント

DESCRIPTION

このファイルには、によって生成された perl パブリック API のドキュメントが含まれています。 埋め込み.pl,
具体的には、で使用できる関数、マクロ、フラグ、変数のリストです。
拡張ライター。 最後に、まだ文書化されていない関数のリストを示します。
これらのインターフェースは予告なく変更される場合があります。 ここに記載されていないものは、
これはパブリック API の一部ではないため、拡張機能作成者は決して使用しないでください。 これらのために
そのため、proto.h にリストされている関数を盲目的に使用することは、記述するときに避けるべきです。
拡張機能

すべての Perl API グローバル変数は「PL_」プレフィックスを付けて参照する必要があることに注意してください。 また、
ここにリストされていないものは、拡張機能作成者によって使用されるべきではなく、変更または変更することができます。
予告なく削除されます。 マクロも同様。 一部のマクロは互換性のために提供されています。
古い、飾り気のない名前ですが、このサポートは将来のリリースで無効になる可能性があります。

Perl はもともと US-ASCII のみを処理するように書かれていました (つまり、序数が
数値の範囲は 0 ～ 127)。 ドキュメントやコメントでは依然としてこの用語が使用される場合があります。
ASCII は、実際には 0 ～ 255 の範囲全体を意味する場合があります。

Perl は ASCII または EBCDIC でコンパイルして実行できることに注意してください (perlebcdic を参照)。
ほとんどのドキュメント (およびコード内のコメント) は EBCDIC の可能性を無視しています。
ほとんどすべての目的において、違いは明らかです。 例として、EBCDIC では、
Unicode 文字列のエンコードには UTF-8 の代わりに UTF-EBCDIC が使用されます。
ドキュメントでは「utf8」(および関数名を含むその名前の変形) を参照しています。
また、(本質的に透過的に) 「UTF-EBCDIC」も意味します。 しかし、文字の序数は
ASCII、EBCDIC、UTF エンコーディング間で異なり、UTF-EBCDIC でエンコードされた文字列
UTF-8 よりも多くのバイトを占有する可能性があります。

以下のリストはアルファベット順であり、大文字と小文字は区別されません。

「ちょうだい」 価値観

GIMME 「G_SCALAR」または「G_SCALAR」のみを返すことができる「GIMME_V」の下位互換性のあるバージョン
"G_ARRAY"; void コンテキストでは、「G_SCALAR」を返します。 廃止されました。 「GIMME_V」を使用する
を代わりにお使いください。

U32 ギミ

GIMME_V XSUB ライターの Perl の「wantarray」に相当します。 「G_VOID」、「G_SCALAR」を返します。
または "G_ARRAY" は、それぞれ void、スカラー、またはリスト コンテキストを表します。 詳細については、perlcall を参照してください。
使用例。

U32 ギメ_V

G_ARRAY リストのコンテキストを示すために使用されます。 「GIMME_V」、「GIMME」、および perlcall を参照してください。

G_DISCARD
コールバックから返された引数を破棄する必要があることを示します。 見る
パールコール。

G_EVAL コールバックの周囲に Perl の「eval」ラッパーを強制するために使用されます。 「perlcall」を参照してください。

G_NOARGS
コールバックに引数が送信されていないことを示します。 「perlcall」を参照してください。

G_スカラー
スカラーコンテキストを示すために使用されます。 「GIMME_V」、「GIMME」、および perlcall を参照してください。

G_VOID 無効なコンテキストを示すために使用されます。 「GIMME_V」と perlcall を参照してください。

配列 操作 機能

AvFILL 「av_top_index()」と同じ。 非推奨のため、代わりに「av_top_index()」を使用してください。

int AvFILL(AV* av)

av_クリア
配列のすべての要素を解放し、空のままにします。 XS相当のもの
「@配列 = ()」。 「av_undef」も参照してください。

デストラクターのアクションが直接呼び出されたり、
配列の要素を解放することで間接的に参照カウントが発生する可能性があります。
配列自体を縮小する (シンボルテーブル内のエントリを削除するなど)。 それで
AV が解放された (または再割り当てされた) 可能性があります。
参照を保持していない限り、呼び出しから戻ります。

void av_clear(AV *av)

av_create_and_push
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

SV を配列の末尾にプッシュし、必要に応じて配列を作成します。 小さな
一般的に重複するイディオムを削除する内部ヘルパー関数。

void av_create_and_push(AV **const avp,
SV *定数)

av_create_and_unshift_one
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

SV を配列の先頭にシフト解除し、必要に応じて配列を作成します。
よく重複するイディオムを削除するための小さな内部ヘルパー関数。

SV** av_create_and_unshift_one(AV **const avp,
SV *定数)

av_delete
「key」でインデックス付けされた要素を配列から削除し、その要素を致命的にし、
それを返します。 「flags」が「G_DISCARD」と等しい場合、要素は解放され、null が返されます。
戻ってきた。 Perl と同等: 「my $elem = delete($myarray[$idx]);」 のために
非「G_DISCARD」バージョンと void-context「delete($myarray[$idx]);」 のために
「G_DISCARD」バージョン。

SV* av_delete(AV *av、SSize_t キー、I32 フラグ)

av_exists
「key」でインデックス付けされた要素が初期化されている場合は true を返します。

これは、初期化されていない配列要素が NULL に設定されるという事実に依存しています。

Perl に相当するもの: 「exists($myarray[$key])」。

bool av_exists(AV *av, SSize_t key)

av_extend
配列を事前拡張します。 「キー」は配列のインデックスです。
拡張されました。

void av_extend(AV *av, SSize_t キー)

av_fetch
配列内の指定されたインデックスにある SV を返します。 「キー」はインデックスです。 もしも
lval が true の場合、本物の SV が返されることが保証されます (本物ではなかった場合に備えて)
前)、後で変更できます。 戻り値が null でないことを確認する
「SV*」に逆参照する前に。

詳細については、perlguts の「結合ハッシュと配列の魔法について」を参照してください。
タイドアレイでこの関数を使用する方法に関する情報。

大まかに同等の Perl は $myarray[$idx] です。

SV** av_fetch(AV *av, SSize_t key, I32 lval)

av_fill 配列内の最大のインデックスを、Perl のインデックスと同等の指定された数値に設定します。
「$#array = $fill;」。

配列内の要素の数は「fill + 1」になります。 av_fill() 戻る。
配列が以前より短かった場合、追加された追加要素が設定されます。
NULLにします。 配列が長い場合は、余分な要素が解放されます。
「av_fill(av, -1)」は「av_clear(av)」と同じです。

void av_fill(AV *av, SSize_t fill)

av_len 「av_top_index」と同じ。 名前が示すものとは異なり、返されることに注意してください。
配列内の最大のインデックスなので、配列のサイズを取得するには、次の値を使用する必要があります。
「av_len(av) + 1」。 これは、期待どおりの結果を返す「sv_len」とは異なります。

SSize_t av_len(AV *av)

av_make 新しい AV を作成し、それに SV のリストを設定します。 SV は
配列なので、av_make の呼び出し後に解放される可能性があります。 新しいAVには、
参照カウントは 1 です。

Perl と同等: 「my @new_array = ($scalar1, $scalar2, $scalar3...);」

AV* av_make(SSize_t サイズ, SV **strp)

av_pop 配列の末尾から XNUMX つの SV を削除し、そのサイズを XNUMX つ減らして返します。
SV (XNUMX つの参照カウントの制御を呼び出し元に転送)。 戻り値
&PL_sv_undef 配列が空の場合。

Perl に相当するもの: 「pop(@myarray);」

SV* av_pop(AV *av)

av_push SV を配列の最後にプッシュします。 配列は自動的に次のように拡張されます
追加に対応します。 これにより、XNUMX つの参照カウントの所有権が取得されます。

Perl に相当するもの:「push @myarray, $elem;」。

void av_push(AV *av, SV *val)

av_シフト
配列の先頭から XNUMX つの SV を削除し、そのサイズを XNUMX つ減らして返します。
SV (XNUMX つの参照カウントの制御を呼び出し元に転送)。 戻り値
&PL_sv_undef 配列が空の場合。

Perl に相当するもの: "shift(@myarray);"

SV* av_shift(AV *av)

av_store
SV を配列に格納します。 配列のインデックスは「key」として指定します。 リターン
操作が失敗した場合、または値を変更する必要がない場合、値は NULL になります。
実際には配列内に格納されます (結合された配列の場合と同様)。 そうでなければ、それは
逆参照して、そこに格納されている "SV*" を取得できます (= "val"))。

呼び出し元は参照カウントを適切にインクリメントする責任があることに注意してください。
呼び出しの前に「val」を減らし、関数が NULL を返した場合は値をデクリメントします。

Perl と同等のおおよその値: "$myarray[$key] = $val;"。

詳細については、perlguts の「結合ハッシュと配列の魔法について」を参照してください。
タイドアレイでこの関数を使用する方法に関する情報。

SV** av_store(AV *av, SSize_t key, SV *val)

av_tindex
「av_top_index()」と同じ。

int av_tindex(AV* av)

av_top_index
配列内の最大のインデックスを返します。 配列内の要素の数は、
「av_top_index(av) + 1」。 配列が空の場合は -1 を返します。

これに相当する Perl は $#myarray です。

(もう少し短い形式は「av_tindex」です。)

SSize_t av_top_index(AV *av)

av_undef
配列の定義を解除します。 XS では「undef(@array)」に相当します。

これは、配列のすべての要素 (「av_clear()」など) を解放するだけでなく、
AV がスカラーのリストを保存するために使用していたメモリを解放します。

戻り時に配列が無効になる可能性については、「av_clear」を参照してください。

void av_undef(AV *av)

av_unshift
指定された数の「undef」値を配列の先頭にシフト解除します。 の
配列は追加に応じて自動的に拡張されます。 次に使用する必要があります
「av_store」は、これらの新しい要素に値を割り当てます。

Perl と同等: 「unshift @myarray, ( (undef) x $n );」

void av_unshift(AV *av, SSize_t num)

get_av 指定された名前を持つ指定された Perl グローバルまたはパッケージ配列の AV を返します。
(したがって、字句変数では機能しません)。 「フラグ」は「gv_fetchpv」に渡されます。 もしも
「GV_ADD」が設定されており、Perl 変数が存在しない場合は作成されます。 もしも
「flags」がゼロで変数が存在しない場合は、NULL が返されます。

Perl に相当するもの: "@{"$name"}"。

注: この関数の perl_ 形式は非推奨です。

AV* get_av(const char *name, I32 フラグ)

newAV 新しい AV を作成します。 参照カウントは 1 に設定されます。

Perl に相当するもの:「my @array;」。

AV* newAV()

sortsv 配列をソートします。 以下に例を示します。

sortsv(AvARRAY(av), av_top_index(av)+1, Perl_sv_cmp_locale);

現在、これは常にマージソートを使用します。 より柔軟な方法については、sortsv_flags を参照してください。
ルーチン。

void sortsv(SV** 配列, size_t num_elts,
SVCOMPARE_t cmp)

sortsv_flags
さまざまなオプションを使用して配列を並べ替えます。

void sortsv_flags(SV** 配列, size_t num_elts,
SVCOMPARE_t cmp、U32 フラグ)

「xsubpp」 variables と 内部 機能

ax スタック ベース オフセットを示すために「xsubpp」によって設定される変数。
「ST」、「XSprePUSH」、および「XSRETURN」マクロ。 「dMARK」マクロは事前に呼び出す必要があります。
「MARK」変数を設定します。

I32斧

CLASS C++ XS のクラス名を示すために「xsubpp」によって設定される変数
コンストラクタ。 これは常に「char*」です。 「これ」を参照してください。

char* クラス

dAX 変数「ax」を設定します。 これは通常、「xsubpp」によって自動的に処理されます。
「dXSARGS」を呼び出します。

ダックス;

dAXMARK 変数axとスタックマーカー変数markを設定します。 これは通常、
「dXSARGS」を呼び出すことで「xsubpp」によって自動的に処理されます。

ダックスマーク;

dITEMS 「items」変数を設定します。 これは通常、「xsubpp」によって自動的に処理されます。
「dXSARGS」を呼び出します。

条件;

ダンダーバー
「UNDERBAR」マクロで必要な変数を設定します。 以前は定義していました
「padoff_du」ですが、現在はダメです。 ただし、引き続き使用することを強くお勧めします。
過去および将来の互換性を確保するために使用してください。

ダンダーバー;

dXSARGS dSP および dMARK を呼び出して、XSUB のスタックおよびマーク ポインターを設定します。 をセットアップします
「dAX」と「dITEMS」を呼び出して「ax」と「items」変数を呼び出します。 通常はこれで処理されます
「xsubpp」によって自動的に実行されます。

dXSARGS;

dXSI32 エイリアスを持つ XSUB の「ix」変数を設定します。 これは通常処理されます
「xsubpp」によって自動的に実行されます。

dXSI32;

items スタック上の項目の数を示すために「xsubpp」によって設定される変数。
perlxs の「可変長パラメータ リスト」を参照してください。

I32項目

ix XSUB のエイリアスがどれであるかを示すために「xsubpp」によって設定される変数
それを呼び出すために使用されます。 perlxs の「ALIAS: キーワード」を参照してください。

I32 ix

RETVAL XSUB の戻り値を保持するために「xsubpp」によって設定される変数。 これは
常に XSUB に適切なタイプを選択します。 perlxs の「RETVAL 変数」を参照してください。

(何でも) RETVAL

ST XSUB のスタック上の要素にアクセスするために使用されます。

SV* ST(int ix)

THIS C++ XSUB 内のオブジェクトを指定するために「xsubpp」によって設定される変数。 これ
は常に C++ オブジェクトの適切な型です。 「CLASS」および「C++ での XS の使用」を参照してください。
パールクスで。

(何でも)これ

アンダーバー
$_ 変数に対応する SV*。 字句 $_ が含まれていても機能します
範囲。

XSUB とその C パラメータ リストを宣言する XS マクロ。 これは「xsubpp」によって処理されます。
これは、より明示的な XS_EXTERNAL マクロを使用するのと同じです。

XS_EXTERNAL
XSUB とその C パラメータ リストを宣言し、明示的にエクスポートするマクロ
シンボル。

XS_内部
シンボルをエクスポートせずに XSUB とその C パラメーター リストを宣言するマクロ。
これは「xsubpp」によって処理され、一般に XSUB をエクスポートするよりも推奨されます。
不必要な記号。

コー​​ルバック 機能

call_argv
指定された名前付きおよびパッケージスコープの Perl サブルーチンへのコールバックを実行します。
引数として「argv」（NULL で終わる文字列の配列）。 「perlcall」を参照してください。

Perl と同等のおおよその値: "&{"$sub_name"}(@$argv)"。

注: この関数の perl_ 形式は非推奨です。

I32 call_argv(const char* sub_name、I32 フラグ、
char** 引数)

呼び出しメソッド
指定された Perl メソッドへのコールバックを実行します。 祝福されたオブジェクトはオンになっている必要があります
スタック。 「perlcall」を参照してください。

注: この関数の perl_ 形式は非推奨です。

I32 call_method(const char* メソッド名、I32 フラグ)

call_pv 指定された Perl サブルーチンへのコールバックを実行します。 「perlcall」を参照してください。

注: この関数の perl_ 形式は非推奨です。

I32 call_pv(const char* sub_name、I32 フラグ)

call_sv SV によって指定された Perl サブルーチンへのコールバックを実行します。

「G_METHOD」フラグも「G_METHOD_NAMED」フラグも指定されていない場合、SV は任意の値になります。
CV、GV、CV への参照、GV への参照、または「SvPV(sv)」が使用されます
呼び出すサブウーファーの名前として。

「G_METHOD」フラグが指定されている場合、SV は CV または
「SvPV(sv)」は、呼び出すメソッドの名前として使用されます。

「G_METHOD_NAMED」フラグが指定されている場合、「SvPV(sv)」が名前として使用されます。
呼び出すメソッド。

他の一部の値は内部使用のために特別に扱われるため、使用しないでください。
に依存していた。

「perlcall」を参照してください。

注: この関数の perl_ 形式は非推奨です。

I32 call_sv(SV* sv、VOL I32 フラグ)

ENTER コールバックで括弧を開きます。 「LEAVE」と perlcall を参照してください。

入力;

eval_pv スカラー コンテキストで指定された文字列を「評価」し、SV* 結果を返すように Perl に指示します。

注: この関数の perl_ 形式は非推奨です。

SV* eval_pv(const char* p, I32 croak_on_error)

eval_sv Perl に SV 内の文字列を「評価」するように指示します。 と同じフラグをサポートします。
「call_sv」。ただし、G_EVAL は例外です。 「perlcall」を参照してください。

注: この関数の perl_ 形式は非推奨です。

I32 eval_sv(SV* sv、I32 フラグ)

FREETMPS
コールバックの一時的な右括弧。 「SAVETMPS」と perlcall を参照してください。

FREETMPS;

LEAVE コールバックの閉じ括弧。 「ENTER」と perlcall を参照してください。

離れる;

SAVETMPS
コールバックの一時的な開始ブラケット。 「FREETMPS」と perlcall を参照してください。

SAVETMPS;

文字 場合 変化

toFOLD 指定された文字をフォールドケースに変換します。 入力が
ASCII の大文字、その入力文字自体が返されます。 変異体
「toFOLD_A」は同等です。 (完全なファイルに相当する「to_FOLD_L1」はありません。
Latin1 範囲。「toFOLD_uni」の完全な汎用性がそこで必要とされるためです。)

U8 toFOLD(U8ch)

toFOLD_uni
Unicode コード ポイント「cp」をそのフォールドケース バージョンに変換し、それを次の場所に保存します。
「s」には UTF-8、「lenp」にはそのバイト数の長さ。 バッファが次を指していることに注意してください。
by "s" はフォールドケースなので少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります
バージョンは元のキ​​ャラクターよりも長くなる可能性があります。

フォールドケース バージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

UV toFOLD_uni(UV cp、U8* s、STRLEN* lenp)

toFOLD_utf8
「p」の UTF-8 エンコード文字をフォールドケース バージョンに変換し、格納します
「s」は UTF-8 での値、「lenp」はバイト単位の長さです。 バッファに注意してください
"s" が指すデータは少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります。
フォールドケース版はオリジナルのキャラクターよりも長くなる可能性があります。

フォールドケース バージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

「p」の入力文字は整形式であると想定されます。

UV toFOLD_utf8(U8* p、U8* s、STRLEN* lenp)

toLOWER 指定された文字を小文字に変換します。 入力が
ASCII の大文字、その入力文字自体が返されます。 変異体
「toLOWER_A」は同等です。

U8～LOWER(U8ch)

toLOWER_L1
指定された Latin1 文字を小文字に変換します。 結果は未定義です
入力がバイトに収まらない場合。

U8～LOWER_L1(U8ch)

toLOWER_LC
指定された文字を現在のロケールの規則を使用して小文字に変換します。
可能; それ以外の場合は、入力文字自体を返します。

U8 toLOWER_LC(U8ch)

toLOWER_uni
Unicode コードポイント「cp」を小文字バージョンに変換し、それを次の場所に格納します。
「s」には UTF-8、「lenp」にはそのバイト数の長さ。 バッファが次を指していることに注意してください。
by "s" は小文字であるため、少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります
バージョンは元のキ​​ャラクターよりも長くなる可能性があります。

小文字バージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

UV toLOWER_uni(UV cp、U8* s、STRLEN* lenp)

toLOWER_utf8
「p」の UTF-8 エンコード文字を小文字バージョンに変換して格納します。
「s」は UTF-8 での値、「lenp」はバイト単位の長さです。 バッファに注意してください
"s" が指すデータは少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります。
小文字バージョンは元の文字よりも長くなる可能性があります。

小文字バージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

「p」の入力文字は整形式であると想定されます。

UV toLOWER_utf8(U8* p, U8* s, STRLEN* lenp)

toTITLE 指定された文字をタイトルケースに変換します。 入力が
ASCII 小文字の場合、その入力文字自体が返されます。 変異体
「toTITLE_A」は同等です。 (Latin1 の全範囲には「toTITLE_L1」はありません。
そこでは「toTITLE_uni」の完全な汎用性が必要となるためです。 タイトルケースは
ロケール処理で使用される概念なので、そのための機能はありません。)

U8 toTITLE(U8ch)

toTITLE_uniへ
Unicode コードポイント「cp」をタイトルケースのバージョンに変換し、それを次の場所に保存します。
「s」には UTF-8、「lenp」にはそのバイト数の長さ。 バッファが次を指していることに注意してください。
by "s" はタイトルケースより少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります
バージョンは元のキ​​ャラクターよりも長くなる可能性があります。

タイトルケース付きバージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

UV toTITLE_uni(UV cp、U8* s、STRLEN* lenp)

toTITLE_utf8
「p」の UTF-8 エンコード文字をタイトルケースのバージョンに変換し、保存します
「s」は UTF-8 での値、「lenp」はバイト単位の長さです。 バッファに注意してください
"s" が指すデータは少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります。
タイトルケースのバージョンは、元のキャラクターよりも長くなる可能性があります。

タイトルケース付きバージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

「p」の入力文字は整形式であると想定されます。

UV toTITLE_utf8(U8* p, U8* s, STRLEN* lenp)

toUPPER 指定された文字を大文字に変換します。 入力が
ASCII 小文字の場合、その入力文字自体が返されます。 変異体
「toUPPER_A」は同等です。

U8 toUPPER(U8ch)

UPPER_uniへ
Unicode コードポイント「cp」を大文字バージョンに変換し、それを次の場所に格納します。
「s」には UTF-8、「lenp」にはそのバイト数の長さ。 バッファが次を指していることに注意してください。
by "s" は大文字であるため、少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります
バージョンは元のキ​​ャラクターよりも長くなる可能性があります。

大文字バージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

UV toUPPER_uni(UV cp、U8* s、STRLEN* lenp)

toUPPER_utf8
「p」の UTF-8 エンコード文字を大文字に変換して格納します。
「s」は UTF-8 での値、「lenp」はバイト単位の長さです。 バッファに注意してください
"s" が指すデータは少なくとも "UTF8_MAXBYTES_CASE+1" バイトである必要があります。
大文字バージョンは元の文字よりも長くなる可能性があります。

大文字バージョンの最初のコード ポイントが返されます (ただし、説明したように注意してください)
すぐ上にあるので、さらにあるかもしれません。)

「p」の入力文字は整形式であると想定されます。

UV toUPPER_utf8(U8* p, U8* s, STRLEN* lenp)

文字 分類

このセクションでは、文字をタイプに分類する関数 (実際にはマクロ) について説明します。
句読点とアルファベットなど。これらのほとんどは正規表現に似ています。
文字クラス。 (perlrecharclass の「POSIX 文字クラス」を参照してください。) いくつかあります。
各クラスのバリエーション。 (すべてのマクロにすべてのバリアントがあるわけではありません。以下の各項目に、
）「use bytes」の影響を受けるものはなく、「LC」を持つものだけが影響を受けます。
名前は現在のロケールの影響を受けます。

基本関数、たとえば「isALPHA()」は、オクテット (「char」または「U8」) を入力として受け取ります。
そして、そのオクテットによって表される文字が(または
非 ASCII プラットフォームでは、以下に基づく名前付きクラスの ASCII 文字に対応します。
プラットフォーム、Unicode、および Perl ルール。 入力がオクテットに収まらない数値の場合、
FALSEが返されます。

バリアント "isFOO_A" (例: "isALPHA_A()") は、サフィックスのない基本関数と同一です
「_A」。

バリアント「isFOO_L1」は、Latin-1 (または EBCDIC 同等) 文字セットを
プラットホーム。 つまり、ASCII はサブセットであるため、ASCII であるコード ポイントは影響を受けません。
ラテン語-1の。 ただし、非 ASCII コード ポイントは Latin-1 文字であるかのように扱われます。
たとえば、「isWORDCHAR_L1()」はコード ポイント 0xDF で呼び出すと true を返します。
これは ASCII と EBCDIC の両方で単語文字です (ただし、表現は異なります)
それぞれの文字）。

バリアント「isFOO_uni」は「isFOO_L1」バリアントに似ていますが、任意の UV コード ポイントを次のように受け入れます。
入力。 コード ポイントが 255 より大きい場合、Unicode ルールを使用して、コード ポイントが XNUMX であるかどうかが判断されます。
キャラクタークラスで。 例えば、 "isWORDCHAR_uni(0x100)" は 0x100 であるため、TRUE を返します。
Unicode の LATIN CAPITAL LETTER A WITH MACRON であり、単語文字です。

バリアント「isFOO_utf8」は「isFOO_uni」に似ていますが、入力は (既知の) へのポインタです。
整形式) UTF-8 でエンコードされた文字列 (「U8*」または「char*」)。 単なる分類では、
文字列内の最初の (おそらくマルチバイト) 文字がテストされます。

バリアント「isFOO_LC」は「isFOO_A」および「isFOO_L1」バリアントと似ていますが、結果は次のとおりです。
現在のロケールで、名前の「LC」はそれを表します。 Perl が判断できる場合
現在のロケールが UTF-8 ロケールである場合、公開されている Unicode ルールが使用されます。 さもないと、
名前付き分類を与える C ライブラリ関数を使用します。 例えば、
UTF-8 ロケールではない場合、「isDIGIT_LC()」は「isdigital()」を呼び出した結果を返します。
入力がオクテットに収まらない場合は、常に FALSE が返されます。 一部のプラットフォームでは、
C ライブラリ関数に欠陥があることがわかっている場合、Perl はその結果を次のように変更します。
POSIX 標準の規則。

バリアント「isFOO_LC_uvchr」は「isFOO_LC」と似ていますが、任意の UV で定義されます。 返されるのは、
入力コードポイントが 256 未満の場合は「isFOO_LC」と同じで、ハードコーディングされたものを返します。
ロケールの影響を受けるため、大きいものでは Unicode の結果が得られます。

バリアント「isFOO_LC_utf8」は「isFOO_LC_uvchr」と似ていますが、入力は (既知の) へのポインターです。
整形式であること）UTF-8 でエンコードされた文字列（「U8*」または「char*」）。 ちょうどの分類
文字列内の最初の (おそらくマルチバイト) 文字がテストされます。

isALPHA 指定された文字がアルファベットかどうかを示すブール値を返します。
「m/[[:alpha:]]/」に似た文字。 詳細については、このセクションの上部を参照してください。
バリアント「isALPHA_A」、「isALPHA_L1」、「isALPHA_uni」、「isALPHA_utf8」の説明
「isALPHA_LC」、「isALPHA_LC_uvchr」、「isALPHA_LC_utf8」。

bool isALPHA(char ch)

英数字
指定された文字が次のいずれかであるかどうかを示すブール値を返します。
「m/[[:alnum:]]/」に類似したアルファベット文字または XNUMX 進数。 上部を参照
バリアント「isALPHANUMERIC_A」の説明については、このセクションを参照してください。
"isALPHANUMERIC_L1"、"isALPHANUMERIC_uni"、"isALPHANUMERIC_utf8"、
「isALPHANUMERIC_LC」、「isALPHANUMERIC_LC_uvchr」、および「isALPHANUMERIC_LC_utf8」。

bool isALPHANUMERIC(char ch)

isASCII 指定された文字が 128 文字のいずれかであるかどうかを示すブール値を返します。
ASCII 文字セットの文字。「m/[[:ascii:]]/」に似ています。 非
ASCII プラットフォームでは、この文字が ASCII に対応する場合は TRUE を返します。
キャラクター。 バリアント "isASCII_A()" および "isASCII_L1()" は、
「isASCII()」。 バリアントの説明については、このセクションの上部を参照してください。
「isASCII_uni」、「isASCII_utf8」、「isASCII_LC」、「isASCII_LC_uvchr」、および
「isASCII_LC_utf8」。 ただし、一部のプラットフォームには C ライブラリがないことに注意してください。
ルーチン「isascii()」。 この場合、名前に「LC」が含まれるバリアントは次のとおりです。
なしの対応するものと同じです。

また、すべての ASCII 文字は UTF-8 で不変であるため (つまり、
UTF-8 でエンコードされているかどうかに関係なく、まったく同じ表現 (常に単一バイト) を持ちます。
またはそうでない)、「isASCII」は、任意のバイトで呼び出された場合に正しい結果を返します。
UTF-8 でエンコードされた文字列かどうか。 同様に「isASCII_utf8」も正しく動作します
UTF-8 でエンコードされているかどうかにかかわらず、任意の文字列に対して。

bool isASCII(char ch)

isBLANK 指定された文字が文字であるかどうかを示すブール値を返します。
「m/[[:blank:]]/」と同様に空白とみなされます。 この上部を参照してください
バリアント「isBLANK_A」、「isBLANK_L1」、「isBLANK_uni」の説明セクション
「isBLANK_utf8」、「isBLANK_LC」、「isBLANK_LC_uvchr」、「isBLANK_LC_utf8」。 ノート、
ただし、一部のプラットフォームには C ライブラリ ルーチン「isblank()」がありません。 の
この場合、名前に「LC」が含まれるバリアントは、
対応していないもの。

bool isBLANK(char ch)

isCNTRL 指定された文字がコントロールであるかどうかを示すブール値を返します。
「m/[[:cntrl:]]/」に似た文字。 詳細については、このセクションの上部を参照してください。
バリアント「isCNTRL_A」、「isCNTRL_L1」、「isCNTRL_uni」、「isCNTRL_utf8」の説明、
「isCNTRL_LC」、「isCNTRL_LC_uvchr」、および「isCNTRL_LC_utf8」 EBCDIC プラットフォームでは、
ほとんどの場合、「isCNTRL_L1」バリアントを使用する必要があります。

bool isCNTRL(char ch)

isDIGIT 指定された文字が数字であるかどうかを示すブール値を返します。
「m/[[:digit:]]/」に。 バリアント「isDIGIT_A」と「isDIGIT_L1」は次と同一です。
「isDIGIT」。 バリアントの説明については、このセクションの上部を参照してください。
「isDIGIT_uni」、「isDIGIT_utf8」、「isDIGIT_LC」、「isDIGIT_LC_uvchr」、および
「isDIGIT_LC_utf8」。

bool isDIGIT(char ch)

isGRAPH 指定された文字がグラフィックかどうかを示すブール値を返します。
「m/[[:graph:]]/」に似た文字。 詳細については、このセクションの上部を参照してください。
バリアント「isGRAPH_A」、「isGRAPH_L1」、「isGRAPH_uni」、「isGRAPH_utf8」の説明、
「isGRAPH_LC」、「isGRAPH_LC_uvchr」、および「isGRAPH_LC_utf8」。

bool isGRAPH(char ch)

isIDCONT
指定された文字が XNUMX 番目または XNUMX 番目の文字であるかどうかを示すブール値を返します。
識別子の後続文字。 これはそれに非常に近いですが、完全ではありません
公式の Unicode プロパティ「XID_Continue」と同じです。 違いは、これは、
入力文字が「isWORDCHAR」にも一致する場合にのみ true を返します。 上部を参照
バリアント「isIDCONT_A」、「isIDCONT_L1」、「isIDCONT_LXNUMX」の説明については、このセクションを参照してください。
「isIDCONT_uni」、「isIDCONT_utf8」、「isIDCONT_LC」、「isIDCONT_LC_uvchr」、および
「isIDCONT_LC_utf8」。

bool isIDCONT(char ch)

はIDFIRST
指定された文字を最初の文字にできるかどうかを示すブール値を返します。
識別子の文字。 これは次のものに非常に近いですが、まったく同じではありません。
公式 Unicode プロパティ「XID_Start」。 違いは、これは true を返すことです
入力文字が「isWORDCHAR」にも一致する場合のみ。 この上部を参照してください
バリアント「isIDFIRST_A」、「isIDFIRST_L1」、
「isIDFIRST_uni」、「isIDFIRST_utf8」、「isIDFIRST_LC」、「isIDFIRST_LC_uvchr」、および
「isIDFIRST_LC_utf8」。

bool isIDFIRST(char ch)

isLOWER 指定された文字が小文字かどうかを示すブール値を返します。
「m/[[: lower:]]/」に似た文字。 詳細については、このセクションの上部を参照してください。
バリアント「isLOWER_A」、「isLOWER_L1」、「isLOWER_uni」、「isLOWER_utf8」の説明
「isLOWER_LC」、「isLOWER_LC_uvchr」、および「isLOWER_LC_utf8」。

bool isLOWER(char ch)

isOCTAL 指定された文字が XNUMX 進数かどうかを示すブール値を返します。
[0-7]。 バリアントは「isOCTAL_A」と「isOCTAL_L1」の XNUMX つだけです。 それぞれが同一です
「isOCTAL」にします。

bool isOCTAL(char ch)

isPRINT 指定された文字が印刷可能かどうかを示すブール値を返します。
「m/[[:print:]]/」に似た文字。 詳細については、このセクションの上部を参照してください。
バリアント「isPRINT_A」、「isPRINT_L1」、「isPRINT_uni」、「isPRINT_utf8」の説明、
「isPRINT_LC」、「isPRINT_LC_uvchr」、および「isPRINT_LC_utf8」。

bool isPRINT(char ch)

はPSXSPC
(Posix Space の略) 5.18 以降、これはすべての形式で次と同じです。
対応する「isSPACE()」マクロ。 このマクロのロケール形式は次のとおりです。
すべての Perl リリースの対応する "isSPACE()" 形式と同じです。 の
5.18 より前のリリースでは、非ロケール形式は「isSPACE()」形式とは異なります。
「isSPACE()」フォームが垂直タブと一致しないという点でのみ、
「isPSXSPC()」形式はそうします。 それ以外の場合は同一です。 したがって、このマクロは
正規表現で「m/[[:space:]]/」が一致するものに似ています。 上部を参照
バリアント「isPSXSPC_A」、「isPSXSPC_L1」、「isPSXSPC_LXNUMX」の説明については、このセクションを参照してください。
「isPSXSPC_uni」、「isPSXSPC_utf8」、「isPSXSPC_LC」、「isPSXSPC_LC_uvchr」、および
「isPSXSPC_LC_utf8」。

bool isPSXSPC(char ch)

isPUNCT 指定された文字が句読点であるかどうかを示すブール値を返します。
「m/[[:punct:]]/」に似た文字。 の定義に注意してください。
句読点は思ったほど簡単ではありません。 「POSIX 文字」を参照してください。
詳細については、perlrecharclass の「クラス」を参照してください。
バリアント「isPUNCT_A」、「isPUNCT_L1」、「isPUNCT_uni」、「isPUNCT_utf8」の説明
「isPUNCT_LC」、「isPUNCT_LC_uvchr」、および「isPUNCT_LC_utf8」。

bool isPUNCT(char ch)

isSPACE 指定された文字が空白かどうかを示すブール値を返します。
キャラクター。 これは、正規表現で「m/\s/」が一致するものに似ています。
Perl 5.18 以降、これは「m/[[:space:]]/」の動作と一致します。 先立って
5.18、このマクロのロケール形式のみ (名前に「LC」が含まれるもの)
これは、「m/[[:space:]]/」の動作と正確に一致します。 これらのリリースでは、唯一の
非ロケールのバリアントの違いは、「isSPACE()」が
垂直タブ。 (すべての垂直タブに一致するマクロについては、「isPSXSPC」を参照してください)
）バリアントの説明については、このセクションの上部を参照してください。
"isSPACE_A"、"isSPACE_L1"、"isSPACE_uni"、"isSPACE_utf8"、"isSPACE_LC"、
「isSPACE_LC_uvchr」および「isSPACE_LC_utf8」。

bool isSPACE(char ch)

isUPPER 指定された文字が大文字かどうかを示すブール値を返します。
「m/[[:upper:]]/」に似た文字。 詳細については、このセクションの上部を参照してください。
バリアント「isUPPER_A」、「isUPPER_L1」、「isUPPER_uni」、「isUPPER_utf8」の説明、
「isUPPER_LC」、「isUPPER_LC_uvchr」、および「isUPPER_LC_utf8」。

bool isUPPER(char ch)

isWORDCHAR
指定された文字が次の文字であるかどうかを示すブール値を返します。
は単語文字であり、「m/\w/」と「m/[[:word:]]/」が一致するものに似ています。
正規表現。 単語文字は、アルファベット、XNUMX 進数字、
接続用の句読点文字 (アンダースコアなど)、または「マーク」文字
それはそれらのいずれかに付属します（ある種のアクセントのように）。 「isALNUM()」は
単語文字に次のものが含まれている場合でも、下位互換性のために提供された同義語
標準的な C 言語の英数字の意味を超えています。 この上部を参照してください
バリアント「isWORDCHAR_A」、「isWORDCHAR_L1」、「isWORDCHAR_LXNUMX」の説明のセクション
「isWORDCHAR_uni」および「isWORDCHAR_utf8」。 "isWORDCHAR_LC"、"isWORDCHAR_LC_uvchr"、
および "isWORDCHAR_LC_utf8" もそこで説明されているとおりですが、さらに
プラットフォームのネイティブのアンダースコア。

bool isWORDCHAR(char ch)

isXDIGIT
指定された文字が XNUMX 進数かどうかを示すブール値を返します。
桁。 ASCII 範囲では、これらは「[0-9A-Fa-f]」です。 バリアント「isXDIGIT_A()」および
「isXDIGIT_L1()」は「isXDIGIT()」と同じです。 詳細については、このセクションの上部を参照してください。
バリアント「isXDIGIT_uni」、「isXDIGIT_utf8」、「isXDIGIT_LC」の説明、
「isXDIGIT_LC_uvchr」および「isXDIGIT_LC_utf8」。

bool isXDIGIT(char ch)

クローニング an 通訳

perl_clone
現在のインタープリターのクローンを作成して、新しいインタープリターを作成して返します。

perl_clone は次のフラグをパラメータとして受け取ります。

CLONEf_COPY_STACKS - スタックをコピーするためにも使用されます。これがなければ、
データのクローンを作成し、スタックをゼロにして、スタックと新しい Perl をコピーします。
インタプリタは、前のインタプリタとまったく同じ時点で実行する準備ができています。 の
疑似フォーク コードは COPY_STACKS を使用しますが、threads->create は使用しません。

CLONEf_KEEP_PTR_TABLE - perl_clone は、古いテーブルのポインタを持つ ptr_table を保持します。
変数をキーとして、新しい変数を値として使用すると、次のことを確認できます。
何かが複製されており、再度複製するのではなく、値を使用して、
参照カウントを増やします。 KEEP_PTR_TABLE が設定されていない場合、perl_clone は
関数「ptr_table_free(PL_ptr_table); PL_ptr_table = NULL;」を使用した ptr_table、
これを保持する理由は、独自の変数の一部を複製したい場合です。
グラフ Perl スキャンの外では、このコードの例は thread.xs create にあります。

CLONEf_CLONE_HOST - これは win32 のもので、unix では無視され、perls に通知されます。
自分自身をクローンするための win32host コード (C++)。これは、必要に応じて win32 で必要です。
単に何かを実行したい場合に、XNUMX つのスレッドを同時に実行します。
Perl インタプリタを分離し、それを破棄して元のインタプリタに戻します。
何もする必要はありません。

PerlInterpreter* perl_clone(
Perlインタープリタ *proto_perl、
UVフラグ
)

コンパイル時 スコープ フック

Bhk無効
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

適切なフィールドをクリアして、この BHK 構造内のエントリを一時的に無効にします。
フラグ。 which どのエントリを無効にするかを示すプリプロセッサ トークンです。

void BhkDISABLE(BHK *hk、どれ)

BhkENABLE
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

適切なフラグを設定して、この BHK 構造内のエントリを再度有効にします。 which
どのエントリを有効にするかを示すプリプロセッサ トークンです。 これはアサートします（下で）
-DDEBUGGING) エントリに有効なポインターが含まれていない場合。

void BhkENABLE(BHK *hk、どれ)

BhkENTRY_set
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

BHK 構造にエントリを設定し、それが有効であることを示すフラグを設定します。
which どのエントリを設定するかを示す前処理トークンです。 の種類 PTR
エントリーによります。

void BhkENTRY_set(BHK *hk, which, void *ptr)

ブロックフック_レジスタ
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

Perl の字句スコープが変更されたときに呼び出されるフックのセットを登録します。
コンパイル時間。 perlguts の「コンパイル時のスコープ フック」を参照してください。

注: この関数は、次のパラメータを指定して Perl_blockhook_register として明示的に呼び出す必要があります。
THX_パラメータ。

void Perl_blockhook_register(pTHX_ BHK *hk)

COP 暗示 ハッシュ

cophh_2hv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

キー/値の完全なセットを表す標準 Perl ハッシュを生成して返します。
警官のヒントのハッシュ内のペア コフ. フラグ は現在使用されていないため、ゼロにする必要があります。

HV * cophh_2hv(const COPHH *cophh、U32 フラグ)

cophh_copy
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

警官のヒントのハッシュの完全なコピーを作成して返します コフ.

COPHH * cophh_copy(COPHH *cophh)

cophh_delete_pv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_delete_pvn」と似ていますが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

COPHH * cophh_delete_pv(const COPHH *cophh,
const char *キー、U32 ハッシュ、
U32 フラグ)

cophh_delete_pvn
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

警官ヒントのハッシュからキーとそれに関連付けられた値を削除します コフ、および返します
変更されたハッシュ。 返されたハッシュ ポインタは通常、ハッシュ ポインタと同じではありません。
渡されたハッシュ ポインター。入力ハッシュは関数によって消費され、
それへのポインタはその後使用してはなりません。 必要に応じて「cophh_copy」を使用してください
両方のハッシュ。

キーは次のように指定されます。 キーPV と キーレン。 場合 フラグ 「COPHH_KEY_UTF8」ビットがある
設定されている場合、キー オクテットは UTF-8 として解釈され、それ以外の場合は次のように解釈されます。
ラテン語-1。 ハッシュ キー文字列の事前に計算されたハッシュ、または事前に計算されていない場合はゼロです。
事前計算済み。

COPHH * cophh_delete_pvn(COPHH *cophh,
const char *keypv、
STRLEN キーレン、U32 ハッシュ、
U32 フラグ)

cophh_delete_pvs
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_delete_pvn」と似ていますが、文字列/長さの代わりにリテラル文字列を受け取ります。
ペアであり、事前計算されたハッシュはありません。

COPHH * cophh_delete_pvs(const COPHH *cophh,
const char *キー、U32 フラグ)

cophh_delete_sv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_delete_pvn」と似ていますが、文字列と長さのペアの代わりに Perl スカラーを受け取ります。

COPHH * cophh_delete_sv(const COPHH *cophh, SV *key,
U32 ハッシュ、U32 フラグ)

cophh_fetch_pv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_fetch_pvn」と似ていますが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

SV * cophh_fetch_pv(const COPHH *cophh,
const char *キー、U32 ハッシュ、
U32 フラグ)

cophh_fetch_pvn
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

警官のヒントのハッシュでエントリを検索します コフ で指定されたキーを使用して キーPV と
キーレン。 場合 フラグ 「COPHH_KEY_UTF8」ビットが設定されている場合、キー オクテットが解釈されます
それ以外の場合は、Latin-8 として解釈されます。 ハッシュ 事前に計算されたハッシュです
キー文字列の値、または事前計算されていない場合はゼロ。 定命の者を返す
キーに関連付けられた値のスカラー コピー、または &PL_sv_placeholder (存在する場合)
キーに関連付けられた値はありません。

SV * cophh_fetch_pvn(const COPHH *cophh,
const char *keypv、
STRLEN キーレン、U32 ハッシュ、
U32 フラグ)

cophh_fetch_pvs
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_fetch_pvn」と似ていますが、文字列/長さの代わりにリテラル文字列を受け取ります。
ペアであり、事前計算されたハッシュはありません。

SV * cophh_fetch_pvs(const COPHH *cophh,
const char *キー、U32 フラグ)

cophh_fetch_sv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_fetch_pvn」と似ていますが、文字列と長さのペアの代わりに Perl スカラーを受け取ります。

SV * cophh_fetch_sv(const COPHH *cophh, SV *key,
U32 ハッシュ、U32 フラグ)

cophh_free
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

警官のヒントのハッシュを破棄する コフ、それに関連付けられているすべてのリソースを解放します。

void cophh_free(COPHH *cophh)

cophh_new_empty
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

エントリを含まない新しい警官ヒント ハッシュを生成して返します。

COPHH * cophh_new_empty()

cophh_store_pv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_store_pvn」と似ていますが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

COPHH * cophh_store_pv(const COPHH *cophh,
const char *キー、U32 ハッシュ、
SV *値、U32フラグ)

cophh_store_pvn
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

キーに関連付けられた値を警官ヒントのハッシュに保存します コフ、および返します
変更されたハッシュ。 返されたハッシュ ポインタは通常、ハッシュ ポインタと同じではありません。
渡されたハッシュ ポインター。入力ハッシュは関数によって消費され、
それへのポインタはその後使用してはなりません。 必要に応じて「cophh_copy」を使用してください
両方のハッシュ。

キーは次のように指定されます。 キーPV と キーレン。 場合 フラグ 「COPHH_KEY_UTF8」ビットがある
設定されている場合、キー オクテットは UTF-8 として解釈され、それ以外の場合は次のように解釈されます。
ラテン語-1。 ハッシュ キー文字列の事前に計算されたハッシュ、または事前に計算されていない場合はゼロです。
事前計算済み。

値 このキーに保存するスカラー値です。 値 これによってコピーされます
したがって、この関数はその関数への参照の所有権を取得しません。
スカラーへの変更は、cop ヒントに表示される値には反映されません。
ハッシュ。 複合型のスカラーは参照整合性を保って保存されませんが、
文字列に強制されます。

COPHH * cophh_store_pvn(COPHH *cophh, const char *keypv,
STRLEN キーレン、U32 ハッシュ、
SV *値、U32フラグ)

cophh_store_pvs
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_store_pvn」と似ていますが、文字列/長さの代わりにリテラル文字列を受け取ります。
ペアであり、事前計算されたハッシュはありません。

COPHH * cophh_store_pvs(const COPHH *cophh,
const char *キー、SV *値、
U32 フラグ)

cophh_store_sv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「cophh_store_pvn」と似ていますが、文字列と長さのペアの代わりに Perl スカラーを受け取ります。

COPHH * cophh_store_sv(const COPHH *cophh, SV *key,
U32 ハッシュ、SV *値、U32 フラグ)

COP 暗示 リーディング

cop_hints_2hv
ヒントの完全なセットを表す標準 Perl ハッシュを生成して返します。
警察へのエントリー 警官. フラグ は現在使用されていないため、ゼロにする必要があります。

HV * cop_hints_2hv(const COP *cop、U32 フラグ)

cop_hints_fetch_pv
「cop_hints_fetch_pvn」と似ていますが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

SV * cop_hints_fetch_pv(const COP *cop,
const char *キー、U32 ハッシュ、
U32 フラグ)

cop_hints_fetch_pvn
警察のヒントエントリを調べる 警官 で指定されたキーを使用して キーPV と キーレン.
If フラグ 「COPHH_KEY_UTF8」ビットが設定されている場合、キー オクテットは次のように解釈されます。
UTF-8、それ以外の場合は Latin-1 として解釈されます。 ハッシュ 事前に計算されたハッシュです
キー文字列、または事前計算されていない場合はゼロ。 mortal スカラーを返します
キーに関連付けられた値のコピー、または &PL_sv_placeholder (存在しない場合)
キーに関連付けられた値。

SV * cop_hints_fetch_pvn(const COP *cop,
const char *keypv、
STRLEN キーレン、U32 ハッシュ、
U32 フラグ)

cop_hints_fetch_pvs
「cop_hints_fetch_pvn」と似ていますが、文字列/長さの代わりにリテラル文字列を受け取ります。
ペアであり、事前計算されたハッシュはありません。

SV * cop_hints_fetch_pvs(const COP *cop,
const char *キー、U32 フラグ)

cop_hints_fetch_sv
「cop_hints_fetch_pvn」と似ていますが、文字列/長さの代わりに Perl スカラーを受け取ります
ペア。

SV * cop_hints_fetch_sv(const COP *cop, SV *key,
U32 ハッシュ、U32 フラグ)

カスタム オペレーター

カスタムオプレジスタ
カスタム オペレーションを登録します。 perlguts の「カスタム演算子」を参照してください。

注: この関数は、次のパラメータを指定して Perl_custom_op_register として明示的に呼び出す必要があります。
THX_パラメータ。

void Perl_custom_op_register(pTHX_
Perl_ppaddr_t ppaddr、
const XOP *xop)

カスタムオプ_xop
指定されたカスタム演算の XOP 構造を返します。 このマクロを考慮する必要があります
OP_NAME およびその他のアクセス マクロの内部: 代わりにそれらを使用してください。 このマクロ
関数を呼び出します。 5.19.6 より前は、これは関数として実装されていました。

注: この関数は、aTHX_ を指定して Perl_custom_op_xop として明示的に呼び出す必要があります。
パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

const XOP * Perl_custom_op_xop(pTHX_ const OP *o)

XopDISABLE
適切なフラグをクリアして、XOP のメンバーを一時的に無効にします。

void XopDISABLE(XOP *xop、どれ)

XopENABLE
無効になった XOP のメンバーを再度有効にします。

void XopENABLE(XOP *xop、どれ)

XopENTRY
XOP 構造体のメンバーを返します。 which どのエントリを示す cpp トークンです
戻るために。 メンバーが設定されていない場合、デフォルト値が返されます。 リターン
タイプはによって異なります which。 このマクロは引数を複数回評価します。 もし、あんたが
「Perl_custom_op_xop」を使用して「OP *」から「XOP *」を取得している場合は、さらに多くのものを使用します
代わりに効率的な「XopENTRYCUSTOM」を使用してください。

XopENTRY(XOP *xop、どれ)

XopENTRYCUSTOM
「XopENTRY(XopENTRY(Perl_custom_op_xop(aTHX_ o), which)」とまったく同じですが、それ以上です
効率的。 の which パラメータは「XopENTRY」と同じです。

XopENTRYCUSTOM(const OP *o、どれ)

XopENTRY_set
XOP構造体のメンバーを設定します。 which どのエントリを対象にするかを示す cpp トークンです。
設定。 使用可能なメンバーの詳細については、perlguts の「カスタム オペレーター」を参照してください。
そしてそれらがどのように使われるか。 このマクロは引数を複数回評価します。

void XopENTRY_set(XOP *xop, どれ, 値)

XopFLAGS
XOP のフラグを返します。

U32 XopFLAGS(XOP *xop)

CV 操作 機能

このセクションでは、コード値またはサブルーチンである CV を操作する関数について説明します。
詳細については、「perlguts」を参照してください。

呼び出し元_cx
XSUB ライターに相当するもの caller（）。 返された「PERL_CONTEXT」構造体
「呼び出し元」によって Perl に返されたすべての情報を見つけるために問い合わせることができます。
XSUB はスタック フレームを取得しないので、「caller_cx(0, NULL)」が返されることに注意してください。
すぐ周囲の Perl コードの情報。

この関数は、&DB::sub への自動呼び出しをスキップします。
デバッガ。 要求されたスタック フレームが「DB::sub」によって呼び出されたサブルーチンである場合、戻り値は
value は、正しい行があるため、「DB::sub」への呼び出しのフレームになります。
番号/など通話サイト用。 もしも dbcxp 「NULL」以外の場合は、に設定されます。
サブコール自体のフレームへのポインタ。

const PERL_CONTEXT * caller_cx(
I32レベル、
const PERL_CONTEXT **dbcxp
)

CvSTASH CV のスタッシュを返します。 スタッシュは、シンボル テーブルのハッシュであり、
サブルーチンが定義されたパッケージ内のパッケージスコープ変数。 ために
詳細については、perlguts を参照してください。

これは、XS AUTOLOAD サブシステムでも特別に使用されます。 「XSUB による自動ロード」を参照してください。
パールガッツで。

HV* CVSTASH(CV* CV)

find_runcv
現在実行中の sub または eval に対応する CV を見つけます。 db_seqp が
non_null、DB パッケージ内の CV をスキップし、*db_seqp に cop を設定します。
DB:: コードが入力された時点のシーケンス番号。 (これにより、
デバッガは、ブレークポイントのスコープではなくブレークポイントのスコープで評価します。
デバッガ自体。）

CV* find_runcv(U32 *db_seqp)

get_cv 「strlen」を使用して「name」の長さを取得し、「get_cvn_flags」を呼び出します。

注: この関数の perl_ 形式は非推奨です。

CV* get_cv(const char* 名前、I32 フラグ)

get_cvn_flags
指定された Perl サブルーチンの CV を返します。 「フラグ」が渡されるのは
「gv_fetchpvn_flags」。 「GV_ADD」が設定されており、Perlサブルーチンが存在しない場合
その後、それが宣言されます (これは「サブ名;」と言うのと同じ効果があります)。 もしも
「GV_ADD」が設定されておらず、サブルーチンが存在しない場合は、NULL が返されます。

注: この関数の perl_ 形式は非推奨です。

CV* get_cvn_flags(const char* 名前, STRLEN len,
I32 フラグ)

デバッギング ユーティリティ

ダンプオール
「PL_main_root」で始まる現在のプログラムの optree 全体をダンプします。
「STDERR」。 また、「PL_defstash」に表示されているすべてのサブルーチンの optree もダンプします。

void dump_all()

dump_packsubs
「stash」内のすべての表示可能なサブルーチンの optree をダンプします。

void dump_packsubs(const HV* スタッシュ)

op_dump OP "o" から始まる optree を "STDERR" にダンプします。

void op_dump(const OP *o)

sv_dump SV の内容を「STDERR」ファイルハンドルにダンプします。

出力の例については、「Devel::Peek」を参照してください。

void sv_dump(SV* sv)

ディスプレイ と ダンプ 機能

pv_display
そして

pv_escape(dsv,pv,cur,pvlim,PERL_PV_ESCAPE_QUOTE);

ただし、len > cur の場合、文字列に追加の「\0」が追加されます。
pv[cur] は「\0」です。

最後の文字列は pvlim よりも最大 7 文字長くなる可能性があることに注意してください。

char* pv_display(SV *dsv, const char *pv, STRLEN cur,
STRLEN len、STRLEN pvlim)

pv_escape
pv の最初の「count」文字だけをエスケープし、結果を次のような dsv に入れます。
エスケープされた文字列のサイズが「最大」文字数を超えないこと。
不完全なエスケープ シーケンスが含まれています。 エスケープされるバイト数は次のようになります。
null でない場合は、STRLEN *escaped パラメータで返されます。 DSV のとき
パラメータが null の場合、実際にはエスケープは行われませんが、エスケープされるバイト数は
エスケープされない場合は null が計算されます。

flags に PERL_PV_ESCAPE_QUOTE が含まれる場合、文字列内の二重引用符はすべて
逃げられることもあります。

通常、SV はエスケープ文字列が準備される前にクリアされますが、
PERL_PV_ESCAPE_NOCLEAR が設定されている場合、これは発生しません。

PERL_PV_ESCAPE_UNI が設定されている場合、入力文字列は次の場合に UTF-8 として扱われます。
PERL_PV_ESCAPE_UNI_DETECT が設定されている場合、入力文字列は次を使用してスキャンされます。
「is_utf8_string()」でUTF-8かどうかを判断します。

PERL_PV_ESCAPE_ALL が設定されている場合、すべての入力文字は「\x01F1」を使用して出力されます。
スタイルエスケープ、そうでない場合、PERL_PV_ESCAPE_NONASCII が設定されている場合は、非 ASCII 文字のみ
このスタイルを使用してエスケープされます。 それ以外の場合は、255 を超える文字のみがそうなります。
逃げた。 他の印刷不可能な文字は、XNUMX 進数または次のような一般的なエスケープ パターンを使用します。
「\n」。 それ以外の場合、PERL_PV_ESCAPE_NOBACKSLASH の場合、255 より下のすべての文字は
印刷可能として扱われ、リテラルとして出力されます。

PERL_PV_ESCAPE_FIRSTCHAR が設定されている場合、文字列の最初の文字のみが設定されます。
最大値に関係なく逃げました。 出力が XNUMX 進数である場合は、次のようになります。
プレーンな XNUMX 進シーケンスとして返されます。 したがって、出力は単一の文字、または
XNUMX 進数のエスケープ シーケンス、「\n」などの特殊なエスケープ、または XNUMX 進数の値。

PERL_PV_ESCAPE_RE が設定されている場合、使用されるエスケープ文字は「%」ではなく「%」になります。
「\\」。 これは、正規表現にはバックスラッシュ付きシーケンスが含まれることが非常に多いためです。
「%」はパターンでは特に一般的な文字ではありません。

dsv が保持するエスケープされたテキストへのポインタを返します。

char* pv_escape(SV *dsv, char const * const str,
const STRLEN カウント、const STRLEN 最大、
STRLEN * const がエスケープされ、
const U32 フラグ)

pv_pretty
文字列を表示可能なものに変換し、エスケープを処理します。 pv_escape()
引用符と省略記号をサポートします。

PERL_PV_PRETTY_QUOTE フラグが設定されている場合、結果は次の二重引用符で囲まれます。
文字列内の二重引用符はエスケープされました。 それ以外の場合、PERL_PV_PRETTY_LTGT
フラグが設定されている場合、結果は山かっこで囲まれます。

PERL_PV_PRETTY_ELLIPSES フラグが設定されていて、文字列内のすべての文字が設定されていない場合
出力すると、文字列に省略記号「...」が追加されます。 これに注意してください
引用された後に発生します。

start_color が null 以外の場合、開始引用符の後に挿入されます (
XNUMX つあります）が、エスケープされたテキストの前にあります。 end_color が null でない場合は、
エスケープされたテキストの後、引用符または省略記号の前に挿入されます。

dsv が保持する整形されたテキストへのポインタを返します。

char* pv_pretty(SV *dsv, char const * const str,
const STRLEN カウント、const STRLEN 最大、
char const * const start_color、
char const * const end_color、
const U32 フラグ)

埋め込み 機能

cv_clone
CV を複製して、字句クロージャを作成します。 プロト のプロトタイプを提供します
機能: コード、パッド構造、その他の属性。 原型は
コードが参照する外部語彙のキャプチャと組み合わせます。
すぐ周囲のコードの現在実行中のインスタンスから取得されます。

CV * cv_clone(CV *プロト)

cv_name 主にエラー報告に使用するために、CV の名前を含む SV を返します。
CV は実際には GV である可能性があり、その場合、返される SV には GV が保持されます。
名前。 GV または CV 以外のものは、すでに保持されている文字列として扱われます。
サブネームですが、将来変更される可能性があります。

SV は XNUMX 番目の引数として渡すことができます。 そうであれば、名前が割り当てられます
そしてそれは返されます。 それ以外の場合、返された SV は新しい定命の者になります。

Status フラグ CV_NAME_NOTQUAL を含めると、パッケージ名は含まれません。
最初の引数が CV でも GV でもない場合、このフラグは無視されます (
変化する）。

SV * cv_name(CV *cv、SV *sv、U32 フラグ)

cv_undef
CV のアクティブなコンポーネントをすべてクリアします。 これは、次のいずれかの原因で発生する可能性があります。
明示的な「undef &foo」、または参照カウントがゼロになることによって。 前者で
この場合、CvOUTSIDE ポインタを保持し、匿名の子が引き続きアクセスできるようにします。
完全な語彙範囲チェーンに従います。

void cv_undef(CV* cv)

find_rundefsv
の字句スコープ内で $_ という名前の変数を検索して返します。
現在実行中の関数。 これは字句 $_ である場合もありますが、それ以外の場合は
グローバルなもの。

SV * find_rundefsv()

find_rundefsvoffset
廃止されました! この関数は Perl の将来のリリースから削除される予定です。
新しいコードには使用しないでください。 既存のコードから削除してください。

現在実行中のパッド内で字句 $_ の位置を見つけます。
関数。 現在のパッドのオフセットを返します。パッドがない場合は「NOT_IN_PAD」を返します。
スコープ内の字句 $_ (この場合、代わりにグローバルなものを使用する必要があります)。
「find_rundefsv」の方が便利そうです。

注: この関数の perl_ 形式は非推奨です。

PADOFFSET find_rundefsvoffset()

イントロ_マイ
「私の」変数を可視ステータスに「導入」します。 これは、次の場所で解析中に呼び出されます。
各ステートメントの終わりで、後続のステートメントで字句変数が見えるようにします。
ステートメント。

U32 イントロ_my()

ロードモジュール
名前の文字列部分が指す名前のモジュールをロードします。 ご了承ください
ファイル名ではなく、実際のモジュール名を指定する必要があります。 たとえば、代わりに「Foo::Bar」
「Foo/Bar.pm」の。 フラグは、PERL_LOADMOD_DENY、PERL_LOADMOD_NOIMPORT、または
PERL_LOADMOD_IMPORT_OPS (またはフラグがない場合は 0)。 ver、NULL ではなく指定されている場合、
「use Foo::Bar VERSION」と同様のバージョン セマンティクスを提供します。 オプションの
末尾の SV* 引数を使用して、モジュールの引数を指定できます。 輸入（）
「use Foo::Bar VERSION LIST」と同様のメソッド。 これらは次の文字で終了する必要があります
最後のNULLポインタ。 このリストは、次の場合にのみ省略できることに注意してください。
PERL_LOADMOD_NOIMPORT フラグが使用されています。 それ以外の場合は、少なくとも XNUMX つの NULL
デフォルトのインポートリストを指定するポインタが必要です。

指定された各「SV*」パラメータの参照カウントがデクリメントされます。

void load_module(U32 フラグ、SV* 名、SV* バージョン、...)

新しいパッドネームリスト
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

新しいパッド名リストを作成します。 「max」は、スペースが含まれる最大のインデックスです。
割り当てられました。

PADNAMELIST * newPADNAMELIST(size_t max)

新しいPADNAMEアウター
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

新しいパッド名を構築して返します。 この関数は、次のような名前にのみ使用してください。
外部語彙を参照してください。 (「newPADNAMEpvn」も参照してください。) 外側の はアウターパッドの名前です
これは鏡です。 返されたパッド名にはすでに PADNAMEt_OUTER フラグが付いています
設定します。

PADNAME * newPADNAMEouter(PADNAME *outer)

新しいPADNAMEpvn
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

新しいパッド名を構築して返します。 s UTF8 文字列である必要があります。 これは使用しないでください
外部字句を指すパッド名の場合。 「newPADNAMEouter」を参照してください。

PADNAME * newPADNAMEpvn(const char *s, STRLEN len)

スレッドフックなし
スレッドがない場合に perl_destruct のスレッド フックを提供するスタブ。

int nothreadhook()

パッド名リストフェッチ
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

指定されたインデックスからパッド名を取得します。

PADNAME * Padnamelist_fetch(PADNAMELIST *pnl,
SSize_t キー)

パッド名リストストア
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

指定されたインデックスにパッド名 (null の場合もあります) を格納し、既存のパッド名を解放します。
そのスロットのパッド名。

PADNAME ** Padnamelist_store(PADNAMELIST *pnl,
SSize_t キー、PADNAME *val)

Pad_add_anon
現在コンパイル中のパッド内に (「pad_alloc」経由で) 場所を割り当てます。
現在コンパイル中の内部に字句的にスコープされる匿名関数
関数。 関数 ファンク はパッドにリンクされており、その「CvOUTSIDE」リンクは
外側のスコープは参照ループを避けるために弱められています。

参照カウントが XNUMX つ盗まれているため、「SvREFCNT_inc(func)」を実行する必要がある場合があります。

オプタイプ パッドエントリが行う操作のタイプを示すオペコードである必要があります。
サポートするために。 これは操作セマンティクスには影響しませんが、デバッグに使用されます。

PADOFFSET Pad_add_anon(CV *func、I32 optype)

パッド追加名_pv
「pad_add_name_pvn」とまったく同じですが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

PADOFFSET Pad_add_name_pv(const char *name、U32 フラグ、
HV *typestash、HV *ourstash)

パッド追加名_pvn
現在コンパイル中のパッド内で名前付き字句変数の場所を割り当てます。
名前とその他のメタデータをパッドの名前部分に保存し、
変数の字句スコープを管理するための準備。 のオフセットを返します。
割り当てられたパッドスロット。

名前pv/ネームレン 先頭の記号を含む変数名を指定します。 もしも タイプスタッシュ
が null でない場合、名前は型付き字句の名前であり、これによって型が識別されます。 もしも
私たちの隠し場所 は null ではなく、パッケージ変数への字句参照であり、これは
パッケージを識別します。 次のフラグは OR 演算できます。

Padadd_OUR は、パッケージ変数であるかどうかを冗長的に指定します。
Padadd_STATE 変数は値を永続的に保持します
Padadd_NO_DUP_CHECK 字句シャドウイングのチェックをスキップ

PADOFFSET Pad_add_name_pvn(const char *namepv,
STRLEN ネームレン、U32 フラグ、
HV *typestash、HV *ourstash)

パッド追加名_sv
「pad_add_name_pvn」とまったく同じですが、SV の形式で名前文字列を受け取ります。
文字列と長さのペアの代わりに。

PADOFFSET Pad_add_name_sv(SV *名前、U32 フラグ、
HV *typestash、HV *ourstash)

パッド割り当て
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

現在コンパイル中のパッド内に場所を割り当て、そのオフセットを返します。
割り当てられたパッドスロット。 パッドスロットには最初は名前が付けられていません。 tmpタイプ 　
必要なパッド エントリの種類を示すフラグのセット。
割り当てられたパッド エントリの値 SV:

SVs_PADMY 名前付き字句変数 (「my」、「our」、「state」)
SVs_PADTMP 名前のない一時ストア
再帰レベル間で共有される SVf_READONLY 定数

「SVf_READONLY」は、perl 5.20 以降、ここでのみサポートされています。 より早く作業するには
バージョンも同様に、「SVf_READONLY|SVs_PADTMP」を使用します。 「SVf_READONLY」では発生しません
パッド スロット内の SV は読み取り専用としてマークされますが、単に「pad_alloc」に次のように指示します。
it 意志 (呼び出し元によって) 読み取り専用にされるか、少なくともそのように扱われる必要があります。

オプタイプ パッドエントリが行う操作のタイプを示すオペコードである必要があります。
サポートするために。 これは操作セマンティクスには影響しませんが、デバッグに使用されます。

PADOFFSET Pad_alloc(I32 optype、U32 tmptype)

Pad_findmy_pv
「pad_findmy_pvn」とまったく同じですが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

PADOFFSET Pad_findmy_pv(const char *name、U32 フラグ)

Pad_findmy_pvn
字句変数の名前を指定して、現在コンパイル中の変数内での位置を見つけます。
パッド。 名前pv/ネームレン 先頭の記号を含む変数名を指定します。 フラグ
予約されており、ゼロでなければなりません。 現在のパッドにはなく、
字句的に囲むスコープのパッドを追加すると、その疑似エントリが
現在のパッド。 現在のパッドのオフセットを返します。そのようなものがない場合は「NOT_IN_PAD」を返します。
語彙は範囲内です。

PADOFFSET Pad_findmy_pvn(const char *namepv,
STRLEN ネームレン、U32 フラグ)

Pad_findmy_sv
「pad_findmy_pvn」とまったく同じですが、SV の形式で名前文字列を受け取ります。
文字列と長さのペアの代わりに。

PADOFFSET Pad_findmy_sv(SV *名前、U32 フラグ)

パッドセットv
オフセットの値を設定します po 現在の (コンパイルまたは実行) パッド内。 使用
マクロ PAD_SETSV() この関数を直接呼び出すのではなく、

void Pad_setsv(PADOFFSET po, SV *sv)

Pad_sv オフセットの値を取得します po 現在の (コンパイルまたは実行中の) パッド内。 マクロを使用する
この関数を直接呼び出す代わりに、PAD_SV を呼び出します。

SV * Pad_sv(PADOFFSET po)

パッド_整頓
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッドが属するコードのコンパイルの最後にパッドを整理します。 求人
ここで実行されるのは次のとおりです: anonsub プロトタイプのパッドからほとんどのものを削除します。 それを与える
@_; 一時的なものとしてマークを付けます。 type サブルーチンの種類を示します。

Padtidy_SUB 通常のサブルーチン
字句クロージャーのpadtidy_SUBCLONEプロトタイプ
パティディ_FORMAT 形式

void Pad_tidy(padtidy_type タイプ)

perl_alloc
新しい Perl インタープリタを割り当てます。 「パーレンブド」を参照。

PerlInterpreter* perl_alloc()

perl_construct
新しい Perl インタープリタを初期化します。 「パーレンブド」を参照。

void perl_construct(PerlInterpreter *my_perl)

perl_destruct
Perl インタープリタをシャットダウンします。 「パーレンブド」を参照。

int perl_destruct(PerlInterpreter *my_perl)

perl_free
Perlインタプリタをリリースします。 「パーレンブド」を参照。

void perl_free(PerlInterpreter *my_perl)

perl_parse
Perl インタプリタに Perl スクリプトを解析するように指示します。 「パーレンブド」を参照。

int perl_parse(PerlInterpreter *my_perl,
XSINIT_t xsinit、int argc、
char** argv、char** env)

perl_run
Perl インタープリターに実行を指示します。 「パーレンブド」を参照。

int perl_run(PerlInterpreter *my_perl)

require_pv
Perl に文字列引数で指定されたファイルを「要求する」ように指示します。 それは次のことに類似しています
Perl コード「eval "require '$file'"」。 そのように実装されています。 検討
代わりにload_moduleを使用してください。

注: この関数の perl_ 形式は非推奨です。

void require_pv(const char* pv)

例外 ハンドリング （単純） マクロ

dXCPT 例外処理に必要なローカル変数を設定します。 「例外処理」を参照してください。
パールガッツで。

dXCPT;

XCPT_CATCH
catch ブロックを導入します。 perlguts の「例外処理」を参照してください。

XCPT_RETHROW
以前にキャッチした例外を再スローします。 perlguts の「例外処理」を参照してください。

XCPT_RETHROW;

XCPT_TRY_END
try ブロックを終了します。 perlguts の「例外処理」を参照してください。

XCPT_TRY_START
try ブロックを開始します。 perlguts の「例外処理」を参照してください。

グローバル Variables

これらの変数はプロセス全体に対してグローバルです。 これらはすべての通訳者間で共有されます
プロセス内のすべてのスレッド。

PL_チェック
「チェック」フェーズで呼び出される関数の、オペコードによってインデックス付けされた配列
Perl コードのコンパイル中の optree 構築の様子。 ほとんどの (すべてではない) タイプの場合
操作の場合、操作が最初に構築され、子操作が設定されると、
の適切な要素によって参照されるチェック関数を通じてフィルタリングされる
この配列。 新しい操作は、唯一の引数として check 関数に渡されます。
そして、チェック関数は完了した操作を返します。 チェック機能は (
名前が示すとおり) 演算子の有効性とシグナルエラーをチェックします。 また、
操作の一部を初期化または変更するか、または次のようなより根本的な手術を実行します。
子演算を追加または削除したり、演算を破棄して別の演算を返したりすることもできます。
その代わりに。

この関数ポインターの配列は、コンパイルにフックするのに便利な場所です。
プロセス。 XS モジュールは、次のいずれかの代わりに独自のカスタム チェック関数を配置できます。
標準的なものは、特定の種類の op のコンパイルに影響を与えます。
ただし、カスタム チェック関数が標準チェックを完全に置き換えることはできません。
関数 (または別のモジュールのカスタム チェック関数)。 モジュール
代わりにチェックを変更する必要があります ラップ 既存のチェック機能。 カスタム
check 関数は、そのカスタム動作をいつ適用するかを選択する必要があります。 の中に
通常、OP で特別なことを何もしないと判断した場合、チェーンする必要があります。
既存の op 関数。 したがって、チェック機能はチェーンでリンクされています。
最後にコアのベースチェッカー。

スレッドの安全性を確保するため、モジュールはこの配列に直接書き込むべきではありません。 代わりに、使用してください
関数「wrap_op_checker」。

PL_キーワード_プラグイン
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

拡張キーワードを処理するために使用される関数を指す関数ポインター。 の
関数は次のように宣言する必要があります

int キーワード_プラグイン_関数(pTHX_
char *keyword_ptr、STRLEN キーワード_len、
OP **op_ptr)

この関数は、候補となるキーワードが見つかるたびにトークナイザーから呼び出されます。
「keyword_ptr」はパーサーの入力バッファー内の単語を指し、「keyword_len」はパーサーの入力バッファー内の単語を指します。
その長さを与えます。 null で終了していません。 機能は検査することが期待されています
単語、および場合によっては %^H などの他の状態を使用して、それを実行するかどうかを決定します。
拡張キーワードとして扱います。 そうでない場合、関数は返す必要があります
「KEYWORD_PLUGIN_DECLINE」と指定すると、通常のパーサー プロセスが続行されます。

関数がキーワードを処理したい場合は、まず何かを解析する必要があります
キーワードによって導入される構文の一部であるキーワードの後に​​続きます。 見る
詳細については、「レクサーインターフェイス」を参照してください。

キーワードを処理する場合、プラグイン関数は「OP」のツリーを構築する必要があります。
解析されたコードを表す構造体。 ツリーのルートは次のとおりである必要があります。
*op_ptr に保存されます。 次に、関数は構文を示す定数を返します。
解析した構造の役割: の場合は「KEYWORD_PLUGIN_STMT」
完全なステートメント、または式の場合は「KEYWORD_PLUGIN_EXPR」。 注意してください。
ステートメント構造は式内で使用できません (「do BLOCK」と「do BLOCK」を使用する場合を除く)
同様）、式は完全なステートメントではありません（少なくとも、
セミコロンで終了します)。

キーワードが処理される場合、プラグイン関数には (コンパイル時) 側も含まれる場合があります。
効果。 「%^H」を変更したり、関数を定義したりする場合があります。 通常、if 側
エフェクトはハンドラーの主な目的であり、オブジェクトに対する操作を生成することは望ましくありません。
通常のコンピレーションに含まれます。 この場合でも、次のことが必要です。
op ツリーを指定しますが、単一の null op を生成するだけで十分です。

*PL_keyword_plugin 関数は全体的にこのように動作する必要があります。
ただし、従来は既存のハンドラーを完全に置き換えるわけではありませんでした。
関数。 代わりに、独自のものを割り当てる前に、「PL_keyword_plugin」のコピーを取得してください。
それへの関数ポインタ。 ハンドラー関数は、それが該当するキーワードを探す必要があります。
それらに興味を持って対処します。 興味のない場合は、
プラグイン関数を保存し、受け取った引数を渡します。 したがって
「PL_keyword_plugin」は実際にはハンドラー関数のチェーンを指します。
キーワードを処理する機会があり、チェーンの最後の関数のみを処理できます。
(Perl コアに組み込まれています) は通常、「KEYWORD_PLUGIN_DECLINE」を返します。

GV 機能

GV は Perl の typeglob、つまり *foo に対応する構造体です。 構造物です
これは、$foo、@foo、%foo に対応するスカラー、配列、ハッシュなどへのポインターを保持します。

GV は通常、Perl がその値を保存するスタッシュ (シンボル テーブル ハッシュ) 内の値として見つかります。
グローバル変数。

GvAV GV から AV を返します。

AV* GvAV(GV* gv)

GvCV GV から CV を返します。

CV* GvCV(GV* gv)

GvHV GV から HV を返します。

HV* GvHV(GV* gv)

GvSV GV から SV を返します。

SV* GvSV(GV* gv)

gv_const_sv
"gv" が、サブルーチン エントリが定数 sub である typeglob の場合、
インライン化、または「gv」は、そのようなものに昇格されるプレースホルダー参照です。
typeglob は、サブルーチンによって返された値を返します。 それ以外の場合は、NULL を返します。

SV* gv_const_sv(GV* gv)

gv_fetchmeth
「gv_fetchmeth_pvn」と似ていますが、flags パラメータがありません。

GV* gv_fetchmeth(HV* スタッシュ、const char* 名、
STRLEN レン、I32 レベル)

gv_fetchmethod_autoload
メソッドを呼び出すために呼び出すサブルーチンを含むグロブを返します。
「隠し場所」。 実際、自動ロードが存在する場合、これは次の glob である可能性があります。
「オートロード」。 この場合、対応する変数 $AUTOLOAD はすでに設定されています。

「gv_fetchmethod_autoload」の XNUMX 番目のパラメータは、AUTOLOAD かどうかを決定します。
指定されたメソッドが存在しない場合、ルックアップが実行されます。ゼロ以外は「はい」を意味します。
オートロード用。 ゼロはいいえ、AUTOLOAD を検索しないことを意味します。 「gv_fetchmethod」の呼び出しは
ゼロ以外の「autoload」を指定して「gv_fetchmethod_autoload」を呼び出すのと同等
パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

これらの関数は、メソッド名のプレフィックスとして「SUPER」トークンを付与します。 場合に注意してください。
返されたグロブを長期間保存したい場合は、それが保存されているかどうかを確認する必要があります。
「AUTOLOAD」。後で呼び出しによって別のサブルーチンがロードされる可能性があるため、
$AUTOLOAD にその値を変更します。 副作用として作成された glob を使用して実行します


これらの関数には、「level==0」を指定した「gv_fetchmeth」と同じ副作用があります。 の
「gv_fetchmeth」によって返された GV を「call_sv」に渡すことに対する警告が適用されます
これらの機能も同様です。

GV* gv_fetchmethod_autoload(HV* スタッシュ,
const char* 名前、
I32 オートロード)

gv_fetchmeth_autoload
これは「gv_fetchmeth_pvn_autoload」の古い形式であり、flags パラメータがありません。

GV* gv_fetchmeth_autoload(HV* スタッシュ,
const char* 名前、
STRLEN レン、I32 レベル)

gv_fetchmeth_pv
「gv_fetchmeth_pvn」とまったく同じですが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

GV* gv_fetchmeth_pv(HV* スタッシュ、const char* 名前、
I32 レベル、U32 フラグ)

gv_fetchmeth_pvn
指定された「名前」と定義されたサブルーチンまたは「NULL」を持つグロブを返します。 の
glob は、指定された「スタッシュ」、または @ISA 経由でアクセスできるスタッシュに存在し、
ユニバーサル::。

引数「level」は 0 または -1 のいずれかでなければなりません。 「level==0」の場合、副作用として
指定された「stash」に指定された「名前」のグロブを作成します。
success にはサブルーチンのエイリアスが含まれており、このサブルーチンのキャッシュ情報を設定します。
グロブ。

「フラグ」の重要な値は GV_SUPER と SVf_UTF8 のみです。

GV_SUPER は、メソッドをスーパークラスで検索することを示します。
「隠し場所」。

「gv_fetchmeth」から返された GV はメソッド キャッシュ エントリである可能性がありますが、これはメソッド キャッシュ エントリではありません。
Perlコードから見えるようになります。 したがって、「call_sv」を呼び出すときは、GV を使用しないでください。
直接; 代わりに、メソッドの CV を使用する必要があります。CV は、
「GvCV」マクロを使用した GV。

GV* gv_fetchmeth_pvn(HV* スタッシュ、const char* 名、
STRLEN レン、I32 レベル、
U32 フラグ)

gv_fetchmeth_pvn_autoload
と同じ gv_fetchmeth_pvn()、ただし、自動ロードされたサブルーチンも探します。 を返します
サブルーチンのグロブ。

GV のない自動ロードされたサブルーチンの場合、「レベル < 0」であっても GV を作成します。
スタブのない自動ロードされたサブルーチンの場合、 GvCV() 結果はゼロになる可能性があります。

現在、「flags」の唯一の重要な値は SVf_UTF8 です。

GV* gv_fetchmeth_pvn_autoload(HV* スタッシュ、
const char* 名前、
STRLEN レン、I32 レベル、
U32 フラグ)

gv_fetchmeth_pv_autoload
「gv_fetchmeth_pvn_autoload」とまったく同じですが、null で終わる文字列を受け取ります
文字列と長さのペアの代わりに。

GV* gv_fetchmeth_pv_autoload(HV* スタッシュ,
const char* 名前、
I32 レベル、U32 フラグ)

gv_fetchmeth_sv
「gv_fetchmeth_pvn」とまったく同じですが、SV の形式で名前文字列を受け取ります。
文字列と長さのペアの代わりに。

GV* gv_fetchmeth_sv(HV* スタッシュ、SV* 名前v、
I32 レベル、U32 フラグ)

gv_fetchmeth_sv_autoload
「gv_fetchmeth_pvn_autoload」とまったく同じですが、名前文字列を次の形式で受け取ります。
文字列と長さのペアの代わりに SV を使用します。

GV* gv_fetchmeth_sv_autoload(HV* スタッシュ、SV* 名前v、
I32 レベル、U32 フラグ)

gv_init の古い形式 gv_init_pvn()。 UTF8 文字列では機能しません。
フラグパラメータ。 「multi」パラメータが設定されている場合、GV_ADDMULTI フラグは次のようになります。
に渡された gv_init_pvn().

void gv_init(GV* gv, HV* stash, const char* 名前,
STRLEN len、int multi)

gv_init_pv
と同じ gv_init_pvn()ただし、名前には代わりに NULL で終わる文字列を使用します。
char * パラメータと length パラメータを分けます。

void gv_init_pv(GV* gv, HV* スタッシュ, const char* 名前,
U32 フラグ)

gv_init_pvn
スカラーをタイプグロブに変換します。 これは強制不可能な typeglob です。 を割り当てる
それへの参照は、次のように上書きするのではなく、そのスロットの XNUMX つに割り当てられます。
SvSetSV によって作成された typeglobs で発生します。 任意のスカラーを変換すると、 SvOK()
予測できない結果が生じる可能性があり、perl の内部使用のために予約されています。

「gv」は変換されるスカラーです。

「stash」は、親スタッシュ/パッケージ (存在する場合) です。

「name」と「len」は名前を与えます。 名前は修飾されていない必要があります。 つまり、そうする必要があります
パッケージ名は含めないでください。 「gv」が stash 要素の場合、それは呼び出し元の要素です。
この関数に渡される名前が次の名前と一致することを確認する責任があります。
要素。 一致しない場合、Perl の内部簿記は機能しなくなります。
同期。

「name」が UTF8 文字列の場合、または戻り値の場合、「flags」は SVf_UTF8 に設定できます。
SvUTF8(sv)。 GV_ADDMULTI フラグを使用することもできます。これは、次のようなふりをすることを意味します。
GV は以前に見られたことがある (つまり、「一度使用された」という警告を抑制します)。

void gv_init_pvn(GV* gv, HV* スタッシュ, const char* 名前,
STRLEN レン、U32 フラグ)

gv_init_sv
と同じ gv_init_pvn()ただし、名前には個別の文字 * の代わりに SV * が使用されます。
そして長さのパラメータ。 「flags」は現在使用されていません。

void gv_init_sv(GV* gv、HV* スタッシュ、SV* namesv、
U32 フラグ)

gv_stashpv
指定されたパッケージのスタッシュへのポインターを返します。 「strlen」を使用して、
「name」の長さを決定し、「gv_stashpvn()」を呼び出します。

HV* gv_stashpv(const char* 名前、I32 フラグ)

gv_stashvn
指定されたパッケージのスタッシュへのポインターを返します。 「namelen」パラメータ
「名前」の長さをバイト単位で示します。 「フラグ」が渡される
「gv_fetchpvn_flags()」なので、「GV_ADD」に設定すると、次の場合にパッケージが作成されます。
それはすでに存在しません。 パッケージが存在せず、「flags」が 0 (または任意の
パッケージを作成しないその他の設定）の場合は、NULL が返されます。

フラグは次のいずれかになります。

GV_ADD
SVf_UTF8
GV_NOADD_NOINIT
GV_NOINIT
GV_NOEXPAND
GV_ADDMG

その中で最も重要なのは、おそらく GV_ADD と SVf_UTF8 でしょう。

可能な場合は、「gv_stashvn」ではなく「gv_stashsv」を使用することを強くお勧めします。
パフォーマンス上の理由から推奨されます。

HV* gv_stashpvn(const char* 名前, U32 名前len,
I32 フラグ)

gv_stashvs
「gv_stashpvn」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

HV* gv_stashpvs(const char* 名前、I32 作成)

gv_stashsv
指定されたパッケージのスタッシュへのポインターを返します。 「gv_stashpvn」を参照してください。

パフォーマンスの観点から、このインターフェイスは「gv_stashpvn」よりも強く優先されることに注意してください。
理由。

HV* gv_stashsv(SV* sv、I32 フラグ)

デフォルト設定
出力用のデフォルトのファイル ハンドルである PL_defoutgv を、typeglob で渡されたものに設定します。
PL_defoutgv はその typeglob 上の参照を「所有」しているため、その typeglob の参照カウントは
typeglob で渡された関数は XNUMX つ増加し、typeglob の参照カウントが増加します。
PL_defoutgv が指す値が XNUMX 減ります。

void setdefout(GV* gv)

ハンディ 価値観

Nullav Null AV ポインタ。

(非推奨 - 代わりに「(AV *)NULL」を使用してください)

Nullch Null 文字ポインタ。 (「PERL_CORE」が定義されている場合は使用できなくなります。)

Nullcv Null CV ポインタ。

(非推奨 - 代わりに「(CV *)NULL」を使用してください)

Nullhv Null HV ポインタ。

(非推奨 - 代わりに「(HV *)NULL」を使用してください)

Nullsv Null SV ポインタ。 (「PERL_CORE」が定義されている場合は使用できなくなります。)

ハッシュ 操作 機能

HV 構造は Perl ハッシュを表します。 これは主にポインターの配列で構成されます。
このうち、HE 構造のリンクされたリストを指します。 配列はハッシュによってインデックス付けされます
キーの機能により、各リンク リストは同じ値を持つすべてのハッシュ エントリを表します。
ハッシュ値。 各 HE には、実際の値へのポインタに加えて、HEK へのポインタが含まれています。
キーとハッシュ値を保持する構造体。

cop_fetch_label
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

警官に付けられたラベルを返します。 フラグポインタは「SVf_UTF8」に設定される可能性があります
または0。

const char * cop_fetch_label(COP *const cop,
STRLEN *レン、U32 *フラグ)

警官ストアラベル
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

ラベルを「cop_hints_hash」に保存します。 フラグを「SVf_UTF8」に設定する必要があります。
utf-8ラベル。

void cop_store_label(COP *const cop,
const char *label、STRLEN len、
U32 フラグ)

get_hv 指定された Perl ハッシュの HV を返します。 「フラグ」は「gv_fetchpv」に渡されます。
「GV_ADD」が設定されており、Perl 変数が存在しない場合は作成されます。
「flags」がゼロで変数が存在しない場合は、NULL が返されます。

注: この関数の perl_ 形式は非推奨です。

HV* get_hv(const char *name, I32 フラグ)

HEf_SVKEY
このフラグは、ハッシュ エントリとマジック構造の長さスロットで使用され、
構造体には、「char*」ポインタが予期される場所に「SV*」ポインタが含まれています。
(情報提供のみを目的としており、使用しないでください)。

HeHASH ハッシュ エントリに保存されている計算されたハッシュを返します。

U32 HeHASH(ヘ・ヘ)

HeKEY ハッシュ エントリのキー スロットに格納されている実際のポインタを返します。 ポインタ
「HeKLEN()」の値に応じて、「char*」または「SV*」のいずれかになります。 できる
に割り当てられた。 通常は、「HePV()」または「HeSVKEY()」マクロが推奨されます。
キーの値を見つけること。

void* HeKEY(HE*ヘ)

HeKLEN これが負の値で、「HEf_SVKEY」に相当する場合、エントリが保持していることを示します。
「SV*」キー。 それ以外の場合は、キーの実際の長さを保持します。 に割り当てることができます。
通常、キーの長さを見つけるには「HePV()」マクロが適しています。

ストレン・ヘクレン(ヘ・ヘ)

HePV ハッシュ エントリのキー スロットを「char*」値として返し、必要な処理を実行します。
おそらく「SV*」キーの逆参照。 「len」には文字列の長さが入ります。
(これはマクロなので、 &len を使用します)。 長さを気にしないなら
重要なのは、グローバル変数「PL_na」を使用できることですが、これはかなり少ないです。
ローカル変数を使用するより効率的です。 ただし、perl ではハッシュキーを覚えておいてください。
埋め込み null を自由に含めることができるため、「strlen()」などの使用は適切ではありません。
ハッシュキーの長さを調べる方法。 これは「SvPV()」マクロに非常によく似ています。
このドキュメントの他の場所で説明されています。 「HeUTF8」も参照してください。

「HePV」を使用して値を取得し、「newSVpvn()」に渡して新しい SV を作成している場合、
より効率的であるため、「newSVhek(HeKEY_hek(he))」の使用を検討してください。

char* HePV(HE* he, STRLEN len)

HeSVKEY キーを「SV*」として返すか、ハッシュ エントリに「SV*」が含まれていない場合は「NULL」を返します。
キー。

SV* HeSVKEY(HE*ヘ)

HeSVKEY_force
キーを「SV*」として返します。 次の場合、一時的な定命の「SV*」を作成して返します。
ハッシュ エントリには「char*」キーのみが含まれます。

SV* HeSVKEY_force(HE* 彼)

HeSVKEY_set
適切なフラグを設定するように注意しながら、キーを指定された「SV*」に設定します。
「SV*」キーの存在を示し、同じ「SV*」を返します。

SV* HeSVKEY_set(HE* he, SV* sv)

HeUTF8 「HePV」によって返された「char *」値が UTF-8 でエンコードされているかどうかを返します。
おそらく「SV*」キーの必要な逆参照。 返される値は0になります
または 0 以外、必ずしも 1 (または下位ビットが設定された値) である必要はありません。 do
「bool」は「char」の typedef である可能性があるため、これを盲目的に「bool」変数に代入します。

U32 HeUTF8(ヘ・ヘ)

HeVAL ハッシュ エントリに格納されている値スロット (タイプ "SV*") を返します。 に割り当てることができます。

SV *foo= HeVAL(hv);
HeVAL(hv)= sv;

SV* HeVAL(ヘ*ヘ)

HvENAME スタッシュの実効名を返すか、存在しない場合は NULL を返します。 効果的なのは
name は、このスタッシュが存在するシンボル テーブル内の場所を表します。 それは
パッケージがエイリアス化されるか削除されると、自動的に更新されます。 ない隠し場所
シンボルテーブルには有効な名前がなくなりました。 この名前の方が望ましいです
MRO 線形化および isa キャッシュで使用する「HvNAME」。

char* HvENAME(HV* スタッシュ)

ハエナメレン
スタッシュの実効名の長さを返します。

STRLEN HvENAMELEN(HV *スタッシュ)

HvENAMEUTF8
実効名が UTF8 エンコーディングである場合は true を返します。

unsigned char HvENAMEUTF8(HV *stash)

HvNAME スタッシュのパッケージ名を返します。「stash」がスタッシュでない場合は NULL を返します。 見る
「SvSTASH」、「CvSTASH」。

char* HvNAME(HV* スタッシュ)

ナメレン
スタッシュの名前の長さを返します。

STRLEN HvNAMELEN(HV *隠し場所)

HvNAMEUTF8
名前が UTF8 エンコーディングである場合は true を返します。

unsigned char HvNAMEUTF8(HV *stash)

hv_assert
ハッシュが内部的に一貫した状態であることを確認します。

void hv_assert(HV *hv)

hv_clear
ハッシュのすべての要素を解放し、空のままにします。 XS相当のもの
「%ハッシュ = ()」。 「hv_undef」も参照してください。

戻り時にハッシュが無効になる可能性があることについては、「av_clear」を参照してください。

void hv_clear(HV *hv)

hv_clear_placeholders
ハッシュからプレースホルダーをクリアします。 制限付きハッシュにキーのいずれかが含まれている場合
読み取り専用としてマークされ、その後キーが削除された場合、キーは実際には削除されません
削除されましたが、&PL_sv_placeholder の値を割り当てることでマークされています。 これにタグを付けます
したがって、ハッシュの反復処理などの将来の操作では無視されますが、
将来的には、ハッシュの値をキーに再割り当てすることができます。
ポイント。 この関数は、そのようなプレースホルダー キーをハッシュからクリアします。 見る
ハッシュ::ユーティリティ::lock_keys() その使用例については。

void hv_clear_placeholders(HV *hv)

hv_copy_hints_hv
「%^H」をコピーするための「newHVhv」の特殊バージョン。 OHV へのポインタでなければなりません
ハッシュ (「%^H」の魔法がある場合もありますが、通常は魔法ではないはずです)、または「NULL」
(空のハッシュとして解釈されます)。 の内容 OHV 新しいハッシュにコピーされます。
「%^H」特有の魔法が追加されています。 新しいハッシュへのポインタが返されます。

HV * hv_copy_hints_hv(HV *ohv)

hv_delete
ハッシュ内のキーと値のペアを削除します。 値の SV がハッシュから削除され、
致命的になり、呼び出し元に戻りました。 「klen」の絶対値は
キーの長さ。 「klen」が負の場合、キーは次の場所にあるとみなされます。
UTF-8 でエンコードされた Unicode。 「フラグ」値は通常はゼロです。 に設定されている場合
G_DISCARD の場合は NULL が返されます。 キーが次の場合にも NULL が返されます。
見つかりません。

SV* hv_delete(HV *hv, const char *key, I32 klen,
I32 フラグ)

hv_delete_ent
ハッシュ内のキーと値のペアを削除します。 値 SV がハッシュから削除され、
死すべきものとなり、呼び出し元に返されました。 「フラグ」値は通常はゼロです。 もし
G_DISCARD に設定すると、NULL が返されます。 次の場合にも NULL が返されます。
キーが見つかりません。 「hash」には、事前に計算された有効なハッシュ値、または要求する 0 を指定できます。
それは計算されることになります。

SV* hv_delete_ent(HV *hv、SV *keysv、I32 フラグ、
U32 ハッシュ)

hv_exists
指定されたハッシュ キーが存在するかどうかを示すブール値を返します。 絶対的な
「klen」の値はキーの長さです。 「klen」が負の場合、キーは次のようになります。
UTF-8 でエンコードされた Unicode であると想定されます。

bool hv_exists(HV *hv, const char *key, I32 klen)

hv_exists_ent
指定されたハッシュ キーが存在するかどうかを示すブール値を返します。 「ハッシュ」は次のことができます
事前に計算された有効なハッシュ値、または計算を要求する場合は 0。

bool hv_exists_ent(HV *hv、SV *keysv、U32 ハッシュ)

hv_fetch
ハッシュ内の指定されたキーに対応する SV を返します。 絶対的な
「klen」の値はキーの長さです。 「klen」が負の場合、キーは次のようになります。
UTF-8 でエンコードされた Unicode であると想定されます。 「lval」が設定されている場合、フェッチは次のようになります。
店舗の一部。 これは、関連付けられたハッシュに値がない場合を意味します。
指定されたキーの場合、キーが作成され、それへのポインターが返されます。 「SV*」それ
にポイントを割り当てることができます。 ただし、戻り値が null でないことを常に確認してください
「SV*」に逆参照する前に。

詳細については、perlguts の「結合ハッシュと配列の魔法について」を参照してください。
タイド ハッシュでこの関数を使用する方法に関する情報。

SV** hv_fetch(HV *hv, const char *key, I32 klen,
I32 lval)

hv_fetchs
「hv_fetch」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

SV** hv_fetchs(HV* tb、const char* キー、I32 lval)

hv_fetch_ent
ハッシュ内の指定されたキーに対応するハッシュ エントリを返します。 "ハッシュ"
指定された「キー」に対して事前に計算された有効なハッシュ番号、または必要な場合は 0 でなければなりません。
それを計算する関数です。 「lval」が設定されている場合、フェッチはストアの一部になります。
アクセスする前に、戻り値が null でないことを確認してください。 ときの戻り値
「hv」は結合されたハッシュであり、静的な場所へのポインタであるため、必ずコピーを作成してください
構造をどこかに保存する必要がある場合は、構造を保存します。

詳細については、perlguts の「結合ハッシュと配列の魔法について」を参照してください。
タイド ハッシュでこの関数を使用する方法に関する情報。

HE* hv_fetch_ent(HV *hv, SV *keysv, I32 lval,
U32 ハッシュ)

hv_fill 使用中のハッシュ バケットの数を返します。 この機能は
マクロ「HvFILL」でラップされます。

以前は、この値は常に HV 構造に格納されていました。
何かのすべてのハッシュ (およびほぼすべてのオブジェクト) のオーバーヘッド
ほとんど使われません。 今回は、初めて必要になったときにオンデマンドで計算します。
計算を繰り返すのにコストがかかる場合は、それをキャッシュします。 キャッシュされた値は
挿入と削除によって更新されますが、ハッシュが次の場合は (現在) 破棄されます。
スプリット。

STRLEN hv_fill(HV *const hv)

hv_iterinit
ハッシュ テーブルを走査するための開始点を準備します。 内のキーの数を返します。
ハッシュ (つまり、「HvUSEDKEYS(hv)」と同じ)。 戻り値は現在のみです
タイマジックを使用しないハッシュに対して意味があります。

注: バージョン 5.004_65 より前では、「hv_iterinit」はハッシュの数を返すために使用されていました。
たまたま使用されていたバケツ。 難解な値がまだ必要な場合は、次のようにすることができます。
マクロ「HvFILL(hv)」を通じて取得します。

I32 hv_iterinit(HV *hv)

hv_iterkey
ハッシュ反復子の現在位置からキーを返します。 見る
「hv_iterinit」。

char* hv_iterkey(HE* エントリ、I32* retlen)

hv_iterkeysv
ハッシュ反復子の現在位置からキーを「SV*」として返します。 の
戻り値は常にキーの永久コピーになります。 「hv_iterinit」も参照してください。

SV* hv_iterkeysv(HE* エントリ)

hv_iternext
ハッシュ反復子からエントリを返します。 「hv_iterinit」を参照してください。

イテレータが作成するハッシュエントリに対して「hv_delete」または「hv_delete_ent」を呼び出すことができます。
場所を失ったりイテレータを無効にしたりすることなく、現在は を指しています。
この場合、現在のエントリがハッシュから削除されることに注意してください。
それへの最後の参照を保持するイテレータ。 イテレータには、
次の「hv_iternext」呼び出し時にエントリが追加されるため、イテレータを破棄しないでください。
そうしないとエントリがリークします - 「hv_iternext」を呼び出してリソースをトリガーします
割り当て解除。

HE* hv_iternext(HV *hv)

hv_iternextsv
「hv_iternext」、「hv_iterkey」、「hv_iterval」を XNUMX 回の操作で実行します。

SV* hv_iternextsv(HV *hv, char **key, I32 *retlen)

hv_iternext_flags
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

ハッシュ反復子からエントリを返します。 「hv_iterinit」および「hv_iternext」を参照してください。 の
「flags」値は通常はゼロです。 HV_ITERNEXT_WANTPLACEHOLDERS が設定されている場合、
通常のキーに加えて、プレースホルダー キー (制限付きハッシュ用) が返されます。
キー。 デフォルトでは、プレースホルダーは自動的にスキップされます。 現在、
プレースホルダーは、&PL_sv_placeholder という値で実装されます。 注意してください。
プレースホルダーと制限付きハッシュの実装は変更される可能性があります。
現在、実装は抽象化が不十分であり、変更を適切に行うことができません。

HE* hv_iternext_flags(HV *hv、I32 フラグ)

hv_interval
ハッシュ反復子の現在位置から値を返します。 見る
「hv_iterkey」。

SV* hv_iterval(HV *hv, HE *エントリ)

hv_magic
ハッシュに魔法を追加します。 「sv_magic」を参照してください。

void hv_magic(HV *hv, GV *gv, int how)

hv_スカラー
スカラーコンテキストでハッシュを評価し、結果を返します。 魔法を扱うとき
ハッシュは結びついています。

SV* hv_scalar(HV *hv)

hv_store
SV をハッシュに保存します。 ハッシュキーは「key」と絶対値で指定します。
「klen」の部分はキーの長さです。 「klen」が負の場合、キーは次のように仮定されます。
UTF-8 でエンコードされた Unicode である必要があります。 「hash」パラメータは、事前に計算されたハッシュ値です。
ゼロの場合は、Perl が計算します。

操作が失敗した場合、または値が必要ない場合、戻り値は NULL になります。
実際にはハッシュ内に格納されます (結合ハッシュの場合と同様)。 さもないと
これを逆参照して、元の「SV*」を取得できます。 発信者は次のとおりであることに注意してください。
前に「val」の参照カウントを適切にインクリメントする責任があります。
を呼び出し、関数が NULL を返した場合は値をデクリメントします。 事実上成功した
hv_store は、「val」への XNUMX つの参照の所有権を取得します。 これは通常、あなたが行うことです
欲しい; 新しく作成された SV の参照カウントは XNUMX なので、コードが実行するすべてのことが
SV を作成してハッシュに保存すると、hv_store がそのへの唯一の参照を所有します。
新しい SV なので、コードを整理するためにそれ以上何もする必要はありません。 hv_store は
hv_store_ent への呼び出しとして実装されておらず、一時的な SV は作成されません。
キーなので、キーデータがまだ SV 形式になっていない場合は、hv_store を使用します。
hv_store_ent を優先します。

詳細については、perlguts の「結合ハッシュと配列の魔法について」を参照してください。
タイド ハッシュでこの関数を使用する方法に関する情報。

SV** hv_store(HV *hv, const char *key, I32 klen,
SV *val、U32 ハッシュ)

hv_stores
「hv_store」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。
ハッシュパラメータは省略します。

SV** hv_stores(HV* tb, const char* キー,
NULLOK SV* 値)

hv_store_ent
「val」をハッシュに格納します。 「key」にはハッシュキーを指定します。 「ハッシュ」パラメータ
事前に計算されたハッシュ値です。 ゼロの場合は、Perl が計算します。 の
戻り値は、作成された新しいハッシュ エントリです。 操作の場合は NULL になります
失敗した場合、または実際に値をハッシュ内に保存する必要がなかった場合（次のように）
タイドハッシュの場合）。 それ以外の場合、戻り値の内容は次のようになります。
「He?」を使用してアクセスします。 ここで説明されているマクロ。 発信者は次のとおりであることに注意してください。
前に「val」の参照カウントを適切にインクリメントする責任があります。
を呼び出し、関数が NULL を返した場合は値をデクリメントします。 事実上成功した
hv_store_ent は、「val」への XNUMX つの参照の所有権を取得します。 これは通常、あなたが行うことです
欲しい; 新しく作成された SV の参照カウントは XNUMX なので、コードが実行するすべてのことが
SV を作成してハッシュに保存すると、hv_store がそのへの唯一の参照を所有します。
新しい SV なので、コードを整理するためにそれ以上何もする必要はありません。 ご了承ください
hv_store_ent は「キー」のみを読み取ります。 「val」とは異なり、所有権を取得しません。
したがって、「key」の正しい参照カウントを維持するのは完全に呼び出し元の責任です。
責任。 hv_store は hv_store_ent の呼び出しとして実装されていません。
キーの一時的な SV を作成しないため、キー データがまだ SV にない場合
フォームでは、hv_store_ent ではなく hv_store を使用します。

詳細については、perlguts の「結合ハッシュと配列の魔法について」を参照してください。
タイド ハッシュでこの関数を使用する方法に関する情報。

HE* hv_store_ent(HV *hv、SV *key、SV *val、U32 ハッシュ)

hv_undef
ハッシュの定義を解除します。 XS では「undef(%hash)」に相当します。

ハッシュのすべての要素を解放するだけでなく（ hv_clear())、これも無料です
ハッシュに関連付けられた補助データとストレージ。

戻り時にハッシュが無効になる可能性があることについては、「av_clear」を参照してください。

void hv_undef(HV *hv)

newHV 新しい HV を作成します。 参照カウントは 1 に設定されます。

HV* newHV()

フック 操作

これらの関数は、フック変数を操作するための便利でスレッドセーフな手段を提供します。

ラップオプチェッカー
指定された操作タイプのチェック関数のチェーンに C 関数を追加します。 これ
これは、「PL_check」配列を操作するための推奨される方法です。 オペコード どちらを指定するか
操作のタイプが影響を受けます。 新しいチェッカー C 関数へのポインタです。
そのオペコードのチェックチェーンに追加される、そして old_checker_p ストレージを指します
チェーン内の次の関数へのポインターが保存される場所。 の
の値 新しいポインタ 値は「PL_check」配列に書き込まれますが、
以前にそこに保存されていたものに書き込まれます *old_checker_p.

関数は次のように定義する必要があります。

静的 OP *new_checker(pTHX_ OP *op) { ... }

これは次の方法で呼び出すことを目的としています。

new_checker(aTHX_op)

old_checker_p 次のように定義する必要があります:

静的 Perl_check_t old_checker_p;

「PL_check」はプロセス全体と、op をフックするモジュールに対してグローバルです。
チェックはプロセスごとに複数回呼び出される場合があり、通常は
異なるスレッド。 この状況に対処するために、この関数は冪等です。 の
場所 *old_checker_p 最初に (プロセスごとに XNUMX 回) NULL ポインターを含める必要があります。
静的期間の AC 変数 (ファイル スコープで宣言され、通常はマークも付けられます)
内部リンケージを与えるための「static」）は暗黙的に初期化されます
明示的な初期化子がない場合は、適切に設定されます。 この機能は、
チェック チェーンが見つかった場合にのみ、実際にチェック チェーンを変更します。 *old_checker_p ヌルになる。 これ
この関数は小規模ではスレッドセーフでもあります。 適切なロックを使用して、
「PL_check」にアクセスする際の競合状態を回避します。

この関数が呼び出されると、によって参照される関数が 新しいチェッカー 準備ができていなければなりません
呼び出されるのは例外です *old_checker_p 満たされていないこと。 スレッド状況では、
新しいチェッカー この関数が返される前であっても、すぐに呼び出すことができます。
*old_checker_p 前に常に適切に設定されます 新しいチェッカー と呼ばれます。 場合
新しいチェッカー 与えられた op に対して特別なことは何もしないことを決定します (これは
これは、op チェック フックのほとんどの使用の通常のケースです)、チェックをチェーンする必要があります
によって参照される関数 *old_checker_p.

特定のサブルーチンへの呼び出しのコンパイルに影響を与えたい場合は、次を使用します。
すべての「entersub」操作のフックチェックではなく「cv_set_call_checker」。

void Wrap_op_checker(Optype オペコード,
Perl_check_t new_checker、
Perl_check_t *old_checker_p)

レクサー インタフェース

これは Perl パーサーの下位層であり、文字とトークンを管理します。

lex_bufutf8
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

レクサーバッファー内のオクテット (「PL_parser->linestr」) を次のようにするかどうかを示します。
Unicode 文字の UTF-8 エンコーディングとして解釈されます。 そうでない場合は、そうすべきです
Latin-1 文字として解釈されます。 これは、次の「SvUTF8」フラグに似ています。
スカラー。

UTF-8 モードでは、レクサー バッファーに実際に有効なデータが含まれるかどうかは保証されません。
UTF-8。 字句解析コードは、無効なエンコードに直面しても堅牢である必要があります。

「PL_parser->linestr」スカラーの実際の「SvUTF8」フラグは重要ですが、
入力文字エンコーディングに関するすべての話ではありません。 通常、ファイルが
が読み取られており、スカラーにはオクテットが含まれており、その「SvUTF8」フラグはオフですが、
「use utf8」プラグマが有効な場合、オクテットは UTF-8 として解釈される必要があります。
ただし、文字列の評価中に、スカラーに「SvUTF8」フラグがオンになる場合があります。
この場合、「use bytes」プラグマを使用しない限り、そのオクテットは UTF-8 として解釈される必要があります。
が有効になっています。 このロジックは将来変更される可能性があります。 代わりにこの関数を使用してください
ロジックを自分で実装します。

ブール lex_bufutf8()

lex_discard_to
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「PL_parser->linestr」バッファの最初の部分を破棄します。 PTRを選択します。
バッファーの残りのコンテンツは移動され、すべてのポインターはバッファーに移動されます。
適切に更新されました。 PTR バッファ内で次の位置より後であってはなりません
「PL_parser->bufptr」: まだ字句解析されていないテキストを破棄することは許可されていません。

通常、これを直接行う必要はありません。
「lex_next_chunk」とそれに基づくものの暗黙的な破棄動作。
ただし、トークンが複数行にまたがっており、字句解析コードが
その目的のためにバッファーに複数行のテキストを入れ、完了後に
不要になった以前の行を明示的に破棄することが賢明なトークン、
将来の複数行トークンによってバッファーが際限なく増大するのを避けるため。

void lex_discard_to(char *ptr)

lex_grow_linestr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

少なくとも対応できるようにレクサー バッファ (「PL_parser->linestr」) を再割り当てします。 LEN
オクテット (終端「NUL」を含む)。 再割り当てされたオブジェクトへのポインタを返します。
バッファ。 これはバッファを直接変更する前に必要です。
それは長さを伸ばすことになります。 「lex_stuff_pvn」は、より便利な方法を提供します。
テキストをバッファに挿入します。

「PL_parser->linestr」で「SvGROW」または「sv_grow」を直接使用しないでください。 この機能
バッファを直接指すレクサーの変数をすべて更新します。

char * lex_grow_linestr(STRLEN len)

lex_next_chunk
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

字句解析する次のテキストのチャンクを読み取り、それを「PL_parser->linestr」に追加します。
これは、字句解析コードが現在のチャンクの最後まで検索したときに呼び出される必要があります。
そしてもっと知りたいと思っています。 字句解析では通常、次のようにする必要がありますが、必須ではありません。
現時点では現在のチャンク全体が消費されています。

「PL_parser->bufptr」が現在のチャンクの最後を指している場合 (つまり、
現在のチャンクは完全に消費されています)、通常、現在のチャンクは
新しいチャンクが読み込まれると同時に破棄されます。 フラグ 含ま
「LEX_KEEP_PREVIOUS」の場合、現在のチャンクは破棄されません。 現在の場合
チャンクが完全に消費されていない場合、チャンクは無視されません。
旗。

新しいテキストがバッファに追加された場合は true を返し、バッファにテキストが追加された場合は false を返します。
入力テキストの終わりに達しました。

bool lex_next_chunk(U32 フラグ)

lex_peek_unichar
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

現在字句解析されているテキスト内の XNUMX 文字 (Unicode) を先読みします。 戻り値
次の文字のコードポイント (符号なし整数値)、または字句解析に問題がある場合は -1
入力テキストの終わりに達しました。 ピークしたキャラクターを消費するには、次を使用します。
「lex_read_unichar」。

次の文字が入力テキストの次のチャンク内にある (またはその中に広がっている) 場合、
次のチャンクが読み込まれます。通常、現在のチャンクは次の時点で破棄されます。
同時に、しかしもし フラグ 「LEX_KEEP_PREVIOUS」が含まれている場合、現在のチャンクは
捨てられないこと。

入力が UTF-8 として解釈され、UTF-8 エンコード エラーが発生した場合
遭遇すると例外が生成されます。

I32 lex_peek_unichar(U32 フラグ)

lex_read_space
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

現在字句解析されているテキスト内のオプションのスペースを Perl スタイルで読み取ります。 の
スペースには、通常の空白文字と Perl スタイルのコメントが含まれる場合があります。
「#line」ディレクティブが見つかった場合は処理されます。 「PL_parser->bufptr」が移動されました
スペースを越えて、スペース以外の文字 (または文字列の末尾) を指すようにします。
入力テキスト）。

スペースが入力テキストの次のチャンクにまで及ぶ場合、次のチャンクが読み取られます。
通常、現在のチャンクは同時に破棄されますが、 フラグ
「LEX_KEEP_PREVIOUS」が含まれている場合、現在のチャンクは破棄されません。

void lex_read_space(U32 フラグ)

lex_read_to
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「PL_parser->bufptr」から次までのレクサーバッファ内のテキストを消費します。 PTR。 この
一致するように「PL_parser->bufptr」を進めます PTR、正しい簿記を実行する
改行文字が渡されるたびに。 これは lexed を使用する通常の方法です
テキスト。

バッファのオクテットの解釈は、わずかな
高レベル関数「lex_peek_unichar」および「lex_read_unichar」。

void lex_read_to(char *ptr)

lex_read_unichar
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

現在字句解析されているテキスト内の次の (Unicode) 文字を読み取ります。 を返します
文字のコードポイント（符号なし整数値）を読み取って移動します。
文字を超えると「PL_parser->bufptr」、または字句解析が到達した場合は -1 を返します。
入力テキストの終わり。 次の文字を非破壊的に調べるには、次を使用します。
代わりに「lex_peek_unichar」を使用します。

次の文字が入力テキストの次のチャンク内にある (またはその中に広がっている) 場合、
次のチャンクが読み込まれます。通常、現在のチャンクは次の時点で破棄されます。
同時に、しかしもし フラグ 「LEX_KEEP_PREVIOUS」が含まれている場合、現在のチャンクは
捨てられないこと。

入力が UTF-8 として解釈され、UTF-8 エンコード エラーが発生した場合
遭遇すると例外が生成されます。

I32 lex_read_unichar(U32 フラグ)

lex_start
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

新しいレクサー/パーサー状態オブジェクトを作成して初期化し、コンテキストを提供します。
これを Perl コードの新しいソースから lex および解析します。 新しい状態へのポインタ
オブジェクトは「PL_parser」に配置されます。 保存スタックにエントリが作成されるため、
新しい状態オブジェクトを巻き戻すと、オブジェクトは破棄され、以前の値は破棄されます。
「PL_parser」が復元されます。 解析をクリーンアップするために他に何もする必要はありません
コンテキスト。

解析されるコードは次のものから来ます ライン と rsfp. ライン、null でない場合は、
解析するコードを含む文字列 (SV 形式)。 文字列のコピーが作成され、
その後の変更 ライン 解析には影響しません。 rsfp、null でない場合、
解析するためにコードが読み取られる入力ストリームを提供します。 両方ある場合
null 以外のコード ライン 最初に来て、次の完全な行で構成されている必要があります。
入力、そして rsfp ソースの残りの部分を供給します。

この フラグ パラメータは将来の使用のために予約されています。 現在は perl のみで使用されています
内部的にはそのため、拡張機能では常にゼロを渡す必要があります。

void lex_start(SV *line、PerlIO *rsfp、U32 フラグ)

lex_stuff_pv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

レクサーバッファー (「PL_parser->linestr」) の直後に文字を挿入します。
現在のレクシング ポイント (「PL_parser->bufptr」)、次の場合にバッファを再割り当てします。
必要。 これは、後で実行される字句解析コードでは文字が次のように認識されることを意味します。
それらが入力に現れた場合。 これを一部として行うことはお勧めできません
通常の解析では、この機能のほとんどの使用には、挿入された
文字が意図しない方法で解釈される。

挿入される文字列は、次から始まるオクテットで表されます。 pv 続けます
最初のヌルまで。 これらのオクテットは UTF-8 または Latin-1 として解釈されます。
「LEX_STUFF_UTF8」フラグが設定されているかどうかに応じて フラグ。 キャラクター
バッファの現在の状態に応じて、レクサーバッファ用に再コード化されます。
解釈されます (「lex_bufutf8」)。 文字列を NULL で終了するのが不便な場合は、
挿入する場合は、「lex_stuff_pvn」関数の方が適切です。

void lex_stuff_pv(const char *pv、U32 フラグ)

lex_stuff_pvn
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

レクサーバッファー (「PL_parser->linestr」) の直後に文字を挿入します。
現在のレクシング ポイント (「PL_parser->bufptr」)、次の場合にバッファを再割り当てします。
必要。 これは、後で実行される字句解析コードでは文字が次のように認識されることを意味します。
それらが入力に現れた場合。 これを一部として行うことはお勧めできません
通常の解析では、この機能のほとんどの使用には、挿入された
文字が意図しない方法で解釈される。

挿入する文字列は次のように表されます。 LEN で始まるオクテット pv。 これら
オクテットは、
「LEX_STUFF_UTF8」フラグが設定されています フラグ。 文字はレクサー用に再コード化されます
バッファ、バッファが現在どのように解釈されているかに応じて
(「lex_bufutf8」)。 挿入する文字列が Perl スカラーとして利用可能な場合、
「lex_stuff_sv」関数の方が便利です。

void lex_stuff_pvn(const char *pv, STRLEN len,
U32 フラグ)

lex_stuff_pvs
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「lex_stuff_pvn」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

void lex_stuff_pvs(const char *pv、U32 フラグ)

lex_stuff_sv
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

レクサーバッファー (「PL_parser->linestr」) の直後に文字を挿入します。
現在のレクシング ポイント (「PL_parser->bufptr」)、次の場合にバッファを再割り当てします。
必要。 これは、後で実行される字句解析コードでは文字が次のように認識されることを意味します。
それらが入力に現れた場合。 これを一部として行うことはお勧めできません
通常の解析では、この機能のほとんどの使用には、挿入された
文字が意図しない方法で解釈される。

挿入される文字列は、次の文字列値です。 sv。 文字が再コード化される
レクサーバッファの場合、バッファが現在どのように解釈されているかに応じて
(「lex_bufutf8」)。 挿入される文字列がまだ Perl スカラーでない場合、
「lex_stuff_pvn」関数を使用すると、スカラーを構築する必要がなくなります。

void lex_stuff_sv(SV *sv、U32 フラグ)

lex_unstuff
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「PL_parser->bufptr」から次のレベルまで、字句解析されようとしているテキストを破棄します。 PTR。 テキスト
フォロー中 PTR が移動され、バッファが短縮されます。 これにより、破棄されたものが非表示になります
テキストがまったく出現しなかったかのように、後で実行される字句解析コードのテキスト。

これは、字句解析されたテキストを使用する通常の方法ではありません。 そのためには、「lex_read_to」を使用します。

void lex_unstuff(char *ptr)

parse_arithexpr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

Perl 算術式を解析します。 これには優先順位が低い演算子が含まれる可能性があります
ビットシフト演算子に。 式は続行する必要があります (したがって終了する必要があります)。
比較演算子や優先順位の低い演算子、あるいは
通常はセミコロンなどの式を終了します。 もし フラグ 含ま
「PARSE_OPTIONAL」の場合、式はオプションです。それ以外の場合は必須です。 それ
動的パーサーの状態 (「PL_parser」など) が確実に
解析されるコードのソースと語彙を反映するように正しく設定されています。
式のコンテキスト。

式を表す op ツリーが返されます。 オプションの式が
存在しない場合は null ポインタが返され、そうでない場合はポインタは非 null になります。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリーは無効になります。
とにかく戻った。 エラーはパーサーの状態に反映され、通常は次のような結果が得られます。
すべてのコンパイルをカバーする解析の最上位レベルでの XNUMX つの例外で
発生したエラー。 ただし、一部のコンパイル エラーでは例外がスローされます。
すぐに。

OP * parse_arithexpr(U32 フラグ)

parse_barestmt
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

単一の飾られていない Perl ステートメントを解析します。 これは通常の命令かもしれません
コンパイル時に影響を与えるステートメントまたは宣言。 何も含まれていません
ラベルやその他の付属品。 動的であることを確認するかどうかは呼び出し側の責任です。
パーサー状態 (「PL_parser」など) は、ソースを反映するように正しく設定されています。
解析するコードとステートメントの語彙コンテキスト。

ステートメントを表す op ツリーが返されます。 次の場合、これはヌルポインタである可能性があります。
ステートメントは null です。たとえば、ステートメントが実際にサブルーチン定義だった場合などです。
(コンパイル時の副作用があります)。 null でない場合は、直接 ops になります
「newSTATEOP」に渡すのに適したステートメントを実装します。 ならない
通常、「nextstate」または同等の操作が含まれます（ただし、
スコープはステートメント内に完全に含まれます)。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリー (ほとんどの場合、
null の可能性が高い) がとにかく返されます。 エラーはパーサーの状態に反映されます。
通常、解析の最上位レベルで XNUMX つの例外が発生します。
発生したすべてのコンパイル エラー。 ただし、一部のコンパイル エラーは、
すぐに例外をスローします。

この フラグ パラメータは将来の使用のために予約されており、常にゼロにする必要があります。

OP * parse_barestmt(U32 フラグ)

解析ブロック
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

単一の完全な Perl コード ブロックを解析します。 これは左中括弧、
ステートメントのシーケンスと右中括弧。 ブロックは語彙を構成します
スコープ内にあるため、「my」変数とさまざまなコンパイル時の効果をスコープ内に含めることができます。
それ。 動的パーサーの状態 (「PL_parser」) を確認するのは呼び出し元の責任です。
et al) は、解析されるコードのソースを反映するように正しく設定されており、
ステートメントの語彙コンテキスト。

コード ブロックを表す op ツリーが返されます。 これは常に本当の作戦です、
決してヌルポインタではありません。 通常は、「nextstate」を含む「lineseq」リストになります。
または同等の操作。 あらゆる種類のランタイム スコープを構築するための操作は含まれていません。
ブロックであるという利点があります。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリー (ほとんどの場合、
null の可能性が高い) がとにかく返されます。 エラーはパーサーの状態に反映されます。
通常、解析の最上位レベルで XNUMX つの例外が発生します。
発生したすべてのコンパイル エラー。 ただし、一部のコンパイル エラーは、
すぐに例外をスローします。

この フラグ パラメータは将来の使用のために予約されており、常にゼロにする必要があります。

OP * parse_block(U32 フラグ)

parse_fullexpr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

単一の完全な Perl 式を解析します。 これにより、完全な表現文法が可能になります。
「or」などの最も優先順位の低い演算子も含まれます。 式は次のようにする必要があります
式が通常次のように続くトークンが後に続きます (したがって終了します)。
ファイルの終わり、右括弧句読点、セミコロン、または次のいずれかで終了します。
後置式ステートメント修飾子を通知するキーワード。 もし フラグ
「PARSE_OPTIONAL」が含まれている場合、式はオプションです。それ以外の場合は、式はオプションです。
必須。 動的パーサーの状態を確認するのは呼び出し元の責任です。
(「PL_parser」など) は、コードのソースを反映するように正しく設定されています。
解析された式の語彙コンテキスト。

式を表す op ツリーが返されます。 オプションの式が
存在しない場合は null ポインタが返され、そうでない場合はポインタは非 null になります。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリーは無効になります。
とにかく戻った。 エラーはパーサーの状態に反映され、通常は次のような結果が得られます。
すべてのコンパイルをカバーする解析の最上位レベルでの XNUMX つの例外で
発生したエラー。 ただし、一部のコンパイル エラーでは例外がスローされます。
すぐに。

OP * parse_fullexpr(U32 フラグ)

parse_fullstmt
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

単一の完全な Perl ステートメントを解析します。 これは通常の命令文かもしれません
またはコンパイル時に効果があり、オプションのラベルを含めることができる宣言。
動的パーサーの状態 (「PL_parser」など) を確認するのは呼び出し側の責任です。
解析されるコードのソースと語彙を反映するように正しく設定されています。
ステートメントのコンテキスト。

ステートメントを表す op ツリーが返されます。 次の場合、これはヌルポインタである可能性があります。
ステートメントは null です。たとえば、ステートメントが実際にサブルーチン定義だった場合などです。
(コンパイル時の副作用があります)。 null でない場合は、
「newSTATEOP」呼び出し。通常は「nextstate」または同等の操作が含まれます。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリー (ほとんどの場合、
null の可能性が高い) がとにかく返されます。 エラーはパーサーの状態に反映されます。
通常、解析の最上位レベルで XNUMX つの例外が発生します。
発生したすべてのコンパイル エラー。 ただし、一部のコンパイル エラーは、
すぐに例外をスローします。

この フラグ パラメータは将来の使用のために予約されており、常にゼロにする必要があります。

OP * parse_fullstmt(U32 フラグ)

解析ラベル
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

Perl のプレフィックスとなるタイプの単一ラベル (場合によってはオプション) を解析します。
声明。 動的パーサーの状態を確認するのは呼び出し元の責任です。
(「PL_parser」など) は、コードのソースを反映するように正しく設定されています。
解析された。 もし フラグ 「PARSE_OPTIONAL」が含まれている場合、ラベルはオプションです。それ以外の場合は、
それが必須です。

ラベルの名前は新しいスカラーの形式で返されます。 オプションの場合
ラベルが存在しない場合は、null ポインタが返されます。

解析中にエラーが発生した場合 (ラベルが必須の場合にのみ発生する可能性があります)、
とにかく有効なラベルが返されます。 エラーはパーサーの状態に反映されます。
通常、解析の最上位レベルで XNUMX つの例外が発生します。
発生したすべてのコンパイル エラー。

SV * parse_label(U32 フラグ)

parse_listexpr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

Perl リスト式を解析します。 これには、以下の優先順位の演算子が含まれる場合があります。
カンマ演算子。 式は次のいずれかの後に続く (したがって終了する) 必要があります。
「or」などの優先順位の低い論理演算子、または
通常はセミコロンなどの式を終了します。 もし フラグ 含ま
「PARSE_OPTIONAL」の場合、式はオプションです。それ以外の場合は必須です。 それ
動的パーサーの状態 (「PL_parser」など) が確実に
解析されるコードのソースと語彙を反映するように正しく設定されています。
式のコンテキスト。

式を表す op ツリーが返されます。 オプションの式が
存在しない場合は null ポインタが返され、そうでない場合はポインタは非 null になります。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリーは無効になります。
とにかく戻った。 エラーはパーサーの状態に反映され、通常は次のような結果が得られます。
すべてのコンパイルをカバーする解析の最上位レベルでの XNUMX つの例外で
発生したエラー。 ただし、一部のコンパイル エラーでは例外がスローされます。
すぐに。

OP * parse_listexpr(U32 フラグ)

parse_stmtseq
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

XNUMX 個以上の Perl ステートメントのシーケンスを解析します。 これらは通常の命令かもしれません
オプションのラベルを含むステートメント、またはコンパイル時のある宣言
効果、またはそれらの混合物。 ステートメント シーケンスは、右中かっこで終了します。
または、新しいステートメントが有効に存在する可能性がある場所でファイルの終わりが検出されました。
始めました。 動的パーサーの状態を確認するのは呼び出し元の責任です。
(「PL_parser」など) は、コードのソースを反映するように正しく設定されています。
解析されたステートメントの語彙コンテキスト。

ステートメントシーケンスを表す op ツリーが返されます。 これは null の可能性があります
ステートメントがすべて null だった場合のポインター (ステートメントが存在しなかった場合など)
または、サブルーチン定義 (コンパイル時側を持つ) のみがあった場合
効果）。 null でない場合、通常は次のものが含まれる "lineseq" リストになります。
「nextstate」または同等の操作。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリーは無効になります。
とにかく戻った。 エラーはパーサーの状態に反映され、通常は次のような結果が得られます。
すべてのコンパイルをカバーする解析の最上位レベルでの XNUMX つの例外で
発生したエラー。 ただし、一部のコンパイル エラーでは例外がスローされます。
すぐに。

この フラグ パラメータは将来の使用のために予約されており、常にゼロにする必要があります。

OP * parse_stmtseq(U32 フラグ)

parse_termexpr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

Perl 用語式を解析します。 これには、以下の優先順位の演算子が含まれる場合があります。
代入演算子。 式は続行する必要があります (したがって終了する必要があります)。
カンマまたは優先順位の低い演算子、または通常は
セミコロンなどの式を終了します。 もし フラグ 「PARSE_OPTIONAL」を含む
その場合、式はオプションです。それ以外の場合、式は必須です。 それは、
動的パーサーの状態 (「PL_parser」など) が正しくであることを確認する呼び出し元
解析されるコードのソースとその語彙コンテキストを反映するように設定されます。
式です。

式を表す op ツリーが返されます。 オプションの式が
存在しない場合は null ポインタが返され、そうでない場合はポインタは非 null になります。

解析またはコンパイル中にエラーが発生した場合、ほとんどの場合、有効な op ツリーは無効になります。
とにかく戻った。 エラーはパーサーの状態に反映され、通常は次のような結果が得られます。
すべてのコンパイルをカバーする解析の最上位レベルでの XNUMX つの例外で
発生したエラー。 ただし、一部のコンパイル エラーでは例外がスローされます。
すぐに。

OP * parse_termexpr(U32 フラグ)

PL_パーサー
現在の解析操作の状態をカプセル化する構造体へのポインタ
進行中。 ポインタをローカルに変更して、ネストされた解析を実行できます。
外部解析の状態に干渉します。 「PL_parser」の個々のメンバー
独自のドキュメントを持っています。

PL_parser->bufend
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

現在字句解析されているテキストのチャンクの終わり、つまりテキストの終わりへの直接ポインター
レクサーバッファー。 これは、「SvPVX(PL_parser->linestr) +」と等しくなります。
SvCUR(PL_parser->linestr)"。「NUL」文字 (ゼロ オクテット) は常に次の位置にあります。
バッファの終わりであり、バッファの内容の一部としてカウントされません。

PL_parser->bufptr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

レクサーバッファー内のレクサーの現在位置を指します。 キャラクター
このあたりは、 で区切られた範囲内で自由に検討できます。
「SvPVX("PL_parser->linestr")」および「PL_parser->bufend」。 バッファのオクテット
で示されるように、UTF-8 または Latin-1 として解釈されるように意図されている可能性があります。
「lex_bufutf8」。

字句解析コード (Perl コア内かどうかに関係なく) は、このポインターを次の値を超えて移動します。
消費する文字数。 簿記業務も行う予定です
改行文字が消費されるたびに。 この移動がより便利になります
これは、改行を適切に処理する関数「lex_read_to」によって実行されます。

バッファのオクテットの解釈は、わずかな
高レベル関数「lex_peek_unichar」および「lex_read_unichar」。

PL_parser->linestart
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

レクサーバッファー内の現在の行の先頭を指します。 これは便利です
どの列でエラーが発生したかを示すためのもので、それ以外はあまり役に立ちません。 これはきっと
改行を使用する字句解析コードによって更新されます。 関数「lex_read_to」
この詳細を処理します。

PL_parser->linestr
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

現在テキストを検討しているチャンクを含むバッファ スカラー
現在レク中です。 これは常にプレーンな文字列スカラーです (「SvPOK」は
真実）。 通常のスカラー手段でスカラーとして使用することは意図されていません。 その代わり
以下に説明するポインタ変数によってバッファを直接参照します。

レクサーは、「PL_parser->linestr」内のものへのさまざまな「char*」ポインターを維持します。
バッファ。 「PL_parser->linestr」が再割り当てされる場合、これらのポインタはすべて再割り当てされる必要があります。
更新します。 これを手動で実行しようとせず、「lex_grow_linestr」を使用してください。
バッファを再割り当てする必要がある場合。

バッファ内のテキスト チャンクの内容は通常、完全な XNUMX 行です。
改行ターミネータまでの入力を含めることができますが、状況によっては
それはそうではありません。 バッファのオクテットは次のように解釈されることを意図している可能性があります。
UTF-8 または Latin-1 のいずれか。 関数「lex_bufutf8」がどちらであるかを示します。 使ってはいけません
このスカラーの「SvUTF8」フラグは、それと一致しない可能性があります。

バッファを直接調べる場合、変数「PL_parser->bufend」は以下を指します。
バッファの終わり。 現在のレクシング位置は次のように指定されます。
「PL_parser->bufptr」。 通常は、これらのポインタを直接使用することをお勧めします。
通常のスカラー手段によるスカラーの検査。

ロケール関連 機能 と マクロ

DECLARATION_FOR_LC_NUMERIC_MANIPULATION
このマクロはステートメントとして使用する必要があります。 プライベート変数を宣言します（その
名前はアンダースコアで始まります)。これは、この中の他のマクロで必要です。
セクション。 これを正しく含めないと、構文エラーが発生します。 のために
C89 C コンパイラとの互換性のため、コンパイラの前のブロックに配置する必要があります。
実行可能なステートメント。

無効な DECLARATION_FOR_LC_NUMERIC_MANIPULATION

RESTORE_LC_NUMERIC
これは、マクロの XNUMX つと組み合わせて使用​​されます。
「STORE_LC_NUMERIC_SET_TO_NEEDED」および「STORE_LC_NUMERIC_FORCE_TO_UNDERLYING」

「LC_NUMERIC」状態を適切に復元します。

宣言するには、「DECLARATION_FOR_LC_NUMERIC_MANIPULATION」の呼び出しが行われている必要があります。
コンパイル時に、このマクロと XNUMX つの「STORE」変数によって使用されるプライベート変数。
このマクロは、式ではなく単一のステートメントとして呼び出す必要があります。
次のような空の引数リスト:

{
DECLARATION_FOR_LC_NUMERIC_MANIPULATION;
...
RESTORE_LC_NUMERIC();
...
}

void RESTORE_LC_NUMERIC()

STORE_LC_NUMERIC_FORCE_TO_UNDERLYING
これは、ロケールを強制するために「LC_NUMERIC」ロケールを認識する XS コードによって使用されます。
カテゴリ "LC_NUMERIC" を、perl が現在の基礎となるロケールと考えるものにします。
(Perl インタプリタは、基礎となるロケールが実際に何であるかについて間違っている可能性があります)
一部の C または XS コードが C ライブラリ関数を呼び出した場合 ロケールの設定(3) その背後にある
戻る; このマクロを呼び出す前に「sync_locale」を呼び出すと、Perl のレコードが更新されます。)

宣言するには、「DECLARATION_FOR_LC_NUMERIC_MANIPULATION」の呼び出しが行われている必要があります。
コンパイル時にこのマクロによって使用されるプライベート変数。 このマクロは次のようにする必要があります
式ではなく、空の引数リストを使用して単一のステートメントとして呼び出されます。
このような：

{
DECLARATION_FOR_LC_NUMERIC_MANIPULATION;
...
STORE_LC_NUMERIC_FORCE_TO_UNDERLYING();
...
RESTORE_LC_NUMERIC();
...
}

プライベート変数は現在のロケール状態を保存するために使用されます。
必要に応じて一致する「RESTORE_LC_NUMERIC」を呼び出すと復元できます。

void STORE_LC_NUMERIC_FORCE_TO_UNDERLYING()

STORE_LC_NUMERIC_SET_TO_NEEDED
これは、「LC_NUMERIC」ロケールを認識する XS または C コードをラップするのに役立ちます。
このロケール カテゴリは通常、Perl によって逆方向に C ロケールに設定されたままになります。
互換性があり、浮動小数点値を読み取るほとんどの XS コードが対応できるためです。
XNUMX 進数の基数文字がドットである場合のみ。

このマクロは、現在の "LC_NUMERIC" 状態が適切に設定されていることを確認します。
Perl プログラムから XS または C コードへの呼び出しがロケール内から行われる場合は、ロケールの
「使用ロケール」の範囲。 または、呼び出しが外部からの場合はロケールを無視します。
そのような範囲。

このマクロは、C または XS コードのラップの開始点です。 ラップエンディングは次のように行われます。
操作後に「RESTORE_LC_NUMERIC」マクロを呼び出します。 そうでなければ州
他の XS コードに悪影響を与える変更が行われる可能性があります。

宣言するには、「DECLARATION_FOR_LC_NUMERIC_MANIPULATION」の呼び出しが行われている必要があります。
コンパイル時にこのマクロによって使用されるプライベート変数。 このマクロは次のようにする必要があります
式ではなく、空の引数リストを使用して単一のステートメントとして呼び出されます。
このような：

{
DECLARATION_FOR_LC_NUMERIC_MANIPULATION;
...
STORE_LC_NUMERIC_SET_TO_NEEDED();
...
RESTORE_LC_NUMERIC();
...
}

void STORE_LC_NUMERIC_SET_TO_NEEDED()

同期ロケール
プログラムのロケールの変更は、XS コードによって回避する必要があります。 それでも、確かな
XS から呼び出される「Gtk」などの非 Perl ライブラリはそうします。 これが起こると、Perl
ロケールが変更されたことを通知する必要があります。 そうする前に、この関数を使用してください。
パールに戻ります。

void sync_locale()

魔法の 機能

mg_clear
SV が表す魔法のようなものをクリアします。 「sv_magic」を参照してください。

int mg_clear(SV* sv)

mg_copy ある SV から別の SV にマジックをコピーします。 「sv_magic」を参照してください。

int mg_copy(SV *sv, SV *nsv, const char *key,
I32クレン)

mg_find SV に一致する型のマジック ポインタを検索します。 「sv_magic」を参照してください。

MAGIC* mg_find(const SV* sv, int 型)

mg_findext
「SV」に指定された「vtbl」を持つ「type」のマジック ポインタを検索します。 見る
「sv_magicext」。

MAGIC* mg_findext(const SV* sv, int 型,
const MGVTBL *vtbl)

mg_free SV が使用するマジック ストレージを解放します。 「sv_magic」を参照してください。

int mg_free(SV* sv)

mg_free_type
タイプの魔法をすべて削除します の SVから sv。 「sv_magic」を参照してください。

void mg_free_type(SV *sv, int how)

mg_get SV から値を取得する前にマジックを実行します。 SV のタイプは >= でなければなりません
SVt_PVMG。 「sv_magic」を参照してください。

int mg_get(SV* sv)

mg_length
廃止されました! この関数は Perl の将来のリリースから削除される予定です。
新しいコードには使用しないでください。 既存のコードから削除してください。

SV の長さをバイト単位でレポートし、可能な場合は長さマジックを呼び出しますが、
SV に UTF8 フラグを設定しないでください。 存在しない場合は、「get」マジックに戻ります。
「length」マジックですが、「get」マジックを呼び出したかどうかは不明です。 それ
SV が PVMG 以上であることを前提としています。 使用 sv_len() を代わりにお使いください。

U32 mg_length(SV* sv)

mg_magical
SV の魔法のステータスをオンにします。 「sv_magic」を参照してください。

void mg_magical(SV* sv)

mg_set 値が SV に割り当てられた後にマジックを実行します。 「sv_magic」を参照してください。

int mg_set(SV* sv)

SVGETMAGIC
「get」マジックがある場合、SV 上で「mg_get」を呼び出します。 たとえば、これは次のように呼び出します
タイド変数の「FETCH」。 このマクロは引数を複数回評価します。

void SvGETMAGIC(SV* sv)

SvLOCK 適切なモジュールが
ロードされました。

void SvLOCK(SV* sv)

SvSETMAGIC
SV に「set」マジックがある場合、SV 上で「mg_set」を呼び出します。 これはその後に必要です
$| のような魔法の変数の場合は、スカラーを変更します。 または結合変数
(「ストア」と呼びます)。 このマクロは引数を複数回評価します。

void SvSETMAGIC(SV* sv)

SvSetMagicSV
「SvSetSV」と似ていますが、後で必要な設定マジックを実行します。

void SvSetMagicSV(SV* dsv, SV* ssv)

SvSetMagicSV_nosteal
「SvSetSV_nosteal」と似ていますが、後で必要なセット魔法を実行します。

void SvSetMagicSV_nosteal(SV* dsv, SV* ssv)

SvSetSV dsv が ssv と同じでない場合、「sv_setsv」を呼び出します。 以下の引数を評価する可能性があります
一度。 宛先 SV では「set」マジックを処理しません。

void SvSetSV(SV* dsv, SV* ssv)

SvSetSV_nosteal
dsv が ssv と同じでない場合は、非破壊バージョンの「sv_setsv」を呼び出します。 XNUMX月
引数を複数回評価します。

void SvSetSV_nosteal(SV* dsv, SV* ssv)

SvSHARE 適切なモジュールがロードされている場合、スレッド間で sv が共有されるように手配します。

void SvSHARE(SV* sv)

SvUNLOCK
適切なモジュールがロードされている場合、SV の相互排他ロックを解除します。

void SvUNLOCK(SV* sv)

メモリ マネジメント

XSUB ライターのインターフェイスを C の "memcpy" 関数にコピーします。 「src」はソースです。
「dest」は宛先、「nitems」は項目の数、「type」は項目です。
タイプ。 重複したコピーでは失敗する可能性があります。 「移動」も参照してください。

void Copy(void* src, void* dest, int niitems, type)

CopyD 「Copy」と似ていますが、dest を返します。 コンパイラーに末尾呼び出しを促すのに役立ちます
最適化。

void * CopyD(void* src, void* dest, int niitems, type)

XSUB ライターのインターフェイスを C の "memmove" 関数に移動します。 「src」はソースです。
「dest」は宛先、「nitems」は項目の数、「type」は項目です。
タイプ。 オーバーラップ動作が可能。 「コピー」も参照してください。

void Move(void* src, void* dest, int niitems, type)

MoveD 「Move」と似ていますが、dest を返します。 コンパイラーに末尾呼び出しを促すのに役立ちます
最適化。

void * MoveD(void* src, void* dest, int niitems, type)

Newx XSUB ライターの C の「malloc」関数へのインターフェイス。

これによって得られるメモリは、 たったの 「Safefree」で解放されます。

5.9.3年には、 新しい() そして友達が年上の人に取って代わる 新規（） API を削除し、最初の API を削除します
パラメータ、 x、呼び出し元が自分自身を識別できるようにするデバッグ補助。 この援助は
新しいビルド オプション PERL_MEM_LOG に置き換えられました (「PERL_MEM_LOG」を参照)
perlhacktips)。 古い API は、XS モジュールで使用するためにまだ存在しています。
古いパール。

void Newx(void* ptr, int niitems, type)

Newxc キャストを使用した、C の "malloc" 関数への XSUB ライターのインターフェイス。 こちらも参照
「ニュークス」。

これによって得られるメモリは、 たったの 「Safefree」で解放されます。

void Newxc(void* ptr, int niitems, type, Cast)

Newxz C の "malloc" 関数への XSUB ライターのインターフェイス。 割り当てられたメモリは、
「memzero」でゼロ化されます。 「ニュークス」も参照。

これによって得られるメモリは、 たったの 「Safefree」で解放されます。

void Newxz(void* ptr, int niitems, type)

毒 ポイズンウィズ(0xEF) 解放されたメモリへのアクセスをキャッチします。

void Poison(void* dest, int niitems, type)

ポイズンフリー
ポイズンウィズ(0xEF) 解放されたメモリへのアクセスをキャッチします。

void PoisonFree(void* dest, int niitems, type)

毒新しい
ポイズンウィズ(0xAB) 割り当てられているが初期化されていないメモリへのアクセスをキャッチします。

void PoisonNew(void* dest, int niitems, type)

ポイズンウィズ
メモリをバイト パターン (何度も繰り返されるバイト) で埋めます。
うまくいけば、初期化されていないメモリへのアクセスの試みをキャッチできます。

void PoisonWith(void* dest, int niitems, type,
U8バイト）

XSUB ライターの C の "realloc" 関数へのインターフェイスを更新します。

これによって得られるメモリは、 たったの 「Safefree」で解放されます。

void Renew(void* ptr, int niitems, type)

Renewc キャストを使用した、C の "realloc" 関数への XSUB ライターのインターフェイス。

これによって得られるメモリは、 たったの 「Safefree」で解放されます。

void Renewc(void* ptr, int niitems, type, Cast)

セーフフリー
XSUB ライターの C の「フリー」関数へのインターフェイス。

これはすべき たったの 「ニュークス」と仲間たちを使って得た思い出を使用できます。

void Safefree(void* ptr)

savepv 「strdup()」の Perl バージョン。 新しく割り当てられた文字列へのポインタを返します。
「pv」の複製です。 文字列のサイズは「strlen()」によって決まります。
埋め込み「NUL」文字を含めることはできず、末尾に「NUL」が必要であることを意味します。
新しい文字列に割り当てられたメモリは、「Safefree()」で解放できます。
機能。

Windows などの一部のプラットフォームでは、スレッドが所有するすべての割り当てメモリが
そのスレッドが終了すると割り当てが解除されます。 したがって、それが起こらないようにする必要がある場合は、次のようにする必要があります
「savesharedpv」などの共有メモリ関数を使用します。

char* savepv(const char* pv)

savepvn 「strndup()」が存在する場合の Perl のバージョン。 へのポインタを返します。
「pv」の最初の「len」バイトの複製である、新しく割り当てられた文字列、
末尾に「NUL」バイトが追加されます。 新しい文字列に割り当てられたメモリを解放できます。
「Safefree()」関数を使用します。

Windows などの一部のプラットフォームでは、スレッドが所有するすべての割り当てメモリが
そのスレッドが終了すると割り当てが解除されます。 したがって、それが起こらないようにする必要がある場合は、次のようにする必要があります
「savesharedpvn」などの共有メモリ関数を使用します。

char* savepvn(const char* pv, I32 len)

savepvs 「savepvn」と似ていますが、文字列の代わりにリテラルの「NUL」で終わる文字列を受け取ります。
文字列/長さのペア。

char* savepvs(const char* s)

保存共有pv
重複した文字列をメモリに割り当てる「savepv()」のバージョン。
スレッド間で共有されます。

char* savesharedpv(const char* pv)

保存共有pvn
重複した文字列をメモリに割り当てる「savepvn()」のバージョン。
スレッド間で共有されます。 (具体的な違いは、NULL ポインターはそうではないということです。
許容できる）

char* savesharedpvn(const char *const pv,
const STRLEN len)

保存共有 pvs
重複した文字列をメモリに割り当てる「savepvs()」のバージョン。
スレッド間で共有されます。

char* savesharedpvs(const char* s)

savesharedsvpv
重複した文字列をメモリに割り当てる「savesharedpv()」のバージョン。
スレッド間で共有されます。

char* savesharedsvpv(SV *sv)

vpv を保存
「savepv()」/「savepvn()」のバージョン。複製する文字列を
「SvPV()」を使用してSVで渡されます

Windows などの一部のプラットフォームでは、スレッドが所有するすべての割り当てメモリが
そのスレッドが終了すると割り当てが解除されます。 したがって、それが起こらないようにする必要がある場合は、次のようにする必要があります
「savesharedsvpv」などの共有メモリ関数を使用します。

char* savesvpv(SV* sv)

構造コピー
これは、ある構造を別の構造にコピーする、アーキテクチャに依存しないマクロです。

void StructCopy(type *src, type *dest, type)

Zero XSUB ライターの C の「memzero」関数へのインターフェイス。 「目的地」とは、
「nitems」はアイテムの数、「type」はタイプです。

void Zero(void* dest, int niitems, type)

ZeroD 「Zero」と似ていますが、dest を返します。 コンパイラーに末尾呼び出しを促すのに役立ちます
最適化。

void * ZeroD(void* dest, int niitems, type)

その他 機能

dump_c_backtrace
C バックトレースを指定された fp にダンプします。

バックトレースを取得できた場合は true、取得できなかった場合は false を返します。

bool dump_c_backtrace(PerlIO* fp, int max_ Depth,
intスキップ)

fbm_compile
文字列を分析して、高速検索を実行します。 fbm_instr() -- は
ボイヤー・ムーアアルゴリズム。

void fbm_compile(SV* sv、U32 フラグ)

fbm_instr
「big」と「bigend」で区切られた文字列内の SV の位置を返します。 それ
文字列が見つからない場合は「NULL」を返します。 「sv」は必須ではありません
fbm_compiled ですが、検索はそれほど高速ではありません。

char* fbm_instr(unsigned char* big,
unsigned char* bigend、SV* littlestr、
U32 フラグ)

foldEQ 文字列 s1 と s2 の先頭の len バイトが同じ場合に true を返します。
無神経に。 それ以外の場合は false。 大文字と小文字の ASCII 範囲バイトが一致する
自分自身とその反対のケースの対応者。 大文字と小文字を区別しない非 ASCII 範囲
バイトはそれ自体のみに一致します。

I32foldEQ(const char* a, const char* b, I32 len)

フォールドEQ_ロケール
文字列 s1 と s2 の先頭の len バイトが同じ場合に true を返します。
現在のロケールで無神経に。 それ以外の場合は false。

I32foldEQ_locale(const char* a, const char* b,
I32レン)

form sprintf スタイルのフォーマット パターンと従来の (非 SV) 引数を受け取ります。
フォーマットされた文字列を返します。

(char *) Perl_form(pTHX_ const char* pat, ...)

文字列 (char *) が必要な場所ならどこでも使用できます。

char * s = Perl_form("%d.%d",メジャー,マイナー);

単一のプライベート バッファを使用するため、複数の文字列をフォーマットする場合は、
以前の文字列を明示的にコピーして削除します (完了したらコピーを解放します)。

char* 形式(const char* pat, ...)

getcwd_sv
SV に現在の作業ディレクトリを入力します

int getcwd_sv(SV* sv)

get_c_backtrace_dump
| Depth| のダンプとして SV を返します。 呼び出しスタックのフレームをスキップし、|skip|
一番奥のもの。 通常は深さ 20 で十分です。

追加された出力は次のようになります。

... 1 10e004812:0082 Perl_croak util.c:1716 / usr / bin / perl 2
10df8d6d2:1d72 perl_parse perl.c:3975 / usr / bin / perl ...

フィールドはタブで区切られています。 最初の列は深さです (ゼロは深さです)
最も内側のスキップされていないフレーム）。 hex:offset の XNUMX 進数は、プログラムが配置される場所です。
カウンターは S_parse_body にあり、:offset (欠落している可能性があります) がその量を示します。
S_parse_body 内にプログラム カウンターがありました。

util.c:1716 はソース コード ファイルと行番号です。

この / usr / bin / perl それは明らかです（できれば）。

不明なものは「-」です。 残念ながら、未知の事態は非常に簡単に発生する可能性があります。
情報の取得はサポートされていません。 バイナリにデバッグがない場合
情報; オプティマイザがインライン化などによってコードを変換した場合。

SV* get_c_backtrace_dump(int max_ Depth, int Skip)

ibcmp これは (! フォールドEQ())

I32 ibcmp(const char* a, const char* b, I32 len)

ibcmp_locale
これは (! foldEQ_locale())

I32 ibcmp_locale(const char* a, const char* b,
I32レン)

is_safe_syscall
指定された「pv」に内部の「NUL」文字が含まれていないことをテストします。 それであれば
実行すると、「errno」を ENOENT に設定し、オプションで警告し、FALSE を返します。

名前が安全な場合は TRUE を返します。

によって使用されます IS_SAFE_SYSCALL() マクロ。

bool is_safe_syscall(const char *pv, STRLEN len,
const char *何、
const char *op_name)

memEQ XNUMX つのバッファ (「NUL」文字が埋め込まれている可能性がある) をテストして、それらが
等しい。 「len」パラメータは、比較するバイト数を示します。 戻り値
等しい場合はゼロ、等しくない場合は非ゼロ。

bool memEQ(char* s1, char* s2, STRLEN len)

memNE XNUMX つのバッファ (「NUL」文字が埋め込まれている可能性がある) をテストして、それらが
等しくありません。 「len」パラメータは、比較するバイト数を示します。 戻り値
等しくない場合はゼロ、等しい場合は非ゼロ。

bool memNE(char* s1, char* s2, STRLEN len)

sprintf スタイルのフォーマット パターンと引数リストを取得します。 これらは生成するために使用されます
文字列メッセージ。 メッセージが改行で終わっていない場合は、次のようになります。
説明されているように、コード内の現在の位置を示すものを追加して拡張されています。
「mess_sv」の場合。

通常、結果のメッセージは新しい最終的な SV で返されます。 グローバル期間中
単一の SV を破棄すると、この関数の使用間で共有される場合があります。

SV * 混乱(const char *pat, ...)

mess_sv ユーザー向けのメッセージを展開して、現在のメッセージを含めます。
メッセージがまだ完了していないように見える場合は、コード内の場所を確認してください。

「basemsg」は最初のメッセージまたはオブジェクトです。 参考になれば使わせていただきます
現状のままであり、この関数の結果になります。 それ以外の場合は文字列として使用されます。
すでに改行で終わっている場合は、完全なものとみなされ、結果は
この関数の は同じ文字列になります。 メッセージが次の文字で終わっていない場合は、
改行の場合、「at foo.pl line 37」のようなセグメントが追加され、場合によっては
他の句は現在の実行状態を示します。 結果のメッセージ
ドットと改行で終わります。

通常、結果のメッセージは新しい最終的な SV で返されます。 グローバル期間中
単一の SV を破棄すると、この関数の使用間で共有される場合があります。 「消費する」場合
true の場合、関数は変更して返すことが許可されます (必須ではありません)。
新しい SV を割り当てる代わりに「basemsg」を使用します。

SV * mess_sv(SV *basemsg、ブール消費)

my_snprintf
C ライブラリの「snprintf」機能（利用可能で標準に準拠している場合）（使用
実際には「vsnprintf」です）。 ただし、「vsnprintf」が利用できない場合は、
残念ながら、安全ではない「vsprintf」を使用すると、バッファがオーバーランする可能性があります（
オーバーラン チェックを実行しますが、手遅れになる可能性があります)。 代わりに「sv_vcatpvf」の使用を検討してください。または
「vsnprintf」を取得します。

int my_snprintf(char *buffer, const Size_t len,
const char *形式, ...)

my_sprintf
C ライブラリ「sprintf」は、必要に応じてラップされ、確実に
バッファに書き込まれる文字列の長さ。 まれな ANSI 以前のシステムのみが必要となります。
ラッパー関数 - 通常、これは「sprintf」への直接呼び出しです。

int my_sprintf(char *buffer, const char *pat, ...)

my_strlcat
C ライブラリ「strlcat」（利用可能な場合）、またはその Perl 実装。 これ
C の「NUL」で終わる文字列を操作します。

「my_strlcat()」は、文字列「src」を「dst」の末尾に追加します。 多くても追加されます
「サイズ - strlen(dst) - 1」文字。 「size」でない限り、「NUL」で終了します。
0であるか、元の「dst」文字列が「size」より長かった（実際にはこれは
これは、「サイズ」が間違っているか、「dst」が正しくないことを意味するため、起こりません。
適切な「NUL」で終わる文字列）。

「サイズ」は宛先バッファのフルサイズであり、結果は次のようになります。
余裕がある場合は、「NUL」で終了することが保証されます。 「NUL」の余地があることに注意してください
「サイズ」に含める必要があります。

Size_t my_strlcat(char *dst, const char *src,
サイズ_tサイズ)

my_strlcpy
C ライブラリ「strlcpy」（利用可能な場合）、またはその Perl 実装。 これ
C の「NUL」で終わる文字列を操作します。

「my_strlcpy()」は、文字列「src」から最大「size - 1」文字を「dst」にコピーします。
「NUL」 - 「サイズ」が 0 でない場合、結果を終了します。

Size_t my_strlcpy(char *dst, const char *src,
サイズ_tサイズ)

my_vsnprintf
C ライブラリ「vsnprintf」（利用可能で標準に準拠している場合）。 ただし、もし仮に
「vsnprintf」は利用できません。残念ながら安全ではない「vsprintf」が使用されます。
バッファをオーバーランする可能性があります（オーバーランチェックはありますが、それはやりすぎる可能性があります）
遅い）。 代わりに「sv_vcatpvf」を使用するか、「vsnprintf」を取得することを検討してください。

int my_vsnprintf(char *buffer, const Size_t len,
const char *format、va_list ap)

PERL_SYS_INIT
実行に必要な C ランタイム環境のシステム固有の調整を提供します。
Perl インタプリタ。 これは、Perl を作成する前に XNUMX 回だけ呼び出す必要があります。
通訳。

void PERL_SYS_INIT(int *argc, char*** argv)

PERL_SYS_INIT3
実行に必要な C ランタイム環境のシステム固有の調整を提供します。
Perl インタプリタ。 これは、Perl を作成する前に XNUMX 回だけ呼び出す必要があります。
通訳。

void PERL_SYS_INIT3(int *argc, char*** argv,
char*** 環境)

PERL_SYS_TERM
Perl の実行後に C ランタイム環境のシステム固有のクリーンアップを提供します。
通訳者。 これは、残りの Perl を解放した後に XNUMX 回だけ呼び出す必要があります。
通訳。

void PERL_SYS_TERM()

quadmath_format_needed
quadmath_format_needed() フォーマット文字列に次のものが含まれる場合は true を返します。
Q 接頭辞のない %[efgaEFGA] 形式指定子を少なくとも XNUMX つ指定するか、それ以外の場合は false を返します。

フォーマット指定子の検出は完全な printf 構文検出ではありませんが、
最も一般的なケースをキャッチできるはずです。

true が返された場合、それらの引数は すべき 理論的には次のように処理されます
quadmath_snprintf()ただし、そのような書式指定子が複数ある場合に備えて (「
"quadmath_format_single")、それを超えるものがあれば (さらに
ほんの XNUMX バイト）、 処理されるため quadmath_snprintf() 非常にある
厳密で、XNUMX つの形式仕様のみを受け入れ、他は何も受け入れません。 この場合、コードは
おそらく失敗するはずです。

boolquadmath_format_needed(const char* 形式)

quadmath_format_single
quadmath_snprintf() フォーマット文字列が非常に厳密であるため、失敗します。
形式が無効な場合は -1 を返します。 XNUMX つの形式仕様のみを受け入れます。

quadmath_format_single() 意図した単一の仕様が正常であるかどうかをチェックします。
"%" があり、"%" が XNUMX つだけあり、"[efgaEFGA]" で終わり、その前に "Q" があります。 これ
これは完全な「printf 構文チェック」ではなく、単なる基本です。

形式が有効な場合はその形式を返し、そうでない場合は NULL を返します。

quadmath_format_single() 不足している「Q」をパッチすることができ、実際にパッチを適用します。
必要。 この場合、フォーマットの変更されたコピーが返されます。 which 　
発信者 意志 必要 〜へ 無料。

「quadmath_format_needed」も参照してください。

const char*quadmath_format_single(const char* フォーマット)

READ_XDIGIT
ASCII 範囲の XNUMX 進数の値を返し、文字列ポインタを進めます。
動作は、isXDIGIT(*str) が true の場合にのみ明確に定義されます。

U8 READ_XDIGIT(char str*)

strEQ XNUMX つの文字列が等しいかどうかをテストします。 true または false を返します。

bool strEQ(char* s1, char* s2)

strGE 1 つの文字列をテストして、最初の文字列「sXNUMX」が次の文字列以上であるかどうかを確認します。
2番目は「sXNUMX」です。 true または false を返します。

bool strGE(char* s1, char* s2)

strGT 1 つの文字列をテストして、最初の文字列「s2」が XNUMX 番目の文字列「sXNUMX」より大きいかどうかを確認します。
true または false を返します。

bool strGT(char* s1, char* s2)

strLE 1 つの文字列をテストして、最初の文字列 "sXNUMX" が XNUMX 番目の文字列以下であるかどうかを確認します。
「s2」。 true または false を返します。

bool strLE(char* s1, char* s2)

strLT 1 つの文字列をテストして、最初の文字列「s2」が XNUMX 番目の文字列「sXNUMX」より小さいかどうかを確認します。
true または false を返します。

bool strLT(char* s1, char* s2)

strNE XNUMX つの文字列をテストして、それらが異なるかどうかを確認します。 true または false を返します。

bool strNE(char* s1, char* s2)

strnEQ XNUMX つの文字列が等しいかどうかをテストします。 「len」パラメータは、
比較するバイト数。 true または false を返します。 (「strncmp」のラッパー)。

bool strnEQ(char* s1, char* s2, STRLEN len)

strnNE XNUMX つの文字列をテストして、それらが異なるかどうかを確認します。 「len」パラメータは、
比較するバイト数。 true または false を返します。 (「strncmp」のラッパー)。

bool strnNE(char* s1, char* s2, STRLEN len)

sv_destroyable
共有がない場合にオブジェクトが破棄される可能性があることを報告するダミー ルーチン
モジュールが存在します。 単一の SV 引数を無視し、「true」を返します。 まで存在する
NULL 関数ポインターのテストは避けてください。また、以下の場合に警告が発生する可能性があるためです。
ある程度の厳しさ。

bool sv_destroyable(SV *sv)

sv_nosharing
共有モジュールが存在しない場合に SV を「共有」するダミー ルーチン。 または
それを「ロック」します。 または「ロックを解除」します。 つまり、単一の SV 引数を無視します。
NULL 関数ポインターのテストを回避するために存在します。また、潜在的にテストが行​​われる可能性があるため、
ある程度の厳密さの下で警告します。

void sv_nosharing(SV *sv)

vmess の「pat」と「args」は sprintf スタイルのフォーマット パターンであり、カプセル化された引数です
リスト。 これらは文字列メッセージを生成するために使用されます。 メッセージが終わらない場合
改行を使用すると、現在の内容を示すもので拡張されます。
「mess_sv」で説明されているように、コード内の場所。

通常、結果のメッセージは新しい最終的な SV で返されます。 グローバル期間中
単一の SV を破棄すると、この関数の使用間で共有される場合があります。

SV * vmess(const char *pat, va_​​list *args)

MRO 機能

これらの関数は、Perl クラスのメソッド解決順序に関連しています。

mro_get_linear_isa
指定されたスタッシュの mro 線形化を返します。 デフォルトでは、これは次のようになります
他の MRO が有効でない限り、「mro_get_linear_isa_dfs」が返すもの
隠し場所。 戻り値は読み取り専用の AV* です。

保存する場合は、戻り値の「SvREFCNT_inc()」を担当する必要があります。
半永久的にどこにでも保存できます（そうしないと、ユーザーの下から削除される可能性があります）
次回キャッシュが無効になるとき)。

AV* mro_get_linear_isa(HV* スタッシュ)

mro_method_changed_in
指定されたスタッシュの子クラスのメソッド キャッシュを無効にします。
この変化に気づくかもしれません。

理想的には、Perl ソース内の「PL_sub_generation++」のすべてのインスタンスが、 ミスターシー
は this の呼び出しに置き換える必要があります。

Perl は、メソッドを再定義する一般的な方法のほとんどを自動的に処理します。
ただし、スタッシュ内のメソッドを変更する方法がいくつかあります。
キャッシュ コードが認識されるため、この場合は後でこのメソッドを呼び出す必要があります。

1) XS コードからスタッシュ HV エントリを直接操作します。

2) 読み取り専用スカラー定数への参照を stash エントリに順番に代入します。
定数サブルーチンを作成します (constant.pm と同様)。

これと同じメソッドを純粋な Perl から利用できます。
「mro::method_changed_in(クラス名)」。

void mro_method_changed_in(HV* スタッシュ)

mro_register
カスタム mro プラグインを登録します。 詳細については、perlmroapi を参照してください。

void mro_register(const struct mro_alg *mro)

マルチコール 機能

dマルチコール
マルチコールのローカル変数を宣言します。 perlcall の「軽量コールバック」を参照してください。

dMULTICALL;

マルチコール
軽量のコールバックを作成します。 perlcall の「軽量コールバック」を参照してください。

マルチコール;

POP_MULTICALL
軽量コールバックの閉じ括弧。 「軽量コールバック」を参照してください。
パールコール。

POP_MULTICALL;

PUSH_MULTICALL
軽量コールバック用の開始ブラケット。 「軽量コールバック」を参照してください。
パールコール。

PUSH_MULTICALL;

数値の 機能

grok_bin
XNUMX 進数を表す文字列を数値形式に変換します。

入場時 start と * len スキャンする文字列を指定します。 *フラグ 変換フラグを与える、
と 結果 NULL または NV へのポインタである必要があります。 スキャンは終了時に停止します
文字列、または最初の無効な文字。 「PERL_SCAN_SILENT_ILLDIGIT」が設定されていない場合
in *フラグ、無効な文字に遭遇した場合も警告がトリガーされます。 の上
return * len スキャンされた文字列の長さに設定され、 *フラグ 出力を与える
フラグ。

値が <= "UV_MAX" の場合、UV として返され、出力フラグはクリアされます。
そして何も書き込まれていない *結果。 値が > UV_MAX の場合、「grok_bin」が返されます。
UV_MAX、出力フラグに「PERL_SCAN_GREATER_THAN_UV_MAX」を設定し、
価値 *結果 (または、次の場合には値が破棄されます) 結果 無効である）。

0 進数には、オプションで「XNUMXb」または「b」を接頭辞として付けることができます。
「PERL_SCAN_DISALLOW_PREFIX」が設定されています *フラグ 入場時。 もし
「PERL_SCAN_ALLOW_UNDERSCORES」が設定されています *フラグ その場合、XNUMX進数には「_」を使用できます。
数字を区切る文字。

UV grok_bin(const char* start, STRLEN* len_p,
I32* フラグ、NV *結果)

grok_hex
XNUMX 進数を表す文字列を数値形式に変換します。

入場時 start と *len_p スキャンする文字列を指定します。 *フラグ 変換フラグを与える、
と 結果 NULL または NV へのポインタである必要があります。 スキャンは終了時に停止します
文字列、または最初の無効な文字。 「PERL_SCAN_SILENT_ILLDIGIT」が設定されていない場合
in *フラグ、無効な文字に遭遇した場合も警告がトリガーされます。 の上
return * len スキャンされた文字列の長さに設定され、 *フラグ 出力を与える
フラグ。

値が UV_MAX 以下の場合、UV として返され、出力フラグはクリアされ、
何も書き込まれていない *結果。 値が > UV_MAX の場合、「grok_hex」が返されます。
UV_MAX、出力フラグに「PERL_SCAN_GREATER_THAN_UV_MAX」を設定し、
価値 *結果 (または、次の場合には値が破棄されます) 結果 無効である）。

0 進数には、オプションで「XNUMXx」または「x」を接頭辞として付けることができます。
「PERL_SCAN_DISALLOW_PREFIX」が設定されています *フラグ 入場時。 もし
「PERL_SCAN_ALLOW_UNDERSCORES」が設定されています *フラグ その場合、XNUMX 進数には「_」を使用できます
数字を区切る文字。

UV grok_hex(const char* start, STRLEN* len_p,
I32* フラグ、NV *結果)

grok_infnan
ヘルパー grok_number()、「infinity」または「not a」のさまざまな綴りを受け入れます。
数値」を返し、次のフラグの組み合わせのいずれかを返します。

IS_NUMBER_INFINITE
IS_NUMBER_NAN
IS_NUMBER_INFINITE | IS_NUMBER_NEG
IS_NUMBER_NAN | IS_NUMBER_NEG
0

IS_NUMBER_TRAILING で |-ed される可能性があります。

無限大または非数値が認識された場合、*sp は XNUMX バイトを指します。
認識された文字列の末尾を超えています。 認識に失敗した場合はゼロになります。
が返され、*sp は移動しません。

int grok_infnan(const char** sp, const char *send)

grok_number
と同じ grok_number_flags() フラグはゼロに設定されます。

int grok_number(const char *pv, STRLEN len,
UV*値p)

grok_number_flags
数字を認識します (または認識しません)。 数値の型が返されます (0 の場合は
認識されない)、それ以外の場合は、IS_NUMBER_IN_UV のビット OR の組み合わせです。
IS_NUMBER_GREATER_THAN_UV_MAX、IS_NUMBER_NOT_INT、IS_NUMBER_NEG、
IS_NUMBER_INFINITY、IS_NUMBER_NAN (perl.h で定義)。

数値の値が UV に収まる場合は、*valuep で返されます。
IS_NUMBER_IN_UV は、*valuep が有効であることを示すように設定されます。IS_NUMBER_IN_UV
*valuep が有効でない限り設定されることはありませんが、*valuep が割り当てられている可能性があります。
戻り時に IS_NUMBER_IN_UV が設定されていない場合でも、処理中に発生します。 valuep が
valuep が NULL 以外の場合と同じ場合に NULL、IS_NUMBER_IN_UV が設定されます。
ただし、実際の割り当て (または SEGV) は発生しません。

末尾の小数が表示された場合、IS_NUMBER_NOT_INT は IS_NUMBER_IN_UV で設定されます
(この場合、*valuep は整数に切り捨てられた真の値を返します)、および
数値が負の場合は IS_NUMBER_NEG (この場合、*valuep は絶対値を保持します)
価値）。 e 表記が使用されているか、数値が大きい場合、IS_NUMBER_IN_UV は設定されません。
紫外線よりも。

「flags」では「PERL_SCAN_TRAILING」のみが許可されます。これにより、末尾の非数値が許可されます。
それ以外は成功した場合のテキスト グローク、結果に「IS_NUMBER_TRAILING」を設定します。

int grok_number_flags(const char *pv, STRLEN len,
UV *valuep、U32 フラグ)

grok_numeric_radix
数値の小数点区切り文字 (基数) をスキャンしてスキップします。

bool grok_numeric_radix(const char **sp,
const char *送信)

grok_oct
XNUMX 進数を表す文字列を数値形式に変換します。

入場時 start と * len スキャンする文字列を指定します。 *フラグ 変換フラグを与える、
と 結果 NULL または NV へのポインタである必要があります。 スキャンは終了時に停止します
文字列、または最初の無効な文字。 「PERL_SCAN_SILENT_ILLDIGIT」が設定されていない場合
in *フラグ、8 または 9 に遭遇した場合も警告がトリガーされます。 帰国時 * len is
スキャンされた文字列の長さに設定され、 *フラグ 出力フラグを与えます。

値が UV_MAX 以下の場合、UV として返され、出力フラグはクリアされ、
何も書き込まれていない *結果。 値が > UV_MAX の場合、「grok_oct」が返されます。
UV_MAX、出力フラグに「PERL_SCAN_GREATER_THAN_UV_MAX」を設定し、
価値 *結果 (または、次の場合には値が破棄されます) 結果 無効である）。

「PERL_SCAN_ALLOW_UNDERSCORES」が設定されている場合 *フラグ その場合、XNUMX 進数は使用できます
数字を区切るための「_」文字。

UV grok_oct(const char* start, STRLEN* len_p,
I32* フラグ、NV *結果)

イズインフナン
Perl_isinfnan() NV 引数が次のいずれかの場合に true を返すユーティリティ関数です。
無限大または NaN、それ以外の場合は false。 さらに詳細にテストするには、次を使用します。 Perl_isinf()
と Perl_isnan().

これは、次の論理逆でもあります。 Perl_isfinite().

bool isinfnan(NV nv)

Perl_signbit
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

NV の符号ビットが設定されている場合は 0 以外の整数を返し、設定されていない場合は XNUMX を返します。

Configure がこのシステムに サインビット() それはNVで動作します。
perl.h の #define を介して使用するだけです。 それ以外の場合は、これに頼ってください
実装。 この関数の主な用途は、-0.0 をキャッチすることです。

設定メモ: この関数は、プレーンな関数ではなく「Perl_signbit」と呼ばれます。
「signbit」は、システムに次のものがあることが想像しやすいためです。 サインビット() 機能または
このマクロは、私たちが選択した特定の NV ではたまたま機能しませんでした。 そうすべきではありません
サインビットを Perl_signbit として再#define するだけで、標準のシステムヘッダーが次のように動作することを期待します。
幸せになる。 また、これはノーコンテキスト関数 (pTHX_ なし) です。 Perl_signbit()
通常、システムの単純なマクロ呼び出しとして perl.h で再定義されます。 サインビット().
ユーザーは常に電話をかけるべきです Perl_signbit().

int Perl_signbit(NV f)

スキャンビン
下位互換性のため。 代わりに「grok_bin」を使用してください。

NV scan_bin(const char* start, STRLEN len,
STRLEN* リレン)

scan_hex
下位互換性のため。 代わりに「grok_hex」を使用してください。

NV scan_hex(const char* start, STRLEN len,
STRLEN* リレン)

scan_oct
下位互換性のため。 代わりに「grok_oct」を使用してください。

NV scan_oct(const char* start, STRLEN len,
STRLEN* リレン)

廃止された 後方 互換性 機能

これらの一部は廃止されることもあります。 これらをコンパイルした Perl から除外するには、次のようにします。
このオプションを設定に追加します:「-Accflags='-DNO_MATHOMS'」

カスタムOP_DESC
指定されたカスタム操作の説明を返します。 これはかつて OP_DESC によって使用されていました
マクロですが、現在は存在しません。これは互換性のためだけに残されており、本来は使用すべきではありません。
利用される。

const char *custom_op_desc(const OP *o)

カスタム操作名
指定されたカスタム操作の名前を返します。 これはかつて OP_NAME マクロで使用されていました。
しかし、現在はそうではありません。これは互換性のために保持されているだけであり、使用すべきではありません。

const char *custom_op_name(const OP *o)

gv_fetch メソッド
「gv_fetchmethod_autoload」を参照してください。

GV* gv_fetchmethod(HV* スタッシュ、const char* 名)

is_utf8_char
廃止されました! この関数は Perl の将来のリリースから削除される予定です。
新しいコードには使用しないでください。 既存のコードから削除してください。

任意の数のバイトが有効な UTF-8 文字で始まるかどうかをテストします。 注記
INVARIANT (つまり、非 EBCDIC マシンでは ASCII) 文字が有効な UTF-8 であること
キャラクター。 次の場合、UTF-8 文字の実際のバイト数が返されます。
有効です。それ以外の場合は 0 です。

不正な入力が行われる可能性があるため、この関数は非推奨になりました。
入力バッファの終わりを超えて読み取りが行われる可能性があります。 代わりに「isUTF8_CHAR」を使用してください。

STRLEN is_utf8_char(const U8 *s)

is_utf8_char_buf
これはマクロ「isUTF8_CHAR」と同じです。

STRLEN is_utf8_char_buf(const U8 *buf,
const U8 *buf_end)

パックキャット
エンジン実装 パック（） パール関数。 注: パラメータ next_in_list および
フラグは使用されません。 この呼び出しは使用しないでください。 代わりにパックリストを使用してください。

void Pack_cat(SV *cat, const char *pat,
const char *特許、SV **beglist、
SV **エンドリスト、SV ***next_in_list、
U32 フラグ)

パッドコンプ名タイプ
位置で字句変数の型を検索します。 po 現在では-
コンパイルパッド。 変数が型指定されている場合、その変数が属するクラスのスタッシュ
入力されたものが返されます。 そうでない場合は、「NULL」が返されます。

HV * パッド補償名タイプ(PADOFFSET po)

sv_2pvbyte_nolen
SV のバイトエンコード表現へのポインターを返します。 SVを引き起こす可能性がある
副作用として UTF-8 からダウングレードされます。

通常は「SvPVbyte_nolen」マクロを介してアクセスされます。

char* sv_2pvbyte_nolen(SV* sv)

sv_2pvutf8_nolen
SV の UTF-8 エンコード表現へのポインターを返します。 SVを引き起こす可能性がある
副作用として UTF-8 にアップグレードされます。

通常は「SvPVutf8_nolen」マクロ経由でアクセスします。

char* sv_2pvutf8_nolen(SV* sv)

sv_2pv_nolen
「sv_2pv()」と似ていますが、長さも返しません。 通常は、
代わりにマクロ ラッパー「SvPV_nolen(sv)」を使用します。

char* sv_2pv_nolen(SV* sv)

sv_catpvn_mg
「sv_catpvn」と似ていますが、「set」マジックも処理します。

void sv_catpvn_mg(SV *sv, const char *ptr,
STRLENレン）

sv_catsv_mg
「sv_catsv」と似ていますが、「set」マジックも処理します。

void sv_catsv_mg(SV *dsv, SV *ssv)

sv_force_normal
SV 上のさまざまな種類の偽装を元に戻します。PV が共有文字列の場合は、
私的コピー; 私たちが参照者である場合は、参照を停止してください。 glob の場合は、xpvmg にダウングレードします。
「sv_force_normal_flags」も参照してください。

void sv_force_normal(SV *sv)

sv_iv に対応できないコンパイラ用の「SvIVx」マクロのプライベート実装
複雑なマクロ式。 代わりに常にマクロを使用してください。

IV sv_iv(SV* sv)

sv_nolocking
ロック モジュールが存在しない場合に SV を「ロック」するダミー ルーチン。 存在する
NULL 関数ポインターのテストを避けるため、また警告が発生する可能性があるため
ある程度の厳しさのもとで。

「置き換えられた」 sv_nosharing().

void sv_nolocking(SV *sv)

sv_nounlocking
ロック モジュールが存在しない場合に SV を「ロック解除」するダミー ルーチン。
NULL 関数ポインターのテストを回避するために存在します。また、潜在的にテストが行​​われる可能性があるため、
ある程度の厳密さの下で警告します。

「置き換えられた」 sv_nosharing().

void sv_nounlocking(SV *sv)

sv_nv に対応できないコンパイラ用の「SvNVx」マクロのプライベート実装。
複雑なマクロ式。 代わりに常にマクロを使用してください。

NV sv_nv(SV* sv)

sv_pv 代わりに「SvPV_nolen」マクロを使用してください

char* sv_pv(SV *sv)

sv_pvbyte
代わりに「SvPVbyte_nolen」を使用してください。

char* sv_pvbyte(SV *sv)

sv_pvbyten
対応できないコンパイラ向けの「SvPVbyte」マクロのプライベート実装
複雑なマクロ式を使用します。 代わりに常にマクロを使用してください。

char* sv_pvbyten(SV *sv, STRLEN *lp)

sv_pvn に対応できないコンパイラ用の「SvPV」マクロのプライベート実装
複雑なマクロ式。 代わりに常にマクロを使用してください。

char* sv_pvn(SV *sv, STRLEN *lp)

sv_pvutf8
代わりに「SvPVutf8_nolen」マクロを使用してください

char* sv_pvutf8(SV *sv)

sv_pvutf8n
対応できないコンパイラ向けの「SvPVutf8」マクロのプライベート実装
複雑なマクロ式を使用します。 代わりに常にマクロを使用してください。

char* sv_pvutf8n(SV *sv, STRLEN *lp)

sv_taint
SV を汚染します。 代わりに「SvTAINTED_on」を使用してください。

void sv_taint(SV* sv)

sv_unref
SV の RV ステータスの設定を解除し、以前の状態の参照カウントをデクリメントします。
RV によって参照されます。 これはほぼ逆転と考えることができます。
「newSVrv」。 これは、「フラグ」がゼロの「sv_unref_flags」です。 「SvROK_off」を参照してください。

void sv_unref(SV* sv)

sv_usepvn
SV に「ptr」を使用して文字列値を検索するように指示します。 呼び出しによって実装される
「sv_usepvn_flags」の「flags」が 0 であるため、「set」マジックは処理されません。 見る
「sv_usepvn_flags」。

void sv_usepvn(SV* sv, char* ptr, STRLEN len)

sv_usepvn_mg
「sv_usepvn」と似ていますが、「set」マジックも処理します。

void sv_usepvn_mg(SV *sv, char *ptr, STRLEN len)

sv_uv に対応できないコンパイラ用の「SvUVx」マクロのプライベート実装
複雑なマクロ式。 代わりに常にマクロを使用してください。

UV sv_uv(SV* sv)

unpack_str
エンジン実装 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 フラグ)

utf8_to_uvchr
廃止されました! この関数は Perl の将来のリリースから削除される予定です。
新しいコードには使用しないでください。 既存のコードから削除してください。

文字列「s」の最初の文字のネイティブ コード ポイントを返します。
UTF-8 エンコードであると想定されます。 「retlen」は、バイト単位の長さに設定されます。
そのキャラクター。

すべてではありませんが、一部の UTF-8 の不正な形式が検出され、実際に一部の不正な形式が検出されます。
入力により、入力バッファの末尾を超えた読み取りが発生する可能性があります。そのため、
関数は廃止されました。 代わりに「utf8_to_uvchr_buf」を使用してください。

「s」が検出された異常の 8 つを指しており、UTFXNUMX 警告が有効になっている場合、
ゼロが返され、*retlen は (「retlen」が NULL でない場合) -1 に設定されます。 もしそれらが
警告はオフ、明確に定義されている場合は計算値 (または Unicode REPLACEMENT
CHARACTER (そうでない場合) がサイレントに返され、*retlen が設定されます (「retlen」が設定されていない場合)
NULL) なので、("s" + *retlen) が "s" 内の次の可能な位置になります。
不正でない文字を開始します。 詳細については、「utf8n_to_uvchr」を参照してください。
REPLACEMENT CHARACTER が返されます。

UV utf8_to_uvchr(const U8 *s, STRLEN *retlen)

utf8_to_uvuni
廃止されました! この関数は Perl の将来のリリースから削除される予定です。
新しいコードには使用しないでください。 既存のコードから削除してください。

文字列「s」の最初の文字の Unicode コード ポイントを返します。
UTF-8 エンコードであると想定されます。 「retlen」は、バイト単位の長さに設定されます。
そのキャラクター。

すべてではありませんが、一部の UTF-8 の不正な形式が検出され、実際に一部の不正な形式が検出されます。
入力により、入力バッファの末尾を超えた読み取りが発生する可能性があります。これが理由の XNUMX つです。
この関数が廃止される理由。 もうXNUMXつは、非常に限られた範囲でのみ発生するということです。
Unicode とネイティブ コード ポイントに興味がある場合は、
あなた。 代替案については、「utf8_to_uvuni_buf」を参照してください。

「s」が検出された異常の 8 つを指しており、UTFXNUMX 警告が有効になっている場合、
ゼロが返され、*retlen は (「retlen」が NULL を指していない場合) -1 に設定されます。 もし
これらの警告はオフであり、明確に定義されている場合は計算値 (または Unicode
REPLACEMENT CHARACTER (そうでない場合) がサイレントに返され、*retlen が設定されます (そうでない場合)。
"retlen" は NULL ではない)、そのため ("s" + *retlen) が "s" 内の次の可能な位置になります。
それは、不正ではない文字を開始する可能性があります。 詳細については、「utf8n_to_uvchr」を参照してください。
REPLACEMENT CHARACTER が返されたとき。

UV utf8_to_uvuni(const U8 *s, STRLEN *retlen)

オプトリー 建設

新しいアサインノップ
代入演算を構築、チェックし、返します。 左 と 右 供給
割り当てのパラメータ。 それらはこの関数によって消費され、一部になります
構築された op ツリーの。

If オプタイプ 「OP_ANDASSIGN」、「OP_ORASSIGN」、または「OP_DORASSIGN」の場合、適切な
条件付き optree が構築されます。 もし オプタイプ 二項演算子のオペコードです。
「OP_BIT_OR」など、バイナリ演算を実行する演算が構築されます。
そして結果を左の引数に代入します。 いずれにしても、もし オプタイプ ゼロ以外です
その後 フラグ 効果はありません。

If オプタイプ がゼロの場合、プレーンなスカラーまたはリストの代入が構築されます。 どれの
割り当ての種類は自動的に決定されます。 フラグ XNUMXビットを与える
ただし、「OPf_KIDS」は自動的に設定され、上にシフトされます。
1 ビット、値 2 または XNUMX のビットを除く、「op_private」の XNUMX ビット
必要に応じて自動的に設定されます。

OP * newASSIGNOP(I32 フラグ、OP *left、I32 optype、
OP※右）

新しいBINOP
任意のバイナリ型の op を構築、チェックし、返します。 type オペコードです。
フラグ 「OPf_KIDS」が設定されることを除き、「op_flags」の XNUMX ビットを指定します。
自動的に、「op_private」の XNUMX ビットを XNUMX ビット上にシフトします。
値 1 または 2 のビットは必要に応じて自動的に設定されます。 最初の と last
バイナリ演算の直接の子となる演算を XNUMX つまで指定します。 彼らは消費される
この関数により、構築された op ツリーの一部になります。

OP * newBINOP(I32 タイプ、I32 フラグ、OP *first、
OP ※ラスト）

NEWCONDOP
条件式 ("cond_expr") 演算を構築、検査し、返します。 フラグ
「OPf_KIDS」が設定されることを除き、「op_flags」の XNUMX ビットを指定します。
自動的に、「op_private」の XNUMX ビットを XNUMX ビット上にシフトします。
値 1 のビットが自動的に設定されることを意味します。 最初の 表現を提供します
XNUMX つのブランチの間で選択し、 トゥルーオペ と 偽りの 枝を供給します。
それらはこの関数によって消費され、構築された op ツリーの一部になります。

OP * newCONDOP(I32 フラグ、OP *first、OP *trueop、
OP *偽ソプ)

新しいDEFSVOP
$_ にアクセスするための操作を、字句変数として構築して返します (
現在のスコープ内で「my $_」として宣言されるか、グローバル $_ として宣言されます。

OP * newDEFSVOP()

NEWFOROP
「foreach」ループ (反復) を表す op ツリーを構築、チェックし、返します。
値のリストを通じて)。 を可能にする構造を持つ重量級のループです。
「last」などによってループを終了します。

sv オプションで、各項目に順番にエイリアスされる変数を指定します。 もし
null の場合、デフォルトは $_ (字句またはグローバル) になります。 式 のリストを提供します
反復処理する値。 コロナ新型ウィルス(COVID-XNUMX)やメンタルヘルスの崩壊を避ける為の ループの本体を提供し、 CONT
オプションで、本体の後半として動作する「継続」ブロックを提供します。
これらの optree 入力はすべてこの関数によって消費され、
op ツリーを構築しました。

フラグ 「leaveloop」op の「op_flags」の XNUMX ビットを与え、上にシフトします。
XNUMX ビット、「leaveloop」op の「op_private」の XNUMX ビット、ただし、(
どちらの場合も) 一部のビットは自動的に設定されます。

OP * newFOROP(I32 フラグ、OP *sv、OP *expr、OP *block、
OP *続き)

newギブノップ
「指定された」ブロックを表す op ツリーを構築、チェックし、返します。 条件
字句変数にローカルに割り当てられる式を指定します。
コロナ新型ウィルス(COVID-XNUMX)やメンタルヘルスの崩壊を避ける為の 「指定された」構成体の本体を提供します。 彼らはこれに飲み込まれてしまう
機能し、構築された op ツリーの一部になります。 defsv_off パッドオフセットです
影響を受けるスカラー字句変数の値。 0 の場合、グローバル $_
使用されます。

OP * newGIVENOP(OP *cond, OP *block,
PADOFFSET defsv_off)

newGVOP 埋め込みオブジェクトを含むあらゆるタイプの演算を構築、チェックし、返します。
GV への参照。 type オペコードです。 フラグ XNUMX ビットの「op_flags」を与えます。
gv 操作が参照する必要がある GV を識別します。 この関数を呼び出すと、
それへの参照の所有権を譲渡します。

OP * newGVOP(I32 タイプ、I32 フラグ、GV *gv)

新しいリスト
任意のリスト型の演算を構築、チェックし、返します。 type オペコードです。
フラグ 「OPf_KIDS」が設定されることを除き、「op_flags」の XNUMX ビットを指定します。
必要に応じて自動的に実行されます。 最初の と last 最大 XNUMX つの操作を直接指定します
リスト op の子。 それらはこの関数によって消費され、
op ツリーを構築しました。

ほとんどのリスト演算子では、チェック関数はすべての子供演算子が存在することを期待します。
すでにあるため、「newLISTOP(OP_JOIN, ...)」(例) を呼び出すことは適切ではありません。 あなたは何ですか
その場合にやりたいのは、OP_LISTタイプのOPを作成し、さらに子を追加することです
それを指定して、「op_convert_list」を呼び出します。 詳細については、「op_convert_list」を参照してください。

OP * newLISTOP(I32 タイプ、I32 フラグ、OP *first、
OP ※ラスト）

新しいLOGOP
論理 (フロー制御) 演算を構築、チェックし、返します。 type オペコードです。
フラグ 「OPf_KIDS」が設定されることを除き、「op_flags」の XNUMX ビットを指定します。
自動的に、「op_private」の XNUMX ビットを XNUMX ビット上にシフトします。
値 1 のビットが自動的に設定されることを意味します。 最初の 表現を提供します
流れをコントロールし、 他の オペレーションのサイド (代替) チェーンを提供します。 彼らは
はこの関数によって消費され、構築された op ツリーの一部になります。

OP * newLOGOP(I32 タイプ、I32 フラグ、OP *first、
OP ※その他）

NEWLOOPEX
ループを終了する操作 (「goto」や「last」など) を構築、チェックし、返します。
type オペコードです。 ラベル のターゲットを決定するパラメータを提供します。
オプ; この関数によって消費され、構築された op ツリーの一部になります。

OP * newLOOPEX(I32タイプ、OP *ラベル)

newLOOPOP
ループを表現する op ツリーを構築、検査し、返します。 これは単なるループです
op ツリーを介した制御フロー内。 重量級のループはありません
「last」などでループを抜けられる構造。 フラグ 与える
最上位の演算の「op_flags」の XNUMX ビット（一部のビットが設定されることを除く）
必要に応じて自動的に実行されます。 式 式制御ループを提供します
反復、および コロナ新型ウィルス(COVID-XNUMX)やメンタルヘルスの崩壊を避ける為の ループの本体を提供します。 彼らはこれに飲み込まれてしまう
機能し、構築された op ツリーの一部になります。 デバッグ可能 現在、
未使用であり、常に 1 である必要があります。

OP * newLOOPOP(I32 フラグ、I32 デバッグ可能、OP *expr、
OP *ブロック)

newMETHOP
評価されたメソッド名を持つメソッド型の演算を構築、チェックし、返します。
実行時。 type オペコードです。 フラグ 「op_flags」の XNUMX ビットを指定します。ただし、
「OPf_KIDS」は自動的に設定され、XNUMX ビット上にシフトすると、XNUMX ビットが
ただし、値 1 のビットは自動的に設定されます。
ダイナミックメス メソッド名を評価する演算を提供します。 これに消費される
機能し、構築された op ツリーの一部になります。 サポートされているオプタイプ:
OP_メソッド。

OP * newMETHOP(I32 タイプ、I32 フラグ、OP *first)

newMETHOP_named
定数のメソッド名を持つメソッド型の op を構築、チェックし、返します。
type オペコードです。 フラグ 「op_flags」の XNUMX ビットを与え、上にシフトします
XNUMX ビット、「op_private」の XNUMX ビット。 const_meth 定数メソッドを提供します
名前; 共有 COW 文字列である必要があります。 サポートされているオプタイプ: OP_METHOD_NAMED。

OP * newMETHOP_named(I32 タイプ、I32 フラグ、
SV *const_meth)

新しいNULLLIST
空のリストを表す新しい「スタブ」演算を構築、チェックし、返します。
式です。

OP * newNULLLIST()

newOP 任意の基本型 (余分な要素を持たない任意の型) の演算を構築、チェックし、返します。
田畑）。 type オペコードです。 フラグ 「op_flags」の XNUMX ビットを与え、そして、
「op_private」の XNUMX ビットを XNUMX ビット上にシフトします。

OP * newOP(I32 タイプ、I32 フラグ)

ニューPADOP
への参照を含む任意の型の op を構築、チェックし、返します。
パッド要素。 type オペコードです。 フラグ XNUMX ビットの「op_flags」を与えます。 あ
パッド スロットは自動的に割り当てられ、 sv; この関数はかかります
それに対する XNUMX つの参照の所有権。

この関数は、Perl が ithread を使用するようにコンパイルされている場合にのみ存在します。

OP * newPADOP(I32 タイプ、I32 フラグ、SV *sv)

newPMOP 任意のパターン マッチング タイプの op を構築、チェックし、返します。 type は
オペコード。 フラグ XNUMX ビットの「op_flags」を与え、XNUMX ビット上にシフトすると、
XNUMXビットの「op_private」。

OP * newPMOP(I32 タイプ、I32 フラグ)

newPVOP 埋め込みオブジェクトを含むあらゆるタイプの op を構築、チェックし、返します。
C レベル ポインター (PV)。 type オペコードです。 フラグ の XNUMX ビットを与えます
「op_flags」。 pv C レベル ポインタを提供します。このポインタは、次を使用して割り当てられている必要があります。
"PerlMemShared_malloc"; op が破棄されるとメモリが解放されます。

OP * newPVOP(I32 タイプ、I32 フラグ、char *pv)

新しい範囲
下位の「フリップ」および「フロップ」演算を伴う「範囲」演算を構築して返します。
フラグ 「フリップ」演算の「op_flags」の XNUMX ビットを与え、XNUMX ビット上にシフトします
ビット、「flip」操作と「range」操作の両方の「op_private」の XNUMX ビット。ただし、
値 1 のビットが自動的に設定されることを意味します。 左 と 右 供給
範囲の終点を制御する式。 彼らはこれに飲み込まれてしまう
機能し、構築された op ツリーの一部になります。

OP * newRANGE(I32 フラグ、OP *左、OP *右)

newSLICEOP
「lslice」(リストスライス) 演算を構築、チェックし、返します。 フラグ 与える
XNUMX ビットの「op_flags」。ただし、「OPf_KIDS」は自動的に設定されます。
「op_private」の XNUMX ビットを XNUMX ビット上にシフトします。ただし、
値 1 または 2 は必要に応じて自動的に設定されます。 リスト値 と 添字 供給
スライスのパラメータ。 それらはこの関数によって消費され、
op ツリーを構築しました。

OP * newSLICEOP(I32 フラグ、OP *添え字、
OP *リスト値)

newSTATEOP
状態演算 (COP) を構築します。 状態操作は通常「次の状態」操作ですが、
現在コンパイルされているコードのデバッグが有効になっている場合は、「dbstate」オペレーションになります。 状態
op は「PL_curcop」(または「PL_compiling」) から設定されます。 もし ラベル null ではない、それは
状態演算に付けるラベルの名前を指定します。 この関数はかかります
が指すメモリの所有権 ラベル、無料になります。 フラグ 与える
状態 op の「op_flags」の XNUMX ビット。

If o null の場合、状態 op が返されます。 それ以外の場合、状態演算は次のように結合されます。 o
"lineseq" リスト演算に変換され、返されます。 o この関数によって消費され、
返された op ツリーの一部になります。

OP * newSTATEOP(I32 フラグ、char *ラベル、OP *o)

newSVOP 埋め込み SV を含むあらゆるタイプの op を構築、チェックし、返します。
type オペコードです。 フラグ XNUMX ビットの「op_flags」を与えます。 sv SVを与える
opに埋め込みます。 この関数は、その関数への XNUMX つの参照の所有権を取得します。

OP * newSVOP(I32 タイプ、I32 フラグ、SV *sv)

newUNOP 任意の単項型の演算を構築、検査し、返します。 type オペコードです。
フラグ 「OPf_KIDS」が設定されることを除き、「op_flags」の XNUMX ビットを指定します。
必要に応じて自動的に、XNUMX ビット上にシフトして、
「op_private」。ただし、値 1 のビットが自動的に設定されます。 最初の
単項演算の直接の子となるオプションの演算を指定します。 それはによって消費されます
この関数は、構築された op ツリーの一部になります。

OP * newUNOP(I32 タイプ、I32 フラグ、OP *first)

新しいUNOP_AUX
「newUNOP」に似ていますが、代わりに op_aux を使用して UNOP_AUX 構造体を作成します。
aux に初期化されました

OP* newUNOP_AUX(I32 タイプ、I32 フラグ、OP* 最初、
UNOP_AUX_item *aux)

新しいWHENOP
「when」ブロックを表す op ツリーを構築、チェックし、返します。 条件
テスト式を提供し、 コロナ新型ウィルス(COVID-XNUMX)やメンタルヘルスの崩壊を避ける為の 実行されるブロックを提供します
テストが true と評価された場合。 それらはこの関数によって消費され、一部になります
構築された op ツリーの。 条件 多くの場合、DWIM 的に解釈されます。
$_ との比較。「デフォルト」ブロックを生成する場合は null にすることもできます。

OP * newWHENOP(OP *cond, OP *block)

newWILEOP
「while」ループを表す op ツリーを構築、チェックし、返します。 これは
重量級ループ、「最後」でループから抜けることができる構造となっており、
みたいな。

ループ ループ内で使用する、オプションの事前構築された「enterloop」演算子です。 もしそれが
null の場合、適切な操作が自動的に構築されます。 式 を供給します
ループの制御式。 コロナ新型ウィルス(COVID-XNUMX)やメンタルヘルスの崩壊を避ける為の ループの本体を提供し、 CONT
オプションで、本体の後半として動作する「継続」ブロックを提供します。
これらの optree 入力はすべてこの関数によって消費され、
op ツリーを構築しました。

フラグ 「leaveloop」op の「op_flags」の XNUMX ビットを与え、上にシフトします。
XNUMX ビット、「leaveloop」op の「op_private」の XNUMX ビット、ただし、(
どちらの場合も) 一部のビットは自動的に設定されます。 デバッグ可能 現在は未使用です
そして常に 1 である必要があります。 私が持っています true として指定すると、ループ本体を強制的に
独自のスコープに含めることができます。

OP * newWHILEOP(I32 フラグ、I32 デバッグ可能、
LOOP *ループ、OP *expr、OP *ブロック、
OP *続き、I32 has_my)

オプトリー 操作 機能

alloccopstash
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

この関数はスレッド ビルドでのみ使用可能で、エントリを
渡されるスタッシュの「PL_stashpad」。

PADOFFSET alloccopstash(HV *hv)

ブロックエンド
コンパイル時のスコープ終了を処理します。 床 によって返されるセーブスタック インデックスです。
「block_start」、および seq ブロックの本体です。 おそらくブロックを返します
変更されました。

OP * block_end(I32 フロア、OP *seq)

ブロックスタート
コンパイル時のスコープエントリを処理します。 ブロック終了時にヒントが復元されるように手配します。
また、字句変数のスコープを正しくするためにパッド シーケンス番号も処理します。
「block_end」で使用するセーブスタック インデックスを返します。

int block_start(int full)

ck_entersub_args_list
「entersub」op ツリーの引数部分のデフォルトの修正を実行します。 これ
リスト コンテキストを各引数操作に適用することで構成されます。 これは
「&」のマークが付いた呼び出し、メソッド呼び出し、または呼び出しで使用される標準処理
サブルーチン参照、または呼び出し先がアクセスできないその他の呼び出しを介して
コンパイル時、または呼び出し先にプロトタイプがない呼び出しで識別されます。

OP * ck_entersub_args_list(OP *entersubop)

ck_entersub_args_proto
に基づいて「entersub」op ツリーの引数部分の修正を実行します。
サブルーチンのプロトタイプ。 これにより、引数 ops に次のようなさまざまな変更が加えられます。
「refgen」ops の挿入までコンテキストを適用し、番号と
プロトタイプによって指示された引数の構文タイプ。 これが標準です
サブルーチン呼び出しで使用される処理。「&」のマークが付いていません。呼び出し先は次のとおりです。
コンパイル時に識別され、プロトタイプがあります。

プロトスフ 呼び出しに適用されるサブルーチン プロトタイプを提供します。 それはもしかしたら
通常の定義されたスカラー。文字列値が使用されます。 あるいは、
便宜上、サブルーチン オブジェクト (「SV*」にキャストされた「CV*」) である可能性があります。
これにはプロトタイプがあります。 提供されたプロトタイプは、どのような形式であっても、
op ツリーによって参照される実際の呼び出し先と一致するようにします。

引数 ops がプロトタイプと一致しない場合、たとえば
受け入れられない数の引数がある場合でも、有効な op ツリーが返されます。 エラー
パーサーの状態に反映され、通常は次の時点で XNUMX つの例外が発生します。
発生したすべてのコンパイル エラーをカバーする最上位レベルの解析。 で
エラー メッセージでは、呼び出し先は、 なめぐ
パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

OP * ck_entersub_args_proto(OP *entersubop,
GV *namegv、SV *protosv)

ck_entersub_args_proto_or_list
次のいずれかに基づいて、「entersub」op ツリーの引数部分の修正を実行します。
サブルーチン プロトタイプ、またはデフォルトのリスト コンテキスト処理を使用します。 これは
サブルーチン呼び出しで使用される標準処理。「&」のマークが付いていません。
呼び出し先はコンパイル時に識別できます。

プロトスフ 呼び出しに適用されるサブルーチン プロトタイプを指定するか、またはそれを示します。
原型がないということ。 それは通常のスカラーである可能性があります。その場合、
定義されている場合は文字列値がプロトタイプとして使用され、未定義の場合は文字列値がプロトタイプとして使用されます。
その場合、プロトタイプは存在しません。 あるいは、便宜上、
サブルーチン オブジェクト (「SV*」にキャストされた「CV*」)、そのプロトタイプ
ある場合は使用されます。 提供されたプロトタイプ (またはその欠如)、
どちらの形式であっても、操作によって参照される実際の呼び出し先と一致する必要はありません。
ツリー。

引数 ops がプロトタイプと一致しない場合、たとえば
受け入れられない数の引数がある場合でも、有効な op ツリーが返されます。 エラー
パーサーの状態に反映され、通常は次の時点で XNUMX つの例外が発生します。
発生したすべてのコンパイル エラーをカバーする最上位レベルの解析。 で
エラー メッセージでは、呼び出し先は、 なめぐ
パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

OP * ck_entersub_args_proto_or_list(OP *entersubop,
GV *namegv、
SV *protosv)

cv_const_sv
「cv」がインライン展開に適した定数サブの場合、定数値を返します。
サブから返されました。 それ以外の場合は、NULL を返します。

定数サブルーチンは、「newCONSTSUB」を使用して作成するか、「定数」で説明されているように作成できます。
perlsub の関数」。

SV* cv_const_sv(const CV *const cv)

cv_get_call_checker
への呼び出しを修正するために使用される関数を取得します。 cv。 具体的には、
関数はサブルーチン呼び出しの「entersub」op ツリーに適用され、マークされていません。
「&」を使用すると、コンパイル時に呼び出し先を次のように識別できます。 cv.

C レベルの関数ポインタは次のように返されます。 *ckfun_p、その SV 引数は次のとおりです。
戻ってきた *ckobj_p。 この関数は次の方法で呼び出されるように設計されています。

entersubop = (*ckfun_p)(aTHX_ entersubop, namegv, (*ckobj_p));

この通話では、 エンターサブップ 「entersub」演算子へのポインタです。置換される可能性があります。
チェック機能により、 なめぐ 使用する必要がある名前を提供する GV です
必要に応じて、チェック関数によって「entersub」オペレーションの呼び出し先を参照します。
診断を発行します。 標準外のチェック機能を適用することが許可されています
別のサブルーチンの呼び出しやメソッド呼び出しなどの状況。

デフォルトでは、関数は Perl_ck_entersub_args_proto_or_list であり、SV
パラメータは cv 自体。 これにより、標準のプロトタイプ処理が実装されます。 かもね
特定のサブルーチンについては、「cv_set_call_checker」によって変更されます。

void cv_get_call_checker(CV *cv,
Perl_call_checker *ckfun_p,
SV **ckobj_p)

cv_set_call_checker
「cv_set_call_checker_flags」の元の形式。これに渡されます。
下位互換性のための「CALL_CHECKER_REQUIRE_GV」フラグ。

void cv_set_call_checker(CV *cv,
Perl_call_checker ckfun、
SV *ckobj)

cv_set_call_checker_flags
への通話を解決するために使用される関数を設定します。 cv。 具体的には、
関数はサブルーチン呼び出しの「entersub」op ツリーに適用され、マークされていません
「&」を使用すると、コンパイル時に呼び出し先を次のように識別できます。 cv.

C レベルの関数ポインタは次の形式で提供されます。 くふん、その SV 引数は次のとおりです。
で供給される CKOBJ。 関数は次のように定義する必要があります。

STATIC OP * ckfun(pTHX_ OP *op, GV *namegv, SV *ckobj)

これは次の方法で呼び出すことを目的としています。

entersubop = ckfun(aTHX_ entersubop, namegv, ckobj);

この通話では、 エンターサブップ 「entersub」演算子へのポインタです。置換される可能性があります。
チェック機能により、 なめぐ が使用する名前を指定します。
何かを発行する必要がある場合は、「entersub」オペレーションの呼び出し先を参照する関数をチェックします。
診断。 標準外のチェック機能を適用することが許可されています
別のサブルーチンの呼び出しやメソッド呼び出しなどの状況。

なめぐ 実際には GV ではない可能性があります。 効率性を高めるために、Perl は CV または他の SV を渡す場合があります。
その代わり。 渡されたものはすべて「cv_name」の最初の引数として使用できます。 あなた
"CALL_CHECKER_REQUIRE_GV" を フラグ.

特定の CV の現在の設定は、「cv_get_call_checker」で取得できます。

void cv_set_call_checker_flags(
CV *cv、Perl_call_checker ckfun、SV *ckobj、
U32 フラグ
)

リンクリスト
optree のルートを指定して、「op_next」を使用して実行順序に従ってツリーをリンクします。
ポインタを取得し、実行された最初の操作を返します。 これがすでに行われている場合は、
やり直しは行われず、「o->op_next」が返されます。 「o->op_next」がまだない場合
セット、 o 少なくとも「UNOP」である必要があります。

OP* リンクリスト(OP *o)

新しいコンスタ
「newCONSTSUB_flags」を参照してください。

CV* newCONSTSUB(HV* スタッシュ、const char* 名、SV* sv)

newCONSTSUB_flags
Perl「sub FOO () { 123 }」に相当する定数 sub を作成します。
コンパイル時のインライン化用。

現在、「flags」に有効な値は SVf_UTF8 のみです。

新しく作成されたサブルーチンは、SV で渡されたへの参照の所有権を取得します。

SV に NULL を渡すと、「sub BAR () {}」と同等の定数 sub が作成されます。
デストラクターとして使用される場合は呼び出されませんが、呼び出しのオーバーヘッドが抑制されます。
「オートロード」にします。 (ただし、このフォームはコンパイル時にインライン化できません。)

CV* newCONSTSUB_flags(HV* スタッシュ、const char* 名、
STRLEN len、U32 フラグ、SV* sv)

newXS XSUB を Perl サブルーチンとして接続するために「xsubpp」によって使用されます。 ファイル名 静的である必要がある
ストレージとして直接使用されるため、 CvFILE()、コピーは作成されません。

OpHAS_SIBLING
o に兄弟がある場合は true を返します

bool OpHAS_SIBLING(OP *o)

OpLASTSIB_set
o にはこれ以上兄弟がいないものとしてマークされます。 「PERL_OP_PARENT」ビルドでは、o をマークします
指定された親を持つ。 「OpMORESIB_set」および「OpMAYBESIB_set」も参照してください。 のために
上位レベルのインターフェイスについては、「op_sibling_splice」を参照してください。

void OpLASTSIB_set(OP *o, OP *parent)

OpMAYBESIB_set
sib が有効かどうかに応じて、条件付きで「OpMORESIB_set」または「OpLASTSIB_set」を実行します。
null ではない。 上位レベルのインターフェイスについては、「op_sibling_splice」を参照してください。

void OpMAYBESIB_set(OP *o, OP *sib, OP *parent)

OpMORESIB_set
o の兄弟をゼロ以外の値 sib に設定します。 「OpLASTSIB_set」および「OpLASTSIB_set」も参照してください。
「OpMAYBESIB_set」。 上位レベルのインターフェイスについては、「op_sibling_splice」を参照してください。

void OpMORESIB_set(OP *o, OP *sib)

兄弟
o の兄弟を返します。兄弟がない場合は NULL を返します。

OP* OpSIBLING(OP *o)

op_append_elem
リスト型の操作内に直接含まれる操作のリストに項目を追加します。
長くなったリストを返します。 最初の はリスト型の演算であり、 last するべきです
リストに追加します。 オプタイプ リストの目的のオペコードを指定します。 もし 最初の
はまだ正しいタイプのリストではないため、適切なタイプのリストにアップグレードされます。 どちらかの場合
最初の or last が null の場合、もう一方は変更されずに返されます。

OP * op_append_elem(I32 optype, OP *first, OP *last)

op_append_list
XNUMX つのリスト型操作内に直接含まれる操作のリストを連結します。
結合されたリストを返します。 最初の と last 連結するリスト型の演算です。
オプタイプ リストの目的のオペコードを指定します。 どちらかの場合 最初の or last ではありません
すでに正しいタイプのリストがある場合は、リストが XNUMX つにアップグレードされます。 どちらかの場合 最初の
or last が null の場合、もう一方は変更されずに返されます。

OP * op_append_list(I32 optype, OP *first, OP *last)

OP_クラス
提供された OP のクラス、つまり、どの *OP 構造体が使用されているかを返します。
コア操作の場合、これは現在 PL_opargs から情報を取得しますが、PL_opargs は取得しません。
使用されるタイプを常に正確に反映します。 カスタム操作の場合、型は次から返されます。
登録が正確であることを確認するのはレジストリーの責任です。 の
返される値は、op.h の OA_* 定数の XNUMX つになります。

U32 OP_CLASS(OP *o)

op_contextualize
式を表す op ツリーに構文コンテキストを適用します。 o OPです
木と コンテキスト を指定するには、「G_SCALAR」、「G_ARRAY」、または「G_VOID」である必要があります。
適用するコンテキスト。 変更された op ツリーが返されます。

OP * op_contextualize(OP *o, I32 コンテキスト)

op_convert_list
変換する o まだリスト演算でない場合はリスト演算に変換し、
指定の type、チェック関数を呼び出し、必要に応じてターゲットを割り当てます。
そして折り畳み定数。

リスト型の操作は通常、「newLISTOP」を介して一度に XNUMX つずつ構築されます。
「op_prepend_elem」と「op_append_elem」。 そして最後にそれはに渡されます
「op_convert_list」を使用して正しいタイプにします。

OP * op_convert_list(I32 タイプ、I32 フラグ、OP *o)

OP_DESC 提供された OP の短い説明を返します。

const char * OP_DESC(OP *o)

op_free opを解放します。 これは、op がどの optree からもリンクされていない場合にのみ使用してください。

void op_free(OP *o)

op_linklist
この機能は「LINKLIST」マクロの実装です。 そうであってはなりません
直接電話した。

OP* op_linklist(OP *o)

op_lvalue
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

lvalue (「変更可能」) コンテキストを op とその子に伝播します。 type
コンテキスト タイプを表します。大まかに、実行する操作のタイプに基づいています。
"local()" は OP_NULL で表されますが、op タイプがないため変更します。
独自のものです (左辺値演算のフラグによって通知されます)。

この関数は、「$x+1」などの変更できないものを検出し、
彼らにとっては間違いです。 たとえば、「$x+1 = 2」とすると、op で呼び出されます。
タイプ OP_ADD と OP_SASSIGN の「type」引数。

また、左辺値コンテキストで特別に動作する必要があるものにフラグを立てます。
「$$x = 5」は、$x 内の参照を有効にする必要がある可能性があります。

OP * op_lvalue(OP *o、I32 タイプ)

OP_NAME 提供された OP の名前を返します。 コア操作の場合、これは名前を検索します。
op_type; op_ppaddr からのカスタム op の場合。

const char * OP_NAME(OP *o)

op_null op が不要になったときに、op を無効化しますが、依然として他のものからリンクされています。
作戦。

void op_null(OP *o)

op_parent
o に親がある場合、o の親 OP を返します。 それ以外の場合は NULL を返します。 これ
この関数は、「-DPERL_OP_PARENT」でビルドされた Perl でのみ使用できます。

OP* op_parent(OP *o)

op_prepend_elem
リスト型の操作内に直接含まれる操作のリストに項目を追加します。
長くなったリストを返します。 最初の リストの先頭に追加する操作です。 last
はリスト型の演算です。 オプタイプ リストの目的のオペコードを指定します。 もし last
はまだ正しいタイプのリストではないため、適切なタイプのリストにアップグレードされます。 どちらかの場合
最初の or last が null の場合、もう一方は変更されずに返されます。

OP * op_prepend_elem(I32 optype, OP *first, OP *last)

op_scope
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

いくつかの追加の op で op ツリーをラップし、実行時に動的スコープが有効になるようにします。
が作成されます。 元の操作は新しい動的スコープで実行され、その後、
正常に終了すると、スコープは巻き戻されます。 追加の作戦
動的スコープの作成と巻き戻しに使用されるのは、通常は「enter」/「leave」です。
ペアですが、操作が十分に単純である場合は、代わりに「スコープ」操作を使用することもできます。
完全な動的スコープ構造が必要です。

OP * op_scope(OP *o)

op_sibling_splice
op_sibling の既存のチェーンの構造を編集するための一般的な関数
ノード。 Perl レベルから類推すると スプライス（） 機能を使用すると、削除できます
XNUMX 個以上の連続したノード。それらを XNUMX 個以上の異なるノードに置き換えます。
親ノード上で必要な op_first/op_last ハウスキーピングを実行し、
子に対する op_sibling 操作。 最後に削除されたノードは次のようにマークされます。
op_sibling/op_sibparent または op_moresib フィールドを次のように更新することで、最後のノードとして
適切な。

op_next は操作されず、ノードも解放されないことに注意してください。 それが
発信者の責任。 また、空のリスト演算子は作成されません。
リストなど。 次のような高レベルの関数を使用します op_append_elem() そのために。

parent は兄弟チェーンの親ノードです。 次の場合は NULL として渡される可能性があります。
スプライシングは、チェーン内の最初または最後の操作には影響しません。

start は、スプライスされる最初のノードの前のノードです。 それに続くノード
は削除され、その後に ops が挿入されます。 NULL の場合、最初のノード
以降は削除され、先頭にノードが挿入されます。

del_count は削除するノードの数です。 ゼロの場合、ノードは削除されません。 -1の場合
または、残りの子供の数以上の場合、残りの子供はすべて
削除されました。

insert は、ノードの代わりに挿入されるノード チェーンの最初のノードです。 もし
NULL、ノードは挿入されません。

削除された操作のチェーンの先頭が返されるか、削除された操作がない場合は NULL が返されます。

例：

リターン前のアクション
------ ----- ----- -------

PP
スプライス(P、A、2、XYZ) | | 紀元前
ABCD AXYZD

PP
スプライス(P, NULL, 1, XY) | | あ
ABCD XYBCD

PP
スプライス(P, NULL, 3, NULL) | | ABC
ABCD D

PP
スプライス(P, B, 0, XY) | | ヌル
ABCDABXYCD

「op_sibparent」および「op_moresib」の下位レベルの直接操作については、を参照してください。
「OpMORESIB_set」、「OpLASTSIB_set」、「OpMAYBESIB_set」。

OP* op_sibling_splice(OP *親, OP *開始,
int del_count、OP* 挿入)

OP_TYPE_IS
指定された OP が NULL ポインターではなく、指定された型である場合に true を返します。

このマクロの否定である「OP_TYPE_ISNT」も使用できます。
「OP_TYPE_IS_NN」と「OP_TYPE_ISNT_NN」は、NULL ポインタのチェックを省略します。

bool OP_TYPE_IS(OP *o, オプタイプタイプ)

OP_TYPE_IS_OR_WAS
指定された OP が NULL ポインターではなく、指定された型である場合に true を返します。
または、タイプ OP_NULL の OP に置き換えられる前に使用されていました。

このマクロの否定である「OP_TYPE_ISNT_AND_WASNT」も使用できます。
NULL を省略する「OP_TYPE_IS_OR_WAS_NN」および「OP_TYPE_ISNT_AND_WASNT_NN」
ポインタチェック。

bool OP_TYPE_IS_OR_WAS(OP *o, Optype タイプ)

rv2cv_op_cv
実行時にサブルーチンを識別することが期待される op を調べます。
コンパイル時にどのサブルーチンを識別するかを判断しようとします。 これは
通常、Perl のコンパイル中に、プロトタイプを作成できるかどうかを判断するために使用されます。
関数呼び出しに適用されます。 CVOP 考慮されている op です。通常は「rv2cv」です
OP. 識別されたサブルーチンが特定できた場合は、そのサブルーチンへのポインタが返されます。
静的に、判断できなかった場合は null ポインタが返されます。
静的に。

現在、RV が「rv2cv」である場合、サブルーチンは静的に識別できます。
演算対象は、適切な「gv」または「const」演算によって提供されます。 「gv」オペレーションは
GV の CV スロットが装着されている場合に適しています。 「const」演算子は、次の場合に適しています。
定数値は CV を指す RV である必要があります。 このプロセスの詳細は変更される可能性があります
Perl の将来のバージョンでは。 「rv2cv」OP に「OPpENTERSUB_AMPER」フラグがある場合
設定すると、サブルーチンを静的に識別する試みは行われません。このフラグは
サブルーチン呼び出しでコンパイル時マジックを抑制し、強制的に使用するために使用されます。
デフォルトの実行時の動作。

If フラグ ビット「RV2CVOPCV_MARK_EARLY」が設定されている場合、GV を処理します
参照が変更されます。 GV が検査され、その CV スロットが
空の場合、「gv」OP には「OPpEARLY_CV」フラグが設定されます。 操作がそうでない場合
最適化が解除され、CV スロットには後で次のようなサブルーチンが追加されます。
プロトタイプでは、そのフラグは最終的に「チェックするには早すぎます」という警告をトリガーします。
プロトタイプ"。

If フラグ ビット「RV2CVOPCV_RETURN_NAME_GV」が設定されている場合、
サブルーチンへのポインタは、最も多くの値を与える GV へのポインタを返します。
このコンテキストにおけるサブルーチンの適切な名前。 通常、これは単なる
サブルーチンの「CvGV」ですが、匿名 (「CvANON」) サブルーチンの場合は、
GV を通じて参照される場合は、参照元 GV になります。 結果の「GV*」は次のようになります。
「CV*」にキャストして返します。 存在しない場合は、通常どおり null ポインタが返されます。
静的に決定可能なサブルーチン。

CV * rv2cv_op_cv(OP *cvop、U32 フラグ)

パック と 開梱

パックリスト
エンジン実装 パック（） パール関数。

void Packlist(SV *cat, const char *pat,
const char *特許、SV **beglist、
SV **エンドリスト)

解凍文字列
を実装するエンジン unpack（） パール関数。

この関数は、テンプレート pat..patend を使用して、文字列 s..strend を解凍して、
致命的な SV の数。これは Perl 引数 (@_) スタックにプッシュされます (つまり、
この呼び出しの前に「PUTBACK」を発行し、呼び出し後に「SPAGAIN」を発行する必要があります。
関数）。 プッシュされた要素の数を返します。

trend ポインタと patend ポインタは、最後のバイトに続くバイトを指す必要があります。
各文字列の文字。

この関数は Perl 引数スタック上の値を返しますが、そうではありません。
そのスタックからパラメータを取得します (したがって、特に次のことを行う必要はありません)
たとえば「call_pv」とは異なり、呼び出す前に PUSHMARK が必要です)。

I32 unpackstring(const char *pat,
const char *patend、const char *s、
const char *トレンド、U32 フラグ)

パッド Rescale データ 構造

CvPADLIST
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

CV では、PADLIST を指すように CvPADLIST(cv) を設定できます。 これは履歴書です
スクラッチパッド。字句変数とオペコードを一時的かつスレッドごとに保存します。
値。

これらの目的のために、「フォーマット」は一種の履歴書です。 eval"" も同様です (そうでない場合を除きます)
自由に呼び出すことができ、eval"" の実行が完了すると常に破棄されます)。
必須ファイルは、外部の字句スコープを持たない単純な eval です。

XSUB には CvPADLIST がありません。 dXSTARG は PL_curpad から値をフェッチしますが、それは
実際には呼び出し側のパッドです (そのスロットはすべての entersub によって割り当てられます)。 しないでください
CV が XSUB (「CvISXSUB()」で決定) の場合は CvPADLIST を取得または設定します。CvPADLIST
スロットは XSUB の別の内部目的に再利用されます。

PADLIST には、パッドが格納される C 配列があります。

PADLIST の 0 番目のエントリは、「名前」を表す PADNAMELIST です。
むしろ、字句の「静的型情報」です。 の個々の要素
PADNAMELIST は PADNAME です。 将来のリファクタリングにより、PADNAMELIST が停止される可能性があります。
PADLIST の配列に格納されるため、これに依存しないでください。 「パッドリスト名」を参照してください。

PADLIST の CvDEPTH 番目のエントリは、スタック フレームである PAD (AV) です。
CV への再帰の深さ。 フレーム AV の 0 番目のスロットは、次の AV です。
@_。 他のエントリは、変数と操作ターゲットのストレージです。

PADNAMELIST を反復すると、すべての可能なパッド項目が反復されます。 パッドスロット
ターゲット (SVs_PADTMP) と GV の場合、最終的には &PL_padname_undef "名前" を持ちますが、
定数のスロットには &PL_padname_const "名前" があります (「名前」を参照) Pad_alloc()）。 それか
&PL_padname_undef と &PL_padname_const が使用されるのは実装の詳細です
変更の予定。 それらをテストするには、「!PadnamePV(name)」と「PadnamePV(name)」を使用します。
&& !PadnameLEN(name)" をそれぞれ指定します。

私/私たちの変数スロットのみが有効な名前を取得します。 残りは操作ターゲット/GV/定数です
これらはコンパイル時に静的に割り当てられるか解決されます。 これらにはありません
実行時に eval"" を通じて Perl コードから検索できる名前。
私/私たちの変数がどのようになれるか。 「名前」だけでは検索できないため、
コンパイル時に割り当てられるインデックス (通常は PL_op->op_targ にあります)、
彼らのためにSVという名前を無駄にするのは意味がありません。

PADNAMELIST 内のパッド名には、変数の名前を保持する PV があります。
COP_SEQ_RANGE_LOW フィールドと _HIGH フィールドは、範囲 (low+1..high を含む) を形成します。
cop_seq 名前が有効な番号。 コンパイル中に、これらのフィールドは
さまざまな段階を示す特別な値 PERL_PADSEQ_INTRO を保持します。

COP_SEQ_RANGE_LOW _HIGH
----- -----
PERL_PADSEQ_INTRO 0 変数はまだ導入されていません:
{ 私の ($x
valid-seq# スコープ内の PERL_PADSEQ_INTRO 変数:
{ 私の ($x)
valid-seq# valid-seq# スコープのコンパイルが完了しました:
{ 私の ($x) }

型付き語彙の場合、PadnameTYPE は型スタッシュを指します。 「私たちの」語彙については、
PadnameOURSTASH は、関連付けられたグローバルのスタッシュを指します (重複する
同じパッケージ内の「our」宣言は検出できます)。 PadnameGEN は時々
コンパイル中に世代番号を保存するために使用されます。

PadnameOUTER がパッド名に設定されている場合、フレーム AV のスロットは
「外部」からの語彙への REFCNT 参照。 このようなエントリは時々あります
「偽物」と呼ばれます。 この場合、名前には「low」と「high」は使用されません。
cop_seq 範囲は全体のスコープ内にあるため、保存します。 代わりに「高い」店
実際の語彙に関する情報を含むいくつかのフラグ (アノンで宣言されているかどうか、および
複数回インスタンス化できるか?)、偽の ANON の場合は「低」
字句の値が格納される親のパッド内のインデックスが含まれます。
クローン作成を迅速化します。

「名前」が「&」の場合、PAD 内の対応するエントリは、
閉鎖の可能性。

フォーマットは anon subs として扱われ、書き込みが行われるたびに複製されることに注意してください。
（必要に応じて）呼び出されます。

フラグ SVs_PADSTALE は、字句上の毎回クリアされます。 僕の（） 実行され、そして
スコープの終了時に設定されます。 これにより、「変数 $x は利用できません」という警告が表示されるようになります。
eval で生成されるもの、たとえば

{ 私の $x = 1; sub f { eval '$x'} } f();

状態変数の場合、SVs_PADSTALE は「まだ初期化されていない」ことを意味するようにオーバーロードされますが、これは
内部状態は別のパッド エントリに保存されます。

PADLIST * CvPADLIST(CV *cv)

パドアレイ
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド エントリの C 配列。

SV ** PadARRAY(PADパッド)

パッドリストARRAY
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッドを含むパッドリストの C 配列。 添え字に数字のみを付けます >=
1。0 番目のエントリは引き続き使用できることが保証されていないためです。

PAD ** PadlistARRAY(PADLIST パッドリスト)

パッドリストMAX
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッドリスト内で最後に割り当てられたスペースのインデックス。 最後のパッドは、
前のスロットにあること。 その場合、これに続くエントリはすべて NULL になります。

SSize_t PadlistMAX(PADLIST パッドリスト)

パッドリストNAMES
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッドエントリに関連付けられた名前。

PADNAMELIST * PadlistNAMES(PADLIST パッドリスト)

パッドリストNAMESARRAY
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名の C 配列。

PADNAME ** PadlistNAMESARRAY(PADLIST パッドリスト)

パッドリストNAMESMAX
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

最後のパッド名のインデックス。

SSize_t PadlistNAMESMAX(PADLIST パッドリスト)

パッドリストREFCNT
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッドリストの参照カウント。 現在、これは常に 1 です。

U32 パッドリストREFCNT(PADLIST パッドリスト)

PadMAX 注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

最後のパッドエントリのインデックス。

SSize_t PadMAX(PADパッド)

パッドネームLEN
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

名前の長さ。

STRLEN パッド名 LEN(PADNAME pn)

padnamelistARRAY
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名の C 配列。

PADNAME ** PadnamelistARRAY(PADNAMELIST pnl)

パッドネームリストMAX
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

最後のパッド名のインデックス。

SSize_t PadnamelistMAX(PADNAMELIST pnl)

パッドネームリストREFCNT
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名リストの参照数。

SSize_t パッド名リストREFCNT(PADNAMELIST pnl)

パッドネームリストREFCNT_dec
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名リストの参照カウントを減らします。

void PadnamelistREFCNT_dec(PADNAMELIST pnl)

パッドネームPV
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名構造体に保存されている名前。 これにより、ターゲット スロットに対して NULL が返されます。

char * PadnamePV(PADNAME pn)

パッドネームREFCNT
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名の参照カウント。

SSize_t パッド名REFCNT(PADNAME pn)

パッド名REFCNT_dec
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名の参照カウントを減らします。

void PadnameREFCNT_dec(PADNAME pn)

パッドネームSV
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名をモータル SV として返します。

SV * パッド名SV(PADNAME pn)

パッド名UTF8
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

PadnamePV が UTF8 であるかどうか。 現時点では、これは常に当てはまります。

bool パッド名UTF8(PADNAME pn)

パッド追加名_pvs
「pad_add_name_pvn」とまったく同じですが、文字列の代わりにリテラル文字列を受け取ります。
文字列/長さのペア。

PADOFFSET Pad_add_name_pvs(const char *name、U32 フラグ、
HV *typestash、HV *ourstash)

Pad_findmy_pvs
「pad_findmy_pvn」とまったく同じですが、文字列の代わりにリテラル文字列を受け取ります。
文字列/長さのペア。

PADOFFSET Pad_findmy_pvs(const char *name、U32 フラグ)

Pad_new 新しいパッドリストを作成し、現在コンパイル中のパッドリストのグローバル変数を更新します。
新しいパッドリストを指すpadlist。 次のフラグは OR 演算できます。

Padnew_CLONE このパッドはクローンされた CV 用です
Padnew_SAVE 古いグローバルを保存スタックに保存します
Padnew_SAVESUB もサブの開始時に追加のものを保存します

PADLIST * Pad_new(int flags)

PL_comppad
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

コンパイル中、これはパッドの値部分を含む配列を指します。
現在コンパイル中のコードの場合。 (実行時、CV にはそのような値が多数含まれる可能性があります
配列; コンパイル時には XNUMX つだけが構築されます。) 実行時には、これは
現在のパッドの現在関連する値を含む配列
コードを実行しています。

PL_comppad_name
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

コンパイル中、これはパッドの名前部分を含む配列を指します。
現在コンパイル中のコードの場合。

PL_カーパッド
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

「PL_comppad」配列の本体を直接指します。 (つまり、これは
「PAD_ARRAY(PL_comppad)」。)

通訳者ごと Variables

PL_modglobal
「PL_modglobal」は、拡張機能で使用される汎用のインタープリター グローバル HV です。
インタプリタごとに情報を保持する必要がある。 いざというときは、
拡張機能が相互にデータを共有するためのシンボル テーブルとして使用できます。 それは
を所有する拡張機能のパッケージ名を先頭に付けたキーを使用することをお勧めします。
データ。

HV* PL_modglobal

PL_na 気にしない場合に通常「SvPV」とともに使用される便利な変数
紐の長さについて。 通常は、次のいずれかを宣言する方が効率的です。
ローカル変数を使用し、代わりにそれを使用するか、「SvPV_nolen」マクロを使用します。

STRLEN PL_na

PL_opfreehook
「NULL」以外の場合、この変数が指す関数は、関数が呼び出されるたびに呼び出されます。
OP は、対応する OP を引数として使用して解放されます。 これにより、拡張機能で次のことが可能になります。
OP にローカルにアタッチされている余分な属性を解放します。 それも保証されています
最初に親OPに対して発火し、次にその子に対して発火します。

この変数を置き換えるときは、
おそらく以前にインストールされたフックを自分の内部で呼び出した可能性があります。

Perl_ophook_t PL_opfreehook

PLピープ
サブルーチンごとのピープホール オプティマイザーへのポインター。 これは取得する関数です
Perl サブルーチン (または同等の独立した) のコンパイルの最後に呼び出されます。
Perl コードの一部）を使用して、いくつかの操作の修正を実行し、小規模な実行を実行します。
最適化。 この関数は、コンパイルされるサブルーチンごとに XNUMX 回呼び出されます。
そして、唯一のパラメータとして、エントリ ポイントである op へのポインタが渡されます。
サブルーチン。 op ツリーをその場で変更します。

のぞき穴オプティマイザーを完全に交換しないでください。 むしろ、コードを追加してください
既存のオプティマイザをラップすることで実現します。 これを行う基本的な方法は次のとおりです。
perlguts の「コンパイル パス 3: のぞき穴の最適化」。 新しいコードが希望する場合は、
上部だけでなく、サブルーチンの構造全体で ops を操作します。
レベルでは、「PL_rpeepp」フックをラップする方が便利である可能性があります。

ピープ_t PL_ピープ

PL_rpeep
再帰的なのぞき穴オプティマイザーへのポインター。 これは呼び出される関数です
Perl サブルーチン (または同等の独立した部分) のコンパイルの終了時
Perl コードの) いくつかの操作の修正を実行し、小規模な実行を実行します。
最適化。 この関数は、リンクされた操作のチェーンごとに XNUMX 回呼び出されます。
「op_next」フィールド。 各サイドチェーンを処理するために再帰的に呼び出されます。 それは
唯一のパラメータとして、チェーンの先頭にある操作へのポインタを渡します。
op ツリーをその場で変更します。

のぞき穴オプティマイザーを完全に交換しないでください。 むしろ、コードを追加してください
既存のオプティマイザをラップすることで実現します。 これを行う基本的な方法は次のとおりです。
perlguts の「コンパイル パス 3: のぞき穴の最適化」。 新しいコードが希望する場合は、
サブルーチン全体ではなく、サブルーチンのトップレベルの操作のみを操作します。
構造上、「PL_peepp」フックをラップするほうが便利と思われます。

peep_t PL_rpeepp

PL_sv_no
これは「偽の」SV です。 「PL_sv_yes」を参照してください。 これを常に &PL_sv_no として参照してください。

SV PL_sv_no

PL_sv_undef
これは「undef」SVです。 これを常に &PL_sv_undef として参照してください。

SV PL_sv_undef

PL_sv_はい
これが「真の」SVです。 「PL_sv_no」を参照してください。 これを常に &PL_sv_yes として参照してください。

SV PL_sv_はい

REGEXP 機能

SvRX SV から REGEXP を取得するための便利なマクロ。 これはほぼ同等です
次のスニペットに:

if (SvMAGICAL(sv))
mg_get(sv);
if (SvROK(sv))
sv = MUTABLE_SV(SvRV(sv));
if (SvTYPE(sv) == SVt_REGEXP)
(REGEXP*) sv を返します。

REGEXP* が見つからない場合は、NULL が返されます。

REGEXP * SvRX(SV *sv)

SvRXOK SV (またはそれが参照する SV) が SV かどうかを示すブール値を返します。
正規表現。

後で REGEXP* を使用して何かをしたい場合は、代わりに SvRX を使用して、
ヌル。

bool SvRXOK(SV* sv)

スタック 操作 マクロ

dMARK XSUB のスタック マーカー変数「mark」を宣言します。 「マーク」と
「ドリマーク」。

dマーク;

ドリマーク
XSUB の元のスタック マークを保存します。 「オリマーク」を参照してください。

ドリグマーク;

dSP 「SP」経由で利用可能な、XSUB の Perl のスタック ポインタのローカル コピーを宣言します。
大きい。 「SP」を参照してください。

dSP;

EXTEND XSUB の戻り値の引数スタックを拡張するために使用されます。 一度使用すると、
少なくとも「nitems」をスタックにプッシュする余地があることを保証します。

void EXTEND(SP, SSize_t niitems)

MARK XSUB のスタック マーカー変数。 「dマーク」を参照してください。

mPUSHi 整数をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。 する
「TARG」は使用しないでください。 「PUSHi」、「mXPUSHi」、および「XPUSHi」も参照してください。

void mPUSHi(IV iv)

mPUSHn double をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。 する
「TARG」は使用しないでください。 「PUSHn」、「mXPUSHn」、および「XPUSHn」も参照してください。

void mPUSHn(NV nv)

mPUSHp 文字列をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。 の
「len」は文字列の長さを示します。 「TARG」は使用しません。 「PUSHp」も参照してください。
「mXPUSHp」と「XPUSHp」。

void mPUSHp(char* str, STRLEN len)

mPUSH SV をスタックにプッシュし、SV を消滅させます。 スタックには次のスペースが必要です
この要素。 「TARG」は使用しません。 「PUSH」および「mXPUSH」も参照してください。

void mPUSHs(SV* sv)

mPUSHu 符号なし整数をスタックにプッシュします。 スタックにはこれのためのスペースが必要です
要素。 「TARG」は使用しません。 「PUSHu」、「mXPUSHu」、および「XPUSHu」も参照してください。

void mPUSHu(UV uv)

mXPUSHi 整数をスタックにプッシュし、必要に応じてスタックを拡張します。 使用しません
「ターグ」。 「XPUSHi」、「mPUSHi」、および「PUSHi」も参照してください。

void mXPUSHi(IV iv)

mXPUSHn double をスタックにプッシュし、必要に応じてスタックを拡張します。 使用しません
「ターグ」。 「XPUSHn」、「mPUSHn」、および「PUSHn」も参照してください。

void mXPUSHn(NV nv)

mXPUSHp 文字列をスタックにプッシュし、必要に応じてスタックを拡張します。 「レン」
文字列の長さを示します。 「TARG」は使用しません。 「XPUSHp」も参照してください。
「mPUSHp」と「PUSHp」。

void mXPUSHp(char* str, STRLEN len)

mXPUSHs SV をスタックにプッシュし、必要に応じてスタックを拡張し、SV を消滅させます。
「TARG」は使用しません。 「XPUSH」と「mPUSH」も参照してください。

void mXPUSHs(SV* sv)

mXPUSHu 符号なし整数をスタックにプッシュし、必要に応じてスタックを拡張します。 する
「TARG」は使用しないでください。 「XPUSHu」、「mPUSHu」、および「PUSHu」も参照してください。

void mXPUSHu(UV uv)

オリグマーク
XSUB の元のスタック マーク。 「ドリマーク」を参照。

POPi スタックから整数をポップします。

IV POPi

POPl ロングをスタックからポップします。

長いPOPXNUMX

POPn スタックからダブルをポップします。

NV POPn

POPp スタックから文字列をポップします。

char* POPp

ポップバイトテックス
バイト、つまり 256 未満の文字で構成される文字列をスタックからポップします。

char* POPpbytex

POPpx スタックから文字列をポップします。 POPpと同じ。 二つの名前がありますが、
歴史的な理由。

char* POPpx

POP スタックから SV をポップします。

SV* POP

PUSHi 整数をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。
「セット」マジックを扱います。 「TARG」を使用するため、「dTARGET」または「dXSTARG」を呼び出す必要があります。
それを宣言します。 リストを返すために複数の「TARG」指向のマクロを呼び出さないでください。
XSUB - 代わりに「mPUSHi」を参照してください。 「XPUSHi」および「mXPUSHi」も参照してください。

void PUSHi(IV iv)

プッシュマーク
コールバックの引数の左括弧。 「PUTBACK」と perlcall を参照してください。

void PUSHMARK(SP)

PUSHモータル
新しいモータル SV をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。
「TARG」は使用しません。 「PUSH」、「XPUSHmortal」、および「XPUSH」も参照してください。

void PUSHmortal()

PUSHn ダブルをスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。 ハンドル
「セット」マジック。 「TARG」を使用するため、「dTARGET」または「dXSTARG」を呼び出して宣言する必要があります
それ。 XSUB からリストを返すために複数の「TARG」指向のマクロを呼び出さないでください - を参照してください。
代わりに「mPUSHn」を使用します。 「XPUSHn」および「mXPUSHn」も参照してください。

void PUSHn(NV nv)

PUSHp 文字列をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。 の
「len」は文字列の長さを示します。 「セット」マジックを扱います。 「TARG」を使用しているため、
「dTARGET」または「dXSTARG」を呼び出して宣言する必要があります。 複数電話しないでください
XSUB からリストを返す「TARG」指向のマクロ - 代わりに「mPUSHp」を参照してください。 見る
「XPUSHp」と「mXPUSHp」も。

void PUSHp(char* str, STRLEN len)

PUSH SV をスタックにプッシュします。 スタックにはこの要素用のスペースが必要です。 ではない
「セット」マジックを処理します。 「TARG」は使用しません。 「PUSHmortal」、「XPUSH」、および「XPUSH」も参照してください。
「XPUSHモータル」。

void PUSH(SV* sv)

PUSHu 符号なし整数をスタックにプッシュします。 スタックにはこれのためのスペースが必要です
要素。 「セット」マジックを扱います。 「TARG」を使用するため、「dTARGET」または「dXSTARG」を使用する必要があります。
それを宣言するために呼ばれました。 リストを返すために複数の「TARG」指向のマクロを呼び出さないでください。
XSUB から - 代わりに「mPUSHu」を参照してください。 「XPUSHu」および「mXPUSHu」も参照してください。

void PUSHu(UV uv)

PUTBACK XSUB 引数の閉じ括弧。 これは通常「xsubpp」によって処理されます。 見る
「PUSHMARK」および他の用途の perlcall。

戻す;

SP スタック ポインタ。 これは通常「xsubpp」によって処理されます。 「dSP」および「SPAGAIN」を参照してください。

SPAGAIN スタック ポインタを再フェッチします。 コールバックの後に使用されます。 「perlcall」を参照してください。

スパガイン;

XPUSHi 整数をスタックにプッシュし、必要に応じてスタックを拡張します。 ハンドル「セット」
魔法。 「TARG」を使用するため、「dTARGET」または「dXSTARG」を呼び出して宣言する必要があります。 する
XSUB からリストを返すために複数の「TARG」指向のマクロを呼び出さない - を参照してください。
代わりに「mXPUSHi」を使用します。 「PUSHi」および「mPUSHi」も参照してください。

void XPUSHi(IV iv)

XPUSHモータル
新しい定命の SV をスタックにプッシュし、必要に応じてスタックを拡張します。 ではない
「TARG」を使用します。 「XPUSH」、「PUSHmortal」、および「PUSH」も参照してください。

void XPUSHmortal()

XPUSHn double をスタックにプッシュし、必要に応じてスタックを拡張します。 ハンドル「セット」
魔法。 「TARG」を使用するため、「dTARGET」または「dXSTARG」を呼び出して宣言する必要があります。 する
XSUB からリストを返すために複数の「TARG」指向のマクロを呼び出さない - を参照してください。
代わりに「mXPUSHn」を使用します。 「PUSHn」および「mPUSHn」も参照してください。

void XPUSHn(NV nv)

XPUSHp 文字列をスタックにプッシュし、必要に応じてスタックを拡張します。 「レン」
文字列の長さを示します。 「セット」マジックを扱います。 「TARG」を使用しているため、
「dTARGET」または「dXSTARG」を呼び出して宣言する必要があります。 複数電話しないでください
XSUB からリストを返す「TARG」指向のマクロ - 代わりに「mXPUSHp」を参照してください。 見る
「PUSHp」と「mPUSHp」も。

void XPUSHp(char* str, STRLEN len)

XPUSH SV をスタックにプッシュし、必要に応じてスタックを拡張します。 取り扱いません
「セット」マジック。 「TARG」は使用しません。 「XPUSHmortal」、「PUSH」、および「XPUSHmortal」も参照してください。
「PUSHモータル」。

void XPUSHs(SV* sv)

XPUSHu 符号なし整数をスタックにプッシュし、必要に応じてスタックを拡張します。
「セット」マジックを扱います。 「TARG」を使用するため、「dTARGET」または「dXSTARG」を呼び出す必要があります。
それを宣言します。 リストを返すために複数の「TARG」指向のマクロを呼び出さないでください。
XSUB - 代わりに「mXPUSHu」を参照してください。 「PUSHu」および「mPUSHu」も参照してください。

void XPUSHu(UV uv)

XSRETURN
XSUB から返され、スタック上の項目の数を示します。 これは通常、
「xsubpp」によって処理されます。

void XSRETURN(int niitems)

XSRETURN_EMPTY
XSUB から空のリストをすぐに返します。

XSRETURN_EMPTY;

XSRETURN_IV
XSUB からすぐに整数を返します。 「XST_mIV」を使用します。

void XSRETURN_IV(IV iv)

XSRETURN_NO
XSUB からすぐに &PL_sv_no を返します。 「XST_mNO」を使用します。

XSRETURN_NO;

XSRETURN_NV
XSUB から double をすぐに返します。 「XST_mNV」を使用します。

void XSRETURN_NV(NV nv)

XSRETURN_PV
XSUB から文字列のコピーをすぐに返します。 「XST_mPV」を使用します。

void XSRETURN_PV(char* str)

XSRETURN_UNDEF
XSUB からすぐに &PL_sv_undef を返します。 「XST_mUNDEF」を使用します。

XSRETURN_UNDEF;

XSRETURN_UV
XSUB からすぐに整数を返します。 「XST_mUV」を使用します。

void XSRETURN_UV(IV uv)

XSRETURN_YES
XSUB からただちに &PL_sv_yes を返します。 「XST_mYES」を使用します。

XSRETURN_YES;

XST_mIV スタック上の指定された位置「pos」に整数を配置します。 値は
新しい致命的な SV に保存されます。

void XST_mIV(int pos, IV iv)

XST_mNO &PL_sv_no をスタック上の指定された位置「pos」に配置します。

void XST_mNO(int pos)

XST_mNV スタック上の指定された位置「pos」に double を配置します。 値は
新しい致命的な SV に保存されます。

void XST_mNV(int pos, NV nv)

XST_mPV 文字列のコピーをスタック上の指定された位置「pos」に配置します。 の
値は新しい最終 SV に保存されます。

void XST_mPV(int pos, char* str)

XST_mUNDEF
&PL_sv_undef をスタック上の指定された位置「pos」に配置します。

void XST_mUNDEF(int pos)

XST_mはい
&PL_sv_yes をスタック上の指定された位置「pos」に配置します。

void XST_mYES(int pos)

SV フラグ

svtype Perl タイプのフラグの列挙。 これらはファイル内にあります SV.H 「svtype」で
列挙型。 これらのフラグを「SvTYPE」マクロでテストします。

タイプは次のとおりです。

SVt_NULL
SVt_IV
SVt_NV
SVt_RV
SVt_PV
SVt_PVIV
SVt_PVNV
SVt_PVMG
SVt_INVLIST
SVt_REGEXP
SVt_PVGV
SVt_PVLV
SVt_PVAV
SVt_PVHV
SVt_PVCV
SVt_PVFM
SVt_PVIO

これらは下から順に説明するのが最も簡単です。

SVt_PVIO は I/O オブジェクト用、SVt_PVFM はフォーマット用、SVt_PVCV はサブルーチン用、
ハッシュの場合は SVt_PVHV、配列の場合は SVt_PVAV。

他のものはすべてスカラー型、つまり「$」にバインドできるものです。
変数。 これらの場合、内部型はほとんどの場合、内部の型と直交します。
パール言語。

したがって、「SvTYPE(sv) < SVt_PVAV」をチェックすることが、何かあるかどうかを確認する最良の方法です。
はスカラーです。

SVt_PVGV はタイプグロブを表します。 !SvFAKE(sv) の場合、それは本物で強制力のないものです。
タイプグロブ。 SvFAKE(sv) の場合、typeglob が適用されたスカラーです。
割り当てられました。 再度代入すると、typeglob ではなくなります。 SVt_PVLV
舞台裏で別のスカラーに委任するスカラーを表します。 それは
たとえば、「substr」の戻り値、結合されたハッシュおよび配列要素に使用されます。
typeglob を含む任意のスカラー値を保持できます。 SVt_REGEXP は通常用です
表現。 SVt_INVLIST は Perl コアの内部使用のみを目的としています。

SVt_PVMG は「通常の」スカラー (typeglob、正規表現、または
代表）。 ほとんどのスカラーは PVMG のすべての内部フィールドを必要としないため、
可能な場合はより小さな構造体を割り当ててメモリを節約します。 他のタイプはすべて、
内部フィールドが少なく、単純な形式の SVt_PVMG です。
SVt_NULL は undef のみを保持できます。 SVt_IV は、undef、整数、または参照を保持できます。
(SVt_RV は、下位互換性のために存在する SVt_IV のエイリアスです。) SVt_NV
これらのいずれか、または double を保持できます。 SVt_PV は undef または文字列のみを保持できます。
SVt_PVIV は、SVt_PV と SVt_IV のスーパーセットです。 SVt_PVNV も同様です。 SVt_PVMG は、
SVt_PVNV が保持できるものはすべて保持しますが、祝福されることはできますが、そうする必要はありません。
魔法の。

SVt_INVLIST
スカラーの型フラグ。 「svtype」を参照してください。

SVt_IV スカラーのタイプ フラグ。 「svtype」を参照してください。

SVt_NULL
スカラーの型フラグ。 「svtype」を参照してください。

SVt_NV スカラーのタイプ フラグ。 「svtype」を参照してください。

SVt_PV スカラーのタイプ フラグ。 「svtype」を参照してください。

SVt_PVAV
配列の型フラグ。 「svtype」を参照してください。

SVt_PVCV
サブルーチンのタイプフラグ。 「svtype」を参照してください。

SVt_PVFM
フォーマットのタイプフラグ。 「svtype」を参照してください。

SVt_PVGV
タイプグロブのタイプフラグ。 「svtype」を参照してください。

SVt_PVHV
ハッシュのタイプフラグ。 「svtype」を参照してください。

SVt_PVIO
I/O オブジェクトのタイプ フラグ。 「svtype」を参照してください。

SVt_PVIV
スカラーの型フラグ。 「svtype」を参照してください。

SVt_PVLV
スカラーの型フラグ。 「svtype」を参照してください。

SVt_PVMG
スカラーの型フラグ。 「svtype」を参照してください。

SVt_PVNV
スカラーの型フラグ。 「svtype」を参照してください。

SVt_REGEXP
正規表現のタイプフラグ。 「svtype」を参照してください。

SV 操作 機能

boolSV 「b」が true 値の場合は true SV を返し、「b」が 0 の場合は false SV を返します。

「PL_sv_yes」および「PL_sv_no」も参照してください。

SV * boolSV(bool b)

croak_xs_usage
xsub の使用法メッセージを出力するための「croak()」の特殊なバリアント

croak_xs_usage(cv、「eee_yow」);

「cv」からパッケージ名とサブルーチン名を計算し、呼び出します。
「鳴く（）」。 したがって、「cv」が &ouch::awk の場合、「croak」は次のように呼び出されます。

Perl_croak(aTHX_ "使用法: %"SVf"::%"SVf"(%s)", "痛い" "awk",
"ええええ");

void croak_xs_usage(const CV *const cv,
const char *const params)

get_sv 指定された Perl スカラーの SV を返します。 「フラグ」は「gv_fetchpv」に渡されます。
「GV_ADD」が設定されており、Perl 変数が存在しない場合は作成されます。
「flags」がゼロで変数が存在しない場合は、NULL が返されます。

注: この関数の perl_ 形式は非推奨です。

SV* get_sv(const char *name, I32 フラグ)

newRV_inc
SV の RV ラッパーを作成します。 元の SV の参照カウントは次のとおりです。
増加しました。

SV* newRV_inc(SV* sv)

新しいSVパッド名
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

パッド名を含む新しい SV を作成します。

SV* newSVpadname(PADNAME *pn)

newSVpvn_utf8
新しい SV を作成し、文字列 (「NUL」 (「\0」) 文字が含まれる場合があります) をコピーします。
そこに。 utf8 が true の場合、新しい SV で「SvUTF8_on」を呼び出します。 として実装されました
「newSVpvn_flags」のラッパー。

SV* newSVpvn_utf8(NULLOK const char* s, STRLEN len,
U32utf8)

SvCUR SV 内の文字列の長さを返します。 「SvLEN」を参照してください。

ストレン SvCUR(SV* sv)

SvCUR_set
SV にある文字列の現在の長さを設定します。 「SvCUR」および
「SvIV_set」。

void SvCUR_set(SV* sv, STRLEN len)

SvEND 文字列の最後の文字の直後の位置へのポインタを返します。
SV では、通常、末尾に「NUL」文字があります (Perl であっても)
スカラーでは厳密には必要ありません)。 「SvCUR」を参照してください。 として文字にアクセスします
*(SvEND(sv))。

警告: 「SvCUR」が「SvLEN」と等しい場合、「SvEND」は未割り当てを指します。
メモリ。

char* SvEND(SV* sv)

SvGAMAGIC
SV が get マジックまたはオーバーロードを持っている場合は true を返します。 どちらかが true の場合、
スカラーはアクティブなデータであり、データが返されるたびに新しい値を返す可能性があります。
にアクセスされます。 したがって、論理ユーザーごとに一度だけ読み取るように注意する必要があります。
操作を実行し、その戻り値を処理します。 どちらも当てはまらない場合、スカラーの
値は書き込まれない限り変更できません。

U32 SvGAMAGIC(SV* sv)

SvGROW SV 内の文字バッファーを拡張して、指定された文字を格納できるスペースを確保します。
バイト数 (追加の末尾「NUL」文字用にスペースを確保することを忘れないでください)。
必要に応じて「sv_grow」を呼び出して展開を実行します。 へのポインタを返します。
文字バッファ。 SV のタイプは SVt_PV 以上である必要があります。 代替手段の XNUMX つは、電話することです
SV のタイプがわからない場合は、「sv_grow」。

char * SvGROW(SV* sv, STRLEN len)

SvIOK SV に整数が含まれているかどうかを示す U32 値を返します。

U32 SvIOK(SV* sv)

SvIOKp SV に整数が含まれているかどうかを示す U32 値を返します。 チェックします
プライベート 設定。 代わりに「SvIOK」を使用してください。

U32 SvIOKp(SV* sv)

SvIOK_notUV
SV に符号付き整数が含まれるかどうかを示すブール値を返します。

bool SvIOK_notUV(SV* sv)

SvIOK_off
SV の IV ステータスの設定を解除します。

void SvIOK_off(SV* sv)

SvIOK_on
SV にそれが整数であることを伝えます。

void SvIOK_on(SV* sv)

SvIOK_only
SV にそれが整数であることを伝え、他のすべての OK ビットを無効にします。

void SvIOK_only(SV* sv)

SvIOK_only_UV
SV にそれが符号なし整数であることを伝え、他のすべての OK ビットを無効にします。

void SvIOK_only_UV(SV* sv)

SvIOK_UV
SV に必須の整数が含まれているかどうかを示すブール値を返します。
署名されていないものとして解釈されます。 値が範囲内にある非負の整数
IV と UV の両方のフラグは、SvUOK または SVIOK として設定できます。

bool SvIOK_UV(SV* sv)

SvIsCOW SV がコピーオンライト (共有ハッシュのいずれか) であるかどうかを示す U32 値を返します。
キー スカラー、または 5.9.0 が COW 用に構成されている場合は完全な Copy On Write スカラー)。

U32 SvIsCOW(SV* sv)

SvIsCOW_shared_hash
SV がコピーオンライト共有ハッシュ キーであるかどうかを示すブール値を返します。
スカラー。

bool SvIsCOW_shared_hash(SV* sv)

SvIV 指定された SV を整数に強制変換して返します。 バージョンについては「SvIVx」を参照してください。
これにより、sv が XNUMX 回だけ評価されることが保証されます。

IV SvIV(SV* sv)

SvIVX チェックや変換を行わずに、SV の IV スロットの生の値を返します。 のみ
SvIOK が true であることが確実な場合に使用してください。 「SvIV()」も参照してください。

IV SvIVX(SV* sv)

SvIVx 指定された SV を整数に強制変換して返します。 「sv」を評価することを保証します
XNUMX回だけ。 「sv」が副作用のある式である場合にのみこれを使用し、それ以外の場合は使用します。
より効率的な「SvIV」を使用してください。

IV SvIVx(SV* sv)

SvIV_nomg
「SvIV」と似ていますが、魔法を処理しません。

IV SvIV_nomg(SV* sv)

SvIV_set
sv の IV ポインタの値を val に設定します。 同じように実行することも可能です
「SvIVX」への左辺値割り当てを使用したこのマクロの関数。 将来の Perls では、
ただし、左辺値の代わりに「SvIV_set」を使用する方が効率的です。
「SvIVX」に割り当てます。

void SvIV_set(SV* sv, IV val)

SvLEN SV 内の文字列バッファのサイズを返します（一部は含まれません）。
「SvOOK」に起因します。 「SvCUR」を参照してください。

ストレン スvLEN(SV* sv)

SvLEN_set
SV に含まれる文字列の実際の長さを設定します。 「SvIV_set」を参照してください。

void SvLEN_set(SV* sv, STRLEN len)

SvMAGIC_set
sv の MAGIC ポインタの値を val に設定します。 「SvIV_set」を参照してください。

void SvMAGIC_set(SV* sv, MAGIC* val)

SvNIOK SV に数値、整数、またはいずれが含まれるかを示す U32 値を返します。
ダブル。

U32 SvNIOK(SV* sv)

SvNIOKp SV に数値、整数、またはいずれが含まれるかを示す U32 値を返します。
ダブル。 チェックします プライベート 設定。 代わりに「SvNIOK」を使用してください。

U32 SvNIOKp(SV* sv)

SvNIOK_off
SV の NV/IV ステータスを設定解除します。

void SvNIOK_off(SV* sv)

SvNOK SV に double が含まれているかどうかを示す U32 値を返します。

U32 SvNOK(SV* sv)

SvNOKp SV に double が含まれているかどうかを示す U32 値を返します。 チェックします
プライベート 設定。 代わりに「SvNOK」を使用してください。

U32 SvNOKp(SV* sv)

SvNOK_off
SV の NV ステータスの設定を解除します。

void SvNOK_off(SV* sv)

SvNOK_on
SV にそれが double であることを伝えます。

void SvNOK_on(SV* sv)

SvNOK_only
SV にそれが double であることを伝え、他のすべての OK ビットを無効にします。

void SvNOK_only(SV* sv)

SvNV 指定された SV を double に強制変換して返します。 バージョンについては「SvNVx」を参照してください。
sv を XNUMX 回だけ評価することを保証します。

NV SvNV(SV* sv)

SvNVX チェックや変換を行わずに、SV の NV スロットの生の値を返します。 のみ
SvNOK が true であることが確実な場合に使用します。 「SvNV()」も参照してください。

NV SvNVX(SV* sv)

SvNVx 指定された SV を double に強制変換して返します。 「sv」のみを評価することを保証します
一度。 「sv」が副作用のある式である場合にのみこれを使用し、それ以外の場合は
より効率的な「SvNV」。

NV SvNVx(SV* sv)

SvNV_nomg
「SvNV」と似ていますが、魔法を処理しません。

NV SvNV_nomg(SV* sv)

SvNV_set
sv の NV ポインタの値を val に設定します。 「SvIV_set」を参照してください。

void SvNV_set(SV* sv, NV val)

SvOK 値が定義されているかどうかを示す U32 値を返します。 これだけです
スカラーにとって意味があります。

U32 SvOK(SV* sv)

SvOOK 文字列バッファへのポインタがオフセットされているかどうかを示す U32 を返します。 これ
ハックは、文字の先頭からの削除を高速化するために内部的に使用されます。
SVPV。 SvOOK が true の場合、割り当てられた文字列バッファの先頭は次のとおりです。
実際には SvPVX よりも「SvOOK_offset()」バイト前です。 このオフセットは以前は次の場所に保存されていました。
SvIVX ですが、現在はバッファの予備部分に格納されています。

U32 SvOOK(SV* sv)

SvOOK_offset
読み込みます LEN SvPVX から割り当てられたファイルの真の開始位置までのオフセット
バッファ。「sv_chop」を使用して効率的に削除した場合はゼロ以外になります。
バッファの先頭からの文字。 マクロとして実装されます。
のアドレス LEN、タイプは「STRLEN」である必要があります。 評価する sv 一回以上。
セット LEN 「SvOOK(sv)」が false の場合は 0 になります。

void SvOOK_offset(NN SV*sv, STRLEN len)

SvPOK SV に文字列が含まれているかどうかを示す U32 値を返します。

U32 SvPOK(SV* sv)

SvPOKp SV に文字列が含まれているかどうかを示す U32 値を返します。 小切手
　 プライベート 設定。 代わりに「SvPOK」を使用してください。

U32 SvPOKp(SV* sv)

SvPOK_off
SV の PV ステータスの設定を解除します。

void SvPOK_off(SV* sv)

SvPOK_on
SV にそれが文字列であることを伝えます。

void SvPOK_on(SV* sv)

SvPOK_only
SV にそれが文字列であることを伝え、他のすべての OK ビットを無効にします。 も回ります
UTF-8ステータスをオフにします。

void SvPOK_only(SV* sv)

SvPOK_only_UTF8
SV にそれが文字列であることを伝え、他のすべての OK ビットを無効にし、
UTF-8の状態のまま。

void SvPOK_only_UTF8(SV* sv)

SvPV SV 内の文字列へのポインタ、または SV の文字列化された形式を返します。
SV には文字列が含まれません。 SV は文字列化されたバージョンをキャッシュする場合があります。
「SvPOK」。 「ゲット」魔法を扱う。 「len」変数は次の長さに設定されます。
文字列 (これはマクロなので、&len は使用しないでください)。 バージョンについては「SvPVx」も参照してください。
これにより、sv が XNUMX 回だけ評価されることが保証されます。

「SvPV()」の戻り値が以下と等しいという保証はないことに注意してください。
「SvPVX(sv)」、または「SvPVX(sv)」に有効なデータが含まれていること、または連続した呼び出し
「SvPV(sv)」は毎回同じポインタ値を返します。 これはやり方によるものです
オーバーロードやコピーオンライトなどが処理されること。 このような場合、
戻り値は一時バッファなどを指す場合があります。 どうしても必要な場合は
SvPVX フィールドを有効にする (たとえば、そこに書き込む場合) を参照してください。
「SvPV_force」。

char* SvPV(SV* sv, STRLEN len)

SvPVバイト
「SvPV」と似ていますが、必要に応じて sv を最初にバイト表現に変換します。

char* SvPVbyte(SV* sv, STRLEN len)

SvPVbytex
「SvPV」と似ていますが、必要に応じて sv を最初にバイト表現に変換します。
sv を XNUMX 回だけ評価することを保証します。 それ以外の場合は、より効率的な「SvPVbyte」を使用してください。

char* SvPVbytex(SV* sv, STRLEN len)

SvPVbytex_force
「SvPV_force」と似ていますが、必要に応じて最初に sv をバイト表現に変換します。
sv を XNUMX 回だけ評価することを保証します。 より効率的な「SvPVbyte_force」を使用してください
さもないと。

char* SvPVbytex_force(SV* sv, STRLEN len)

SvPVbyte_force
「SvPV_force」と似ていますが、必要に応じて最初に sv をバイト表現に変換します。

char* SvPVbyte_force(SV* sv, STRLEN len)

SvPVbyte_nolen
「SvPV_nolen」と似ていますが、必要に応じて最初に sv をバイト表現に変換します。

char* SvPVbyte_nolen(SV* sv)

SvPVutf8
「SvPV」と似ていますが、必要に応じて最初に sv を utf8 に変換します。

char* SvPVutf8(SV* sv, STRLEN len)

SvPVutf8x
「SvPV」と似ていますが、必要に応じて最初に sv を utf8 に変換します。 評価の保証
SV は 8 回だけです。 それ以外の場合は、より効率的な「SvPVutfXNUMX」を使用してください。

char* SvPVutf8x(SV* sv, STRLEN len)

SvPVutf8x_force
「SvPV_force」と似ていますが、必要に応じて最初に sv を utf8 に変換します。 を保証します
sv を 8 回だけ評価します。 それ以外の場合は、より効率的な「SvPVutfXNUMX_force」を使用してください。

char* SvPVutf8x_force(SV* sv, STRLEN len)

SvPVutf8_force
「SvPV_force」と似ていますが、必要に応じて最初に sv を utf8 に変換します。

char* SvPVutf8_force(SV* sv, STRLEN len)

SvPVutf8_nolen
「SvPV_nolen」と似ていますが、必要に応じて最初に sv を utf8 に変換します。

char* SvPVutf8_nolen(SV* sv)

SvPVX SV 内の物理文字列へのポインタを返します。 SV には文字列が含まれている必要があります。
5.9.3 より前では、SV のタイプが >= でない限り、このマクロを実行するのは安全ではありません。
SVt_PV。

これは、自動ロードされるサブルーチンの名前を XS AUTOLOAD に保存するためにも使用されます。
ルーティーン。 perlguts の「XSUB による自動ロード」を参照してください。

char* SvPVX(SV* sv)

SvPVx 「sv」を XNUMX 回だけ評価することを保証する「SvPV」のバージョン。 以下の場合にのみこれを使用してください
「sv」は副作用のある式です。それ以外の場合は、より効率的な「SvPV」を使用してください。

char* SvPVx(SV* sv, STRLEN len)

SvPV_力
「SvPV」と似ていますが、SV に文字列 (「SvPOK」) のみを強制的に含めます。
文字列 (「SvPOK_only」)、フックまたは詐欺師によって。 やるなら力が必要だ
「SvPVX」を直接更新してください。 プロセスには魔法がかかります。

任意のスカラーをプレーン PV に強制すると、潜在的にストリップされる可能性があることに注意してください。
そこから得られる有用なデータ。 たとえば、SV が「SvROK」の場合、参照先は次のようになります。
参照カウントがデクリメントされ、SV 自体が
" などの値を含む文字列バッファを持つ "SvPOK" スカラーアレイ(0x1234)」。

char* SvPV_force(SV* sv, STRLEN len)

SvPV_force_nomg
「SvPV_force」と似ていますが、get マジックを処理しません。

char* SvPV_force_nomg(SV* sv, STRLEN len)

SvPV_nolen
「SvPV」と似ていますが、長さ変数を設定しません。

char* SvPV_nolen(SV* sv)

SvPV_nomg
「SvPV」と似ていますが、魔法を処理しません。

char* SvPV_nomg(SV* sv, STRLEN len)

SvPV_nomg_nolen
「SvPV_nolen」と似ていますが、魔法を処理しません。

char* SvPV_nomg_nolen(SV* sv)

SvPV_set
おそらくこれはあなたが使いたいものではなく、おそらく「sv_usepvn_flags」が欲しかったのでしょう。
または「sv_setpvn」または「sv_setpvs」。

"sv" 内の PV ポインタの値を、Perl で割り当てられた "NUL" で終了するポインタに設定します。
文字列「val」。 「SvIV_set」も参照してください。

以前の PV バッファを忘れずに解放してください。 確認すべきことがたくさんあります。 気をつけてください
既存のポインタがコピーオンライトまたはその他の不正行為に関与している可能性があるため、
「SvOOK_off(sv)」を実行し、「sv_force_normal」または「SvPV_force」を使用します（または SvIsCOW を確認します）
flag) を使用して、まずこの変更が安全であることを確認します。 そして最後に、そうでない場合は、
COW、「SvPV_free」を呼び出して、前の PV バッファを解放します。

void SvPV_set(SV* sv, char* val)

SvREFCNT
オブジェクトの参照カウントの値を返します。

U32 SvREFCNT(SV* sv)

SvREFCNT_dec
指定された SV の参照カウントをデクリメントします。 sv NULL の場合もあります。

void SvREFCNT_dec(SV* sv)

SvREFCNT_dec_NN
SvREFCNT_dec と同じですが、知っている場合にのみ使用できます。 sv は NULL ではありません。 私たち以来
NULL かどうかをチェックする必要がなく、より高速で小さいです。

void SvREFCNT_dec_NN(SV* sv)

SvREFCNT_inc
指定された SV の参照カウントをインクリメントし、SV を返します。

次の SvREFCNT_inc* マクロはすべて、SvREFCNT_inc の最適化されたバージョンです。
SvREFCNT_inc に置き換えることができます。

SV* SvREFCNT_inc(SV* sv)

SvREFCNT_inc_NN
SvREFCNT_inc と同じですが、知っている場合にのみ使用できます。 sv は NULL ではありません。 私たち以来
NULL かどうかをチェックする必要がなく、より高速で小さいです。

SV* SvREFCNT_inc_NN(SV* sv)

SvREFCNT_inc_simple
SvREFCNT_inc と同じですが、副作用のない式でのみ使用できます。
一時的な値を保存する必要がないため、処理が高速になります。

SV* SvREFCNT_inc_simple(SV* sv)

SvREFCNT_inc_simple_NN
SvREFCNT_inc_simple と同じですが、知っている場合にのみ使用できます。 sv は NULL ではありません。
NULL かどうかをチェックする必要がないため、高速かつサイズが小さくなります。

SV* SvREFCNT_inc_simple_NN(SV* sv)

SvREFCNT_inc_simple_void
SvREFCNT_inc_simple と同じですが、リターンが必要ない場合にのみ使用できます。
価値。マクロは意味のある値を返す必要はありません。

void SvREFCNT_inc_simple_void(SV* sv)

SvREFCNT_inc_simple_void_NN
SvREFCNT_inc と同じですが、戻り値が必要ない場合にのみ使用できます。
あなたはそれを知っています sv は NULL ではありません。マクロは意味のある値を返す必要はありません
値を変更するか、NULL かどうかをチェックして、より小さく高速になります。

void SvREFCNT_inc_simple_void_NN(SV* sv)

SvREFCNT_inc_void
SvREFCNT_inc と同じですが、戻り値が必要ない場合にのみ使用できます。
マクロは意味のある値を返す必要はありません。

void SvREFCNT_inc_void(SV* sv)

SvREFCNT_inc_void_NN
SvREFCNT_inc と同じですが、戻り値が必要ない場合にのみ使用できます。
あなたはそれを知っています sv は NULL ではありません。マクロは意味のある値を返す必要はありません
値を変更するか、NULL かどうかをチェックして、より小さく高速になります。

void SvREFCNT_inc_void_NN(SV* sv)

SvROK SV が RV であるかどうかをテストします。

U32 SvROK(SV* sv)

SvROK_off
SV の RV ステータスの設定を解除します。

void SvROK_off(SV* sv)

SvROK_on
SV に RV であることを伝えます。

void SvROK_on(SV* sv)

SvRV RV を逆参照して SV を返します。

SV* SvRV(SV* sv)

SvRV_set
sv の RV ポインタの値を val に設定します。 「SvIV_set」を参照してください。

void SvRV_set(SV* sv, SV* val)

SvSTASH SV のスタッシュを返します。

HV* SvSTASH(SV* sv)

SvSTASH_set
sv の STASH ポインタの値を val に設定します。 「SvIV_set」を参照してください。

void SvSTASH_set(SV* sv, HV* val)

SvTAINT 汚染が有効であり、現在の式に何らかの入力があった場合に SV を汚染します。
汚染されています -- 通常は変数ですが、ロケールなどの暗黙的な入力も汚染されている可能性があります
設定。 「SvTAINT」は、その汚染を式の出力に伝播します。
悲観的なやり方で。つまり、正確にどれであるかに注意を払うことなく、
出力はどの入力の影響を受けるか。

void SvTAINT(SV* sv)

SVTAINTED
SV が汚染されているかどうかを確認します。存在する場合は TRUE を返し、そうでない場合は FALSE を返します。

bool SvTAINTED(SV* sv)

SvTAINTED_off
SV の汚れを取り除きます。なれ 非常に このルーチンでは一部の回路が短絡するため注意してください。
Perl の基本的なセキュリティ機能。 XS モジュールの作成者はこれを使用しないでください
無条件の意味をすべて完全に理解しない限り機能しません。
価値を汚さないこと。汚染の解除は、標準の Perl の方法で行う必要があります。
変数を直接汚染しないのではなく、注意深く作成された正規表現です。

void SvTAINTED_off(SV* sv)

SvTAINTED_on
汚染が有効な場合、SV を汚染済みとしてマークします。

void SvTAINTED_on(SV* sv)

SvTRUE Perl が SV を true として評価するか false として評価するかを示すブール値を返します。
見る SvOK() 定義済み/未定義のテスト用。スカラーがそうでない場合を除き、「get」マジックを処理します。
すでに SvPOK、SvIOK、または SvNOK (プライベート フラグではなくパブリック フラグ)。

bool SvTRUE(SV* sv)

SvTRUE_nomg
Perl が SV を true として評価するか false として評価するかを示すブール値を返します。
見る SvOK() 定義済み/未定義のテスト用。 「get」魔法は扱いません。

bool SvTRUE_nomg(SV* sv)

SvTYPE SV のタイプを返します。 「svtype」を参照してください。

svtype SvTYPE(SV* sv)

SvUOK SV に必須の整数が含まれているかどうかを示すブール値を返します。
署名されていないものとして解釈されます。 値が範囲内にある非負の整数
IV と UV の両方のフラグは、SvUOK または SVIOK として設定できます。

bool SvUOK(SV* sv)

SvUPGRADE
SV をより複雑な形式にアップグレードするために使用されます。 「sv_upgrade」を使用して、
必要に応じてアップグレードします。 「svtype」を参照してください。

void SvUPGRADE(SV* sv, svtype タイプ)

SvUTF8 SV の UTF-32 ステータスを示す U8 値を返します。物事がセットアップされている場合
正しくは、これは SV に UTF-8 エンコードされたデータが含まれているかどうかを示します。あなた
これを使うべきです After への電話 SvPV（） またはそのバリアントの 1 つ（呼び出しがあった場合）
文字列のオーバーロードは内部フラグを更新します。

bytes プラグマを考慮する場合は、代わりに「DO_UTF8」を使用してください。

U32 SvUTF8(SV* sv)

SvUTF8_off
SV の UTF-8 ステータスを設定解除します (データは変更されず、フラグのみが変更されます)。しないでください
軽薄に使う。

void SvUTF8_off(SV *sv)

SvUTF8_on
SV の UTF-8 ステータスをオンにします (データは変更されず、フラグのみが変更されます)。する
軽率に使用しないでください。

void SvUTF8_on(SV *sv)

SvUV 指定された SV を符号なし整数に強制変換して返します。詳細については、「SvUVx」を参照してください。
sv を 1 回だけ評価することを保証するバージョン。

UV SvUV(SV* sv)

SvUVX チェックや変換を行わずに、SV の UV スロットの生の値を返します。のみ
SvIOK が true であることが確実な場合に使用してください。 「SvUV()」も参照してください。

UV SvUVX(SV* sv)

SvUVx 指定された SV を符号なし整数に強制変換して返します。を保証します
「sv」は 1 回だけ評価します。 「sv」がサイド付きの式である場合にのみこれを使用します。
それ以外の場合は、より効率的な「SvUV」を使用してください。

UV SvUVx(SV* sv)

SvUV_nomg
「SvUV」に似ていますが、魔法を処理しません。

UV SvUV_nomg(SV* sv)

SvUV_set
sv の UV ポインタの値を val に設定します。 「SvIV_set」を参照してください。

void SvUV_set(SV* sv, UV val)

SvVOK SV に v-string が含まれているかどうかを示すブール値を返します。

bool SvVOK(SV* sv)

sv_catpvn_nomg
「sv_catpvn」と似ていますが、魔法を処理しません。

void sv_catpvn_nomg(SV* sv, const char* ptr,
STRLENレン）

sv_catpv_nomg
「sv_catpv」と似ていますが、魔法を処理しません。

void sv_catpv_nomg(SV* sv, const char* ptr)

sv_catsv_nomg
「sv_catsv」と似ていますが、魔法を処理しません。

void sv_catsv_nomg(SV* dsv, SV* ssv)

sv_derived_from
「sv_derived_from_pv」とまったく同じですが、「flags」パラメータを取りません。

bool sv_derived_from(SV* sv, const char *const 名)

sv_derived_from_pv
「sv_derived_from_pvn」とまったく同じですが、文字列の代わりに NULL で終わる文字列を受け取ります。
文字列/長さのペア。

bool sv_derived_from_pv(SV* sv,
const char *定数名、
U32 フラグ)

sv_derived_from_pvn
SV が指定されたクラスから派生したかどうかを示すブール値を返します。 at
　 C レベル。 Perl レベルで導出を確認するには、通常の Perl として「isa()」を呼び出します。
方法。

現在、「flags」の唯一の重要な値は SVf_UTF8 です。

bool sv_derived_from_pvn(SV* sv,
const char *定数名、
const STRLEN len、U32 フラグ)

sv_derived_from_sv
「sv_derived_from_pvn」とまったく同じですが、SV の形式で名前文字列を受け取ります。
文字列と長さのペアの代わりに。

bool sv_derived_from_sv(SV* sv, SV *namesv,
U32 フラグ)

sv_does 「sv_does_pv」と似ていますが、「flags」パラメータを取りません。

bool sv_does(SV* sv, const char *const 名)

sv_does_pv
「sv_does_sv」と似ていますが、SV の代わりに NULL で終わる文字列を受け取ります。

bool sv_does_pv(SV* sv, const char *const 名,
U32 フラグ)

sv_does_pvn
「sv_does_sv」と似ていますが、SV の代わりに文字列と長さのペアを受け取ります。

bool sv_does_pvn(SV* sv, const char *const 名,
const STRLEN len、U32 フラグ)

sv_does_sv
SV が特定の名前付きロールを実行するかどうかを示すブール値を返します。の
SV には、Perl オブジェクトまたは Perl クラスの名前を指定できます。

bool sv_does_sv(SV* sv、SV* namesv、U32 フラグ)

sv_report_used
まだ解放されていないすべての SV の内容をダンプします (デバッグ支援)。

void sv_report_used()

sv_setsv_nomg
「sv_setsv」と似ていますが、魔法を処理しません。

void sv_setsv_nomg(SV* dsv, SV* ssv)

sv_utf8_upgrade_nomg
sv_utf8_upgrade と似ていますが、「sv」に対して魔法を実行しません。

STRLEN sv_utf8_upgrade_nomg(NN SV *sv)

SVボディ 割り当て

look_like_number
SV の内容が数値のように見える (または数値である) かどうかをテストします。 「インフ」と
「無限大」は数値として扱われます (したがって、数値以外の警告は発行されません)。
もしあなたの atof() 彼らを不快にさせません。 Get-magic は無視されます。

I32 見た目の数(SV *const sv)

newRV_noinc
SV の RV ラッパーを作成します。 元の SV の参照カウントは次のとおりです。
増加しました。

SV* newRV_noinc(SV *const tmpRef)

newSV 新しいSVを作成します。ゼロ以外の「len」パラメータは、
SV が持つ必要がある事前に割り当てられた文字列スペース。末尾の「NUL」の追加バイト
も予約されています。 (文字列スペースが指定されていても、SV には SvPOK は設定されません)
新しい SV の参照カウントは 1 に設定されます。

5.9.3年には、 newSV() 古いものを置き換えます ニュースSV() API を作成し、最初のパラメータを削除します。
x、呼び出し元が自分自身を識別できるようにするデバッグ補助。この援助は、
新しいビルド オプション PERL_MEM_LOG に置き換えられました (「PERL_MEM_LOG」を参照)
perlhacktips)。 古い API は、XS モジュールで使用するためにまだ存在しています。
古いパール。

SV* newSV(const STRLEN len)

新しいSVhek
ハッシュ キー構造から新しい SV を作成します。それはポイントするスカラーを生成します
可能な場合は共有文字列テーブルにコピーします。次の場合、新しい (未定義) SV を返します。
hek は NULL です。

SV* newSVhek(const HEK *const hek)

newSViv 新しい SV を作成し、そこに整数をコピーします。 SV の参照カウントは次のとおりです。
1に設定します。

SV* newSViv(const IV i)

newSVnv 新しい SV を作成し、そこに浮動小数点値をコピーします。参照カウント
SV は 1 に設定されます。

SV* newSVnv(const NV n)

newSVpv 新しい SV を作成し、文字列 (「NUL」 (「\0」) 文字が含まれる場合があります) をコピーします。
そこに。 SV の参照カウントは 1 に設定されます。「len」が XNUMX の場合、Perl は
を使用して長さを計算します strlen（）, (つまり、このオプションを使用すると、「s」が
「NUL」文字を埋め込むことはできず、終端の「NUL」バイトが必要です）。

効率を高めるために、代わりに「newSVpvn」の使用を検討してください。

SV* newSVpv(const char *const s, const STRLEN len)

新しいSVpvf
新しい SV を作成し、「sprintf」のような形式の文字列で初期化します。

SV* newSVpvf(const char *const pat, ...)

新しいSVpvn
新しい SV を作成し、そこに文字列をコピーします。文字列には「NUL」文字が含まれる場合があります。
("\0") およびその他のバイナリ データ。 SV の参照カウントは 1 に設定されます。
「len」がゼロの場合、Perl は長さ 0 の (Perl) 文字列を作成します。あなたは
ソースバッファが少なくとも「len」バイト長であることを保証する責任があります。もし
「buffer」引数が NULL の場合、新しい SV は未定義になります。

SV* newSVpvn(const char *const s, const STRLEN len)

newSVpvn_flags
新しい SV を作成し、文字列 (「NUL」 (「\0」) 文字が含まれる場合があります) をコピーします。
そこに。 SV の参照カウントは 1 に設定されます。「len」が XNUMX の場合、
Perl は長さ 0 の文字列を作成します。あなたには、次のことを保証する責任があります。
ソース文字列の長さは少なくとも「len」バイトです。 「s」引数が NULL の場合、新しい
SVは不定となります。現在受け入れられるフラグ ビットは「SVf_UTF8」と「SVf_UTFXNUMX」のみです。
「SVs_TEMP」。 「SVs_TEMP」が設定されている場合、結果に対して「sv_2mortal()」が呼び出されます。
戻る前に。 「SVf_UTF8」が設定されている場合、「s」は UTF-8 であるとみなされ、
新しい SV には「SVf_UTF8」フラグが設定されます。 「newSVpvn_utf8()」は便利です
この関数のラッパー。次のように定義されます。

#define newSVpvn_utf8(s, len, u) \
newSVpvn_flags((s), (len), (u) ? SVf_UTF8 : 0)

SV* newSVpvn_flags(const char *const s,
const STRLEN レン、
const U32 フラグ)

newSVpvn_share
文字列内の共有文字列を指す SvPVX_const を使用して新しい SV を作成します
テーブル。文字列がテーブルにまだ存在しない場合は、最初に文字列が作成されます。
SvIsCOW フラグをオンにします (または 5.16 以前では READONLY と FAKE)。もし
「hash」パラメータがゼロ以外の場合は、その値が使用されます。それ以外の場合は、ハッシュが計算されます。
文字列のハッシュは、後で「SvSHARED_HASH()」を使用して SV から取得できます。
大きい。ここでの考え方は、文字列テーブルが共有ハッシュキーに使用されるためです。
これらの文字列には SvPVX_const == HeKEY が含まれ、ハッシュ検索では文字列が回避されます。
比較してください。

SV* newSVpvn_share(const char* s、I32 len、U32 ハッシュ)

新しいSVpv
「newSVpvn」と似ていますが、文字列の代わりにリテラルの「NUL」で終わる文字列を受け取ります。
文字列/長さのペア。

SV* newSVpvs(const char* s)

newSVpvs_flags
「newSVpvn_flags」と似ていますが、文字列の代わりにリテラルの「NUL」で終わる文字列を受け取ります。
文字列/長さのペア。

SV* newSVpvs_flags(const char* s、U32 フラグ)

newSVpvs_share
「newSVpvn_share」と似ていますが、文字列の代わりにリテラルの「NUL」で終わる文字列を受け取ります。
文字列と長さのペアであり、ハッシュ パラメータは省略されます。

SV* newSVpvs_share(const char* s)

newSVpv_share
「newSVpvn_share」と似ていますが、文字列の代わりに「NUL」で終わる文字列を受け取ります。
文字列/長さのペア。

SV* newSVpv_share(const char* s、U32 ハッシュ)

newSVrv 既存の RV「rv」が指す新しい SV を作成します。 「rv」が RV ではない場合
その後、1 にアップグレードされます。 「classname」が null でない場合、新しい SV は次のようになります。
指定されたパッケージで祝福されます。新しい SV とその参照が返されます
count は 1 です。参照カウント 1 は「rv」によって所有されます。

SV* newSVrv(SV *const rv,
const char *const クラス名)

newSVsv 元の SV の正確な複製である新しい SV を作成します。 (用途
「sv_setsv」。)

SV* newSVsv(SV *const old)

newSVuv 新しい SV を作成し、そこに符号なし整数をコピーします。の参照カウント
SV は 1 に設定されます。

SV* newSVuv(const UV u)

新しいSV_type
指定されたタイプの新しい SV を作成します。新しい SV の参照カウントは次のとおりです。
1に設定します。

SV* newSV_type(const svtype タイプ)

sv_2ブール
このマクロを使用できるのは次の場合のみです。 sv_true() またはその同等のマクロであり、
後者の引数は SvPOK、SvIOK、SvNOK のいずれでもありません。 sv_2bool_flags を呼び出します。
SV_GMAGIC フラグ。

bool sv_2bool(SV *const sv)

sv_2bool_flags
この機能を使用できるのは次の場合のみです。 sv_true() と友人、そして後者の場合のみ
引数が SvPOK、SvIOK、SvNOK のいずれでもありません。フラグに SV_GMAGIC が含まれている場合、
それは mg_get（） 最初。

bool sv_2bool_flags(SV *sv、I32 フラグ)

sv_2cv さまざまな戦略を使用して、SV から CV を取得しようとします。さらに、可能であれば次のようにしてください
*st と *gvp をスタッシュとそれに関連付けられた GV に設定します。 「lref」のフラグは次のとおりです。
gv_fetchsv に渡されます。

CV* sv_2cv(SV* sv, HV **const st, GV **const gvp,
const I32 lref)

sv_2io さまざまなガンビットを使用して、SV から IO を取得しようとします。GV の場合は IO スロットです。または
RV の場合は再帰的な結果。または、その名前にちなんで名付けられたシンボルの IO スロット
文字列の場合は PV。

「Get」マジックは渡された SV では無視されますが、SV の場合は「SvRV(sv)」で呼び出されます。
RVです。

IO* sv_2io(SV *const sv)

sv_2iv_flags
必要な文字列変換を行って、SV の整数値を返します。もし
flags には SV_GMAGIC が含まれており、 mg_get（） 初め。通常は次の方法で使用されます。
「SvIV(sv)」および「SvIVx(sv)」マクロ。

IV sv_2iv_flags(SV *const sv、const I32 フラグ)

sv_2モータル
既存の SV を死亡者としてマークします。 SV は「すぐに」破壊されます。
FREETMPS への明示的な呼び出し、またはステートメントなどの場所での暗黙的な呼び出しによる
境界線 SvTEMP() がオンになっているということは、SV の文字列バッファーを
この SV がコピーされた場合は「盗まれた」。 「sv_newmortal」および「sv_mortalcopy」も参照してください。

SV* sv_2mortal(SV *const sv)

sv_2nv_flags
必要な文字列または整数の変換を行って、SV の数値を返します。
フラグに SV_GMAGIC が含まれている場合、 mg_get（） 初め。通常は次の方法で使用されます。
「SvNV(sv)」マクロと「SvNVx(sv)」マクロ。

NV sv_2nv_flags(SV *const sv、const I32 フラグ)

sv_2pvbyte
SV のバイトエンコード表現へのポインタを返し、*lp をその値に設定します。
長さ。副作用として SV が UTF-8 からダウングレードされる可能性があります。

通常は「SvPVbyte」マクロ経由でアクセスします。

char* sv_2pvbyte(SV *sv, STRLEN *const lp)

sv_2pvutf8
SV の UTF-8 エンコード表現へのポインターを返し、 *lp をその値に設定します。
長さ。副作用として SV が UTF-8 にアップグレードされる可能性があります。

通常は「SvPVutf8」マクロ経由でアクセスします。

char* sv_2pvutf8(SV *sv, STRLEN *const lp)

sv_2pv_flags
SV の文字列値へのポインタを返し、*lp にその長さを設定します。もし
flags には SV_GMAGIC が含まれており、 mg_get（） 初め。次の場合に sv を文字列に強制します。
必要。通常は「SvPV_flags」マクロを介して呼び出されます。 「sv_2pv()」と
「sv_2pv_nomg」も通常はここに行きます。

char* sv_2pv_flags(SV *const sv, STRLEN *const lp,
const I32 フラグ)

sv_2uv_flags
必要な文字列変換を行って、SV の符号なし整数値を返します。
フラグに SV_GMAGIC が含まれている場合、 mg_get（） 初め。通常は次の方法で使用されます。
「SvUV(sv)」および「SvUVx(sv)」マクロ。

UV sv_2uv_flags(SV *const sv、const I32 フラグ)

sv_backoff
文字列オフセットを削除します。通常は「SvOOK_off」マクロ ラッパーを使用する必要があります。
を代わりにお使いください。

int sv_backoff(SV *const sv)

sv_bless
指定されたパッケージに SV を祝福します。 SV は RV である必要があります。パッケージは次のとおりです。
stash によって指定されます (「gv_stashpv()」を参照)。 SV の参照カウントは、
影響を受けません。

SV* sv_bless(SV *const sv、HV *const stash)

sv_catpv
「NUL」で終わる文字列を文字列の末尾に連結します。
SV。 SV に UTF-8 ステータスが設定されている場合、追加されるバイトは次のようになります。
有効な UTF-8。 「get」マジックは処理しますが、「set」マジックは処理しません。 「sv_catpv_mg」を参照してください。

void sv_catpv(SV *const sv, const char* ptr)

sv_catpvf
引数を「sprintf」のように処理し、フォーマットされた出力を SV に追加します。
追加されたデータに「ワイド」文字 (以下を含むがこれに限定されない) が含まれている場合、
%s でフォーマットされた UTF-8 PV と %c でフォーマットされた 255 を超える文字を持つ SV)、
元の SV は UTF-8 にアップグレードされる可能性があります。 「get」マジックは処理しますが、「set」マジックは処理しません
魔法。 「sv_catpvf_mg」を参照してください。元の SV が UTF-8 の場合、パターンは次のようになります。
有効な UTF-8;元の SV がバイトであれば、パターンもバイトである必要があります。

void sv_catpvf(SV *const sv, const char *const pat,
...）

sv_catpvf_mg
「sv_catpvf」と似ていますが、「set」マジックも処理します。

void sv_catpvf_mg(SV *const sv,
const char *const pat, ...)

sv_catpvn
SV 内の文字列の末尾に文字列を連結します。 「レン」
コピーするバイト数を示します。 SV に UTF-8 ステータスが設定されている場合、
追加されるバイトは有効な UTF-8 である必要があります。 「get」マジックは処理しますが、「set」マジックは処理しません。
「sv_catpvn_mg」を参照してください。

void sv_catpvn(SV *dsv, const char *sstr, STRLEN len)

sv_catpvn_flags
SV 内の文字列の末尾に文字列を連結します。 「レン」
コピーするバイト数を示します。

デフォルトでは、SV に
UTF-8 ステータス セット、それ以外の場合はバイト列。強制的に追加することができます
「SV_CATUTF8」フラグを指定することで UTF-8 として解釈される文字列、およびバイトとして解釈される文字列
「SV_CATBYTES」フラグを指定することによって。 SV または追加される文字列は次のようになります。
必要に応じて UTF-8 にアップグレードします。

「flags」に「SV_SMAGIC」ビットが設定されている場合、その後「dsv」に「mg_set」が設定されます。
適切な。 「sv_catpvn」と「sv_catpvn_nomg」はこれに関して実装されています
機能。

void sv_catpvn_flags(SV *const dstr,
const char *sstr、
const STRLEN レン、
const I32 フラグ)

sv_catpvs
「sv_catpvn」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

void sv_catpvs(SV* sv, const char* s)

sv_catpvs_flags
「sv_catpvn_flags」と似ていますが、文字列の代わりにリテラルの「NUL」で終わる文字列を受け取ります。
文字列/長さのペア。

void sv_catpvs_flags(SV* sv, const char* s,
I32 フラグ)

sv_catpvs_mg
「sv_catpvn_mg」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

void sv_catpvs_mg(SV* sv, const char* s)

sv_catpvs_nomg
「sv_catpvn_nomg」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

void sv_catpvs_nomg(SV* sv, const char* s)

sv_catpv_flags
「NUL」で終わる文字列を文字列の末尾に連結します。
SV。 SV に UTF-8 ステータスが設定されている場合、追加されるバイトは次のようになります。
有効な UTF-8。 「flags」に「SV_SMAGIC」ビットが設定されている場合、「mg_set」は
必要に応じて SV を変更します。

void sv_catpv_flags(SV *dstr, const char *sstr,
const I32 フラグ)

sv_catpv_mg
「sv_catpv」と似ていますが、「set」マジックも処理します。

void sv_catpv_mg(SV *const sv, const char *const ptr)

sv_catsv
SV "ssv" の文字列を SV "dsv" の文字列の末尾に連結します。もし
「ssv」は null で、何も行いません。それ以外の場合は、「dsv」のみを変更します。 「get」魔法を扱う
両方のSVにありますが、「セット」マジックはありません。 「sv_catsv_mg」および「sv_catsv_nomg」を参照してください。

void sv_catsv(SV *dstr, SV *sstr)

sv_catsv_flags
SV "ssv" の文字列を SV "dsv" の文字列の末尾に連結します。もし
「ssv」は null で、何も行いません。それ以外の場合は、「dsv」のみを変更します。 「フラグ」に含まれる場合
「SV_GMAGIC」ビットを設定すると、必要に応じて両方の SV で「mg_get」が呼び出されます。 「フラグ」の場合
"SV_SMAGIC" を含めると、後で変更された SV 上で "mg_set" が呼び出されます。
適切な。 「sv_catsv」「sv_catsv_nomg」「sv_catsv_mg」は、
この機能の条件。

void sv_catsv_flags(SV *const dsv, SV *const ssv,
const I32 フラグ)

sv_chop 文字列バッファの先頭から文字を効率的に削除します。
SvPOK(sv)、または少なくとも SvPOKp(sv) は true でなければならず、「ptr」はへのポインタでなければなりません。
文字列バッファ内のどこかにあります。 「ptr」が最初の文字になります。
調整した弦。 「OOKハック」を使用します。復帰時はSvPOK(sv)とSvPOKp(sv)のみ
OK フラグのうちの 1 つが true になります。

注意: この関数が戻った後は、「ptr」と SvPVX_const(sv) は参照できなくなる可能性があります。
同じデータチャンクに。

残念なことに、この関数の名前は Perl の「chop」の名前と似ています。
演算子は完全に偶然です。この関数は左から動作します。 "チョップ"
右から動作します。

void sv_chop(SV *const sv, const char *const ptr)

sv_clear
SV をクリアします。デストラクターを呼び出し、本体で使用されているメモリを解放し、
身体そのもの。 SVの頭は タイプはすべて 1 に設定されていますが、解放されています
地球規模の破壊中に誤って生きているとみなされないようにするため
この関数は、REFCNT が 0 の場合にのみ呼び出す必要があります。ほとんどの時間
代わりに「sv_free()」（またはそのマクロ ラッパー「SvREFCNT_dec」）を呼び出してください。

void sv_clear(SV *const orig_sv)

sv_cmp 1 つの SV の文字列を比較します。 -0、1、または XNUMX を返し、
「sv1」の文字列は、「sv2」の文字列より小さい、等しい、または大きいです。は
UTF-8 と「バイトの使用」を認識し、ハンドルは魔法を取得し、その引数を強制的に取得します。
必要に応じて文字列を追加します。 「sv_cmp_locale」も参照してください。

I32 sv_cmp(SV *const sv1, SV *const sv2)

sv_cmp_flags
1 つの SV 内の文字列を比較します。 -0、1、または XNUMX を返し、
「sv1」の文字列は、「sv2」の文字列より小さい、等しい、または大きいです。は
UTF-8 と「バイトの使用」を認識し、必要に応じて引数を文字列に強制します。もし
フラグには SV_GMAGIC が含まれており、get マジックを処理します。こちらも参照
「sv_cmp_locale_flags」。

I32 sv_cmp_flags(SV *const sv1, SV *const sv2,
const U32 フラグ)

sv_cmp_locale
ロケールを認識した方法で 8 つの SV 内の文字列を比較します。 UTF-XNUMX であり、「使用」
バイトを認識し、ハンドルは魔法を取得し、必要に応じて引数を文字列に強制します。
「sv_cmp」も参照してください。

I32 sv_cmp_locale(SV *const sv1, SV *const sv2)

sv_cmp_locale_flags
ロケールを認識した方法で 8 つの SV 内の文字列を比較します。 UTF-XNUMX であり、「使用」
バイトを認識し、必要に応じてその引数を文字列に強制します。フラグの場合
SV_GMAGIC が含まれており、get マジックを処理します。 「sv_cmp_flags」も参照してください。

I32 sv_cmp_locale_flags(SV *const sv1,
SV *const sv2、
const U32 フラグ)

sv_collxfrm
これは、SV_GMAGIC フラグを指定して「sv_collxfrm_flags」を呼び出します。 「sv_collxfrm_flags」を参照してください。

char* sv_collxfrm(SV *const sv, STRLEN *const nxp)

sv_collxfrm_flags
Collat​​e Transform マジックがまだ存在していない場合は、SV に追加します。フラグの場合
SV_GMAGIC が含まれている場合、get-magic を処理します。

任意のスカラー変数は、スカラーを含む PERL_MAGIC_collxfrm マジックを実行できます。
変数のデータですが、通常のメモリが認識できる形式に変換されます。
比較を使用すると、ロケール設定に従ってデータを比較できます。

char* sv_collxfrm_flags(SV *const sv,
STRLEN *const nxp、
I32 定数フラグ)

sv_copypv_flags
sv_copypv および sv_copypv_nomg の実装。フラグが含まれている場合、get magic を呼び出します。
SV_GMAGIC。

void sv_copypv_flags(SV *const dsv, SV *const ssv,
const I32 フラグ)

sv_copypv_nomg
sv_copypv と似ていますが、最初に get magic を呼び出しません。

void sv_copypv_nomg(SV *const dsv, SV *const ssv)

sv_dec SV の値を自動デクリメントし、次の場合に文字列から数値への変換を実行します。
必要。 「get」マジックと演算子のオーバーロードを処理します。

void sv_dec(SV *const sv)

sv_dec_nomg
SV 内の値を自動デクリメントし、次の場合に文字列から数値への変換を実行します。
必要。演算子のオーバーロードを処理します。 「get」マジックの処理をスキップします。

void sv_dec_nomg(SV *const sv)

sv_eq 2 つの SV の文字列が同一かどうかを示すブール値を返します。は
UTF-8 と「バイトの使用」を認識し、ハンドルは魔法を取得し、その引数を強制的に取得します。
必要に応じて文字列を追加します。

I32 sv_eq(SV* sv1、SV* sv2)

sv_eq_flags
2 つの SV の文字列が同一かどうかを示すブール値を返します。は
UTF-8 と「バイトの使用」を認識し、必要に応じて引数を文字列に強制します。もし
flags には SV_GMAGIC が含まれており、get-magic も処理します。

I32 sv_eq_flags(SV* sv1、SV* sv2、const U32 フラグ)

sv_force_normal_flags
SV 上のさまざまな種類の偽装を元に戻します。偽装は文字列「以上」を意味します。
PV は共有文字列であるため、プライベート コピーを作成します。私たちが参照者である場合は、参照を停止してください。もし
私たちは glob なので、xpvmg にダウングレードします。コピーオンライト スカラーの場合、これは
コピーを行うときの書き込み時間。ローカルでも使用されます。これが vstring の場合、
vstring マジックを削除します。 「SV_COW_DROP_PV」が設定されている場合は、コピーオンライト スカラー
PV バッファ (存在する場合) を削除し、コピーを作成するのではなく SvPOK_off になります。
(このスカラーが他の値に設定されようとしている場合に使用されます。) さらに、
「flags」パラメータは、reff 解除時に「sv_unref_flags()」に渡されます。
「sv_force_normal」は、フラグを 0 に設定してこの関数を呼び出します。

この関数は、この SV がこれから変更されることを Perl に通知するために使用されることが期待されています。
に書かれており、追加の帳簿管理に対処する必要があります。したがって、それは
読み取り専用値をクロークします。

void sv_force_normal_flags(SV *const sv,
const U32 フラグ)

sv_free SV の参照カウントをデクリメントし、ゼロになった場合は、「sv_clear」を呼び出します。
デストラクターを呼び出し、本体で使用されているメモリを解放します。最後に割り当てを解除します
SVのヘッドそのもの。通常はラッパー マクロ「SvREFCNT_dec」を介して呼び出されます。

void sv_free(SV *const sv)

sv_gets ファイルハンドルから行を取得し、SV に保存し、オプションで次の行に追加します。
現在保存されている文字列。 「append」が 0 でない場合、その行は SV に追加されます。
上書きする代わりに。 「append」は、
追加される文字列は SV 内の で始まる必要があります (通常、「SvCUR(sv)」が適切です)
選択）。

char* sv_gets(SV *const sv, PerlIO *const fp,
I32 追加)

sv_get_backrefs
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

SV が弱参照のターゲットである場合、後方参照を返します。
SV に関連付けられた構造体。それ以外の場合は NULL を返します。

null 以外の結果を返す場合、戻り値の型が関係します。それが
AV の場合、AV の要素は、これを指す弱い参照 RV になります。
アイテム。他の型の場合、項目自体が弱参照になります。

参照 Perl_sv_add_backref(), Perl_sv_del_backref(), Perl_sv_kill_backrefs()

SV* sv_get_backrefs(SV *const sv)

sv_grow SV 内の文字バッファを拡張します。必要に応じて、「sv_unref」を使用し、
SV を「SVt_PV」にアップグレードします。文字バッファへのポインタを返します。使用
代わりに「SvGROW」ラッパー。

char* sv_grow(SV *const sv, STRLEN newlen)

sv_inc SV の値を自動インクリメントし、次の場合に文字列から数値への変換を実行します。
必要。 「get」マジックと演算子のオーバーロードを処理します。

void sv_inc(SV *const sv)

sv_inc_nomg
SV の値を自動インクリメントし、次の場合に文字列から数値への変換を実行します。
必要。演算子のオーバーロードを処理します。 「get」マジックの処理をスキップします。

void sv_inc_nomg(SV *const sv)

sv_挿入
SV 内の指定されたオフセット/長さに文字列を挿入します。に似ています
パール substr（） 関数。ハンドルには魔法がかかります。

void sv_insert(SV *const bigstr, const STRLEN オフセット,
const STRLEN レン、
const char *const little、
const STRLEN littlelen)

sv_insert_flags
「sv_insert」と同じですが、追加の「フラグ」が「SvPV_force_flags」に渡されます。
これは「bigstr」に適用されます。

void sv_insert_flags(SV *const bigstr,
const STRLEN オフセット、
const STRLEN レン、
const char *const little、
const STRLEN リトルレン、
const U32 フラグ)

sv_isa SV が指定されたクラスに祝福されているかどうかを示すブール値を返します。
これはサブタイプをチェックしません。 「sv_derived_from」を使用して継承を検証する
関係。

int sv_isa(SV* sv, const char *const 名)

sv_isoobject
SV が祝福されたオブジェクトを指す RV であるかどうかを示すブール値を返します。
SV が RV ではない場合、またはオブジェクトが祝福されていない場合、これは返されます。
偽。

int sv_isobject(SV* sv)

sv_len SV 内の文字列の長さを返します。魔法と型強制を処理し、
UTF8 フラグを適切に設定します。 「SvCUR」も参照してください。これにより、
xpv_cur スロット。

STRLEN sv_len(SV *const sv)

sv_len_utf8
ワイド UTF-8 バイトをカウントして、SV 内の文字列の文字数を返します。
単一の文字として。魔法と型強制を処理します。

STRLEN sv_len_utf8(SV *const sv)

sv_magic
SVに魔法を付与します。まず、必要に応じて「sv」をタイプ「SVt_PVMG」にアップグレードします。
「how」タイプの新しいマジック項目をマジックリストの先頭に追加します。

処理の説明については、「sv_magicext」(「sv_magic」が現在呼び出している)を参照してください。
「name」引数と「namlen」引数の。

SvREADONLY SV にマジックを追加したり、さらに追加したりするには、「sv_magicext」を使用する必要があります。
同じ「方法」の 1 つのインスタンスよりも。

void sv_magic(SV *const sv, SV *const obj,
const int 方法、const char *const 名、
const I32 ナムレン)

sv_magicext
SV に魔法を追加し、必要に応じてアップグレードします。提供された vtable を適用し、
追加された魔法へのポインタを返します。

「sv_magicext」は「sv_magic」が許可しないものを許可することに注意してください。で
特に、SvREADONLY SV にマジックを追加し、複数のインスタンスを追加できます。
同じ「方法」。

「namlen」がゼロより大きい場合、「savepvn」 copy 「名前」の値が格納されている場合、
「namlen」がゼロの場合、「name」はそのまま保存され、別の特殊なケースとして、次の場合に保存されます。
「(name && namlen == HEf_SVKEY)」の場合、「name」には「SV*」が含まれるとみなされ、次のようになります。
REFCNT がインクリメントされた状態でそのまま保存されます。

(これは現在、「sv_magic」によってサブルーチンとして使用されています。)

MAGIC * sv_magicext(SV *const sv, SV *const obj,
const int どのように、
const MGVTBL *const vtbl,
const char *定数名、
const I32 ナムレン)

sv_mortalcopy
元の SV のコピーである新しい SV を作成します (「sv_setsv」を使用)。新しい
SV は死亡者としてマークされます。明示的な呼び出しによって「すぐに」破棄されます
FREETMPS へのアクセス、またはステートメント境界などの場所での暗黙的な呼び出しによって。見る
「sv_newmortal」と「sv_2mortal」も。

SV* sv_mortalcopy(SV *const oldsv)

sv_newmortal
致命的な新しいヌル SV を作成します。 SV の参照カウントは 1 に設定されます。
FREETMPS への明示的な呼び出し、または
ステートメント境界などの場所での暗黙的な呼び出し。 「sv_mortalcopy」も参照してください。
そして「sv_2mortal」。

SV* sv_newmortal()

sv_newref
SV の参照カウントをインクリメントします。代わりに「SvREFCNT_inc()」ラッパーを使用してください。

SV* sv_newref(SV *const sv)

sv_pos_b2u
offsetp が指す値を、先頭からのバイト数から変換します。
文字列を UTF-8 文字の同等数に換算します。魔法を扱い、
型の強制。

「sv_pos_b2u_flags」を優先的に使用してください。これにより、次の文字列よりも長い文字列が正しく処理されます。
2Gb。

void sv_pos_b2u(SV *const sv, I32 *const offsetp)

sv_pos_b2u_flags
文字列の先頭からのバイト数からのオフセットをカウントに変換します。
同等の数の UTF-8 文字。タイプの強制を処理します。 フラグ 合格
「SvPV_flags」に設定し、通常は「SV_GMAGIC|SV_CONST_RETURN」で処理する必要があります。
魔法。

STRLEN sv_pos_b2u_flags(SV *const sv,
STRLEN 定数オフセット、U32 フラグ)

sv_pos_u2b
offsetp が指す値を、UTF-8 文字の数から変換します。
文字列の先頭から、同等のバイト数までのカウント。 lenp が非の場合
ゼロの場合、lenp に対しても同じことを行いますが、今回はオフセットから開始します。
文字列の先頭からよりも。魔法と型強制を処理します。

「sv_pos_u2b_flags」を優先的に使用してください。これにより、次の文字列よりも長い文字列が正しく処理されます。
2Gb。

void sv_pos_u2b(SV *const sv, I32 *const offsetp,
I32 *const lenp)

sv_pos_u2b_flags
文字列の先頭からの UTF-8 文字数のオフセットを
同等のバイト数のカウント。 lenp がゼロ以外の場合、同じことを行います。
lenp ですが、今回は先頭からではなくオフセットから開始します。
弦。タイプの強制を処理します。 フラグ は「SvPV_flags」に渡され、通常は
マジックを処理するには「SV_GMAGIC|SV_CONST_RETURN」にする必要があります。

STRLEN sv_pos_u2b_flags(SV *const sv, STRLEN uoffset,
STRLEN *const lenp、U32 フラグ)

sv_pvbyten_force
「SvPVbytex_force」マクロのバックエンド。代わりに常にマクロを使用してください。

char* sv_pvbyten_force(SV *const sv, STRLEN *const lp)

sv_pvn_force
何らかの方法で SV から意味のある文字列を取得します。のプライベート実装
複雑なマクロ式に対応できないコンパイラ向けのマクロ「SvPV_force」。
代わりに常にマクロを使用してください。

char* sv_pvn_force(SV* sv, STRLEN* lp)

sv_pvn_force_flags
何らかの方法で SV から意味のある文字列を取得します。 「flags」に「SV_GMAGIC」ビットが設定されている場合、
適切な場合は「sv」で「mg_get」を実行しますが、それ以外の場合は実行しません。 「sv_pvn_force」と
この機能に関しては「sv_pvn_force_nomg」が実装されています。普通に欲しいのは
代わりにさまざまなラッパー マクロを使用するには、「SvPV_force」および「SvPV_force_nomg」を参照してください。

char* sv_pvn_force_flags(SV *const sv,
STRLEN *定数 lp,
const I32 フラグ)

sv_pvutf8n_force
「SvPVutf8x_force」マクロのバックエンド。代わりに常にマクロを使用してください。

char* sv_pvutf8n_force(SV *const sv, STRLEN *const lp)

sv_reftype
SV が何への参照であるかを説明する文字列を返します。

const char* sv_reftype(const SV *const sv, const int ob)

sv_replace
最初の引数を 2 番目の引数のコピーにしてから、元の引数を削除します。の
ターゲット SV はソース SV の本体の所有権を物理的に引き継ぎ、
そのフラグを継承します。ただし、ターゲットは所有する魔法とすべての魔法を保持します。
ソースは破棄されます。これはかなり特殊な SV コピーであることに注意してください。
手術;ほとんどの場合、「sv_setsv」またはその多くのマクロの 1 つを使用することになります。
フロントエンド。

void sv_replace(SV *const sv, SV *const nsv)

sv_reset
「リセット」Perl 関数の基礎となる実装。 perl レベルに注意してください。
この関数は漠然と非推奨になっています。

void sv_reset(const char* s, HV *const stash)

sv_rvweaken
参照を弱める: この RV に「SvWEAKREF」フラグを設定します。参照先のSVを与える
「PERL_MAGIC_backref」マジック (まだ存在していない場合)。これへの後方参照をプッシュします
そのマジックに関連付けられた後方参照の配列への RV。 RV が
魔法の場合、設定された魔法は RV がクリアされた後に呼び出されます。

SV* sv_rvweaken(SV *const sv)

sv_setiv
整数を指定された SV にコピーし、必要に応じて最初にアップグレードします。ではない
「セット」マジックを処理します。 「sv_setiv_mg」も参照してください。

void sv_setiv(SV *const sv, const IV num)

sv_setiv_mg
「sv_setiv」と似ていますが、「set」マジックも処理します。

void sv_setiv_mg(SV *const sv, const IV i)

sv_setnv
指定された SV に double をコピーし、必要に応じて最初にアップグレードします。取り扱いません
「セット」マジック。 「sv_setnv_mg」も参照してください。

void sv_setnv(SV *const sv, const NV num)

sv_setnv_mg
「sv_setnv」と似ていますが、「set」マジックも処理します。

void sv_setnv_mg(SV *const sv, const NV num)

sv_setpv
文字列をSVにコピーします。文字列は「NUL」文字で終了する必要があります。
「セット」マジックは扱いません。 「sv_setpv_mg」を参照してください。

void sv_setpv(SV *const sv, const char *const ptr)

sv_setpvf
「sv_catpvf」と同様に機能しますが、テキストを追加するのではなく、SV にコピーします。
「セット」マジックは扱いません。 「sv_setpvf_mg」を参照してください。

void sv_setpvf(SV *const sv, const char *const pat,
...）

sv_setpvf_mg
「sv_setpvf」と似ていますが、「set」マジックも処理します。

void sv_setpvf_mg(SV *const sv,
const char *const pat, ...)

sv_setpviv
整数を指定された SV にコピーし、その文字列値も更新します。ではない
「セット」マジックを処理します。 「sv_setpviv_mg」を参照してください。

void sv_setpviv(SV *const sv, const IV num)

sv_setpviv_mg
「sv_setpviv」と似ていますが、「set」マジックも処理します。

void sv_setpviv_mg(SV *const sv, const IV iv)

sv_setpvn
文字列 (埋め込まれた「NUL」文字を含む可能性がある) を SV にコピーします。の
「len」パラメータはコピーされるバイト数を示します。 「ptr」引数の場合
NULL の場合、SV は未定義になります。 「セット」マジックは扱いません。見る
「sv_setpvn_mg」。

void sv_setpvn(SV *const sv, const char *const ptr,
const STRLEN len)

sv_setpvn_mg
「sv_setpvn」と似ていますが、「set」マジックも処理します。

void sv_setpvn_mg(SV *const sv,
const char *const ptr、
const STRLEN len)

sv_setpvs
「sv_setpvn」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

void sv_setpvs(SV* sv, const char* s)

sv_setpvs_mg
「sv_setpvn_mg」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

void sv_setpvs_mg(SV* sv, const char* s)

sv_setpv_mg
「sv_setpv」と似ていますが、「set」マジックも処理します。

void sv_setpv_mg(SV *const sv, const char *const ptr)

sv_setref_iv
整数を新しい SV にコピーし、オプションで SV を祝福します。 「rv」引数
RVにアップグレードされます。その RV は、新しい SV を指すように変更されます。の
「classname」引数は、祝福のパッケージを示します。 「クラス名」を次のように設定します
祝福を回避するには「NULL」。新しい SV の参照カウントは 1 になります。
RVは返却されます。

SV* sv_setref_iv(SV *const rv,
const char *const クラス名、
定数 IV iv)

sv_setref_nv
ダブルを新しい SV にコピーし、オプションで SV を祝福します。 「rv」引数は、
RVにアップグレードされます。その RV は、新しい SV を指すように変更されます。の
「classname」引数は、祝福のパッケージを示します。 「クラス名」を次のように設定します
祝福を回避するには「NULL」。新しい SV の参照カウントは 1 になります。
RVは返却されます。

SV* sv_setref_nv(SV *const rv,
const char *const クラス名、
const NV nv)

sv_setref_pv
ポインタを新しい SV にコピーし、オプションで SV を祝福します。 「rv」引数
RVにアップグレードされます。その RV は、新しい SV を指すように変更されます。もし
「pv」引数が NULL の場合、「PL_sv_undef」が SV に配置されます。の
「classname」引数は、祝福のパッケージを示します。 「クラス名」を次のように設定します
祝福を回避するには「NULL」。新しい SV の参照カウントは 1 になります。
RVは返却されます。

HV、AV、SV、CV などの他の Perl タイプでは使用しないでください。
ポインタのコピー処理により破損します。

「sv_setref_pvn」は文字列をコピーし、これはポインタをコピーすることに注意してください。

SV* sv_setref_pv(SV *const rv,
const char *const クラス名、
void *const pv)

sv_setref_pvn
文字列を新しい SV にコピーし、オプションで SV を祝福します。の長さは、
文字列は「n」で指定する必要があります。 「rv」引数は RV にアップグレードされます。
その RV は、新しい SV を指すように変更されます。 「クラス名」引数
は祝福のパッケージを示します。回避するには、「classname」を「NULL」に設定します。
祝福。新しい SV の参照カウントは 1 になり、RV は次のようになります。
戻ってきた。

「sv_setref_pv」はポインタをコピーし、これは文字列をコピーすることに注意してください。

SV* sv_setref_pvn(SV *const rv,
const char *const クラス名、
const char *const pv、
定数STRLEN n)

sv_setref_pvs
「sv_setref_pvn」と似ていますが、文字列と長さのペアの代わりにリテラル文字列を受け取ります。

SV * sv_setref_pvs(const char* s)

sv_setref_uv
符号なし整数を新しい SV にコピーし、オプションで SV を祝福します。 「RV」
引数は RV にアップグレードされます。その RV は新しいものを指すように変更されます。
SV。 「classname」引数は、祝福のパッケージを示します。セット
祝福を回避するには、「classname」を「NULL」にします。新しい SV には参照が含まれます
カウントが 1 になると、RV が返されます。

SV* sv_setref_uv(SV *const rv,
const char *const クラス名、
定数 UV uv)

sv_setsv
コピー元SV「ssv」の内容をコピー先SV「dsv」にコピーします。の
ソース SV が致命的である場合は破壊される可能性があるため、この機能を使用しないでください。
ソース SV を再利用する必要があります。宛先 SV の「set」マジックを処理しません。
ソース SV で「get」マジックを呼び出します。大まかに言えば、値によるコピーを実行します。
宛先の以前のコンテンツを消去します。

おそらく、「SvSetSV」などのさまざまなラッパーのいずれかを使用するとよいでしょう。
「SvSetSV_nosteal」、「SvSetMagicSV」、「SvSetMagicSV_nosteal」。

void sv_setsv(SV *dstr, SV *sstr)

sv_setsv_flags
コピー元SV「ssv」の内容をコピー先SV「dsv」にコピーします。の
ソース SV が致命的である場合は破壊される可能性があるため、この機能を使用しないでください。
ソース SV を再利用する必要があります。 「セット」マジックは扱いません。ざっくり言うと、それは
値によるコピーを実行し、コピー先の以前のコンテンツを消去します。
「flags」パラメータに「SV_GMAGIC」ビットが設定されている場合、「ssv」で「mg_get」を実行します。
適切、そうでない場合。 「flags」パラメータに「SV_NOSTEAL」ビットが設定されている場合、
temp のバッファは盗まれません。および「sv_setsv_nomg」は
この機能に関して実装されています。

おそらく、「SvSetSV」などのさまざまなラッパーのいずれかを使用するとよいでしょう。
「SvSetSV_nosteal」、「SvSetMagicSV」、「SvSetMagicSV_nosteal」。

これは、スカラーをコピーするための主要な関数であり、他のほとんどのコピー風の関数です。
関数とマクロはこれを下で使用します。

void sv_setsv_flags(SV *dstr, SV *sstr,
const I32 フラグ)

sv_setsv_mg
「sv_setsv」と似ていますが、「set」マジックも処理します。

void sv_setsv_mg(SV *const dstr, SV *const sstr)

sv_setuv
符号なし整数を指定された SV にコピーし、必要に応じて最初にアップグレードします。する
「set」マジックを処理しません。 「sv_setuv_mg」も参照してください。

void sv_setuv(SV *const sv, const UV num)

sv_setuv_mg
「sv_setuv」と似ていますが、「set」マジックも処理します。

void sv_setuv_mg(SV *const sv, const UV u)

sv_tainted
SV の汚染をテストします。代わりに「SvTAINTED」を使用してください。

bool sv_tainted(SV *const sv)

sv_true Perl のルールに従って SV が true 値を持つ場合に true を返します。 「SvTRUE」マクロを使用する
代わりに、「sv_true()」を呼び出すか、インライン バージョンを使用する場合があります。

I32 sv_true(SV *const sv)

sv_unmagic
タイプ「タイプ」のすべての魔法を SV から削除します。

int sv_unmagic(SV *const sv, const int 型)

sv_unmagicext
指定された「vtbl」を持つタイプ「type」のすべてのマジックを SV から削除します。

int sv_unmagicext(SV *const sv, const int 型,
MGVTBL *vtbl)

sv_unref_flags
SV の RV ステータスの設定を解除し、以前の状態の参照カウントをデクリメントします。
RV によって参照されます。 これはほぼ逆転と考えることができます。
「newSVrv」。 「cflags」引数には、強制的に「SV_IMMEDIATE_UNREF」を含めることができます。
デクリメントされる参照カウント (それ以外の場合、デクリメントの条件は次のとおりです)
参照カウントが 1 と異なるか、参照が読み取り専用です
SV）。 「SvROK_off」を参照してください。

void sv_unref_flags(SV *const ref、const U32 フラグ)

sv_untaint
SV の汚染を解除します。代わりに「SvTAINTED_off」を使用してください。

void sv_untaint(SV *const sv)

sv_upgrade
SV をより複雑な形式にアップグレードします。通常、SV に新しいボディタイプを追加します。
次に、古い本体から可能な限り多くの情報をコピーします。鳴く
SV がすでに要求されたよりも複雑な形式になっている場合。あなたは一般的にそうしたいです
呼び出す前に型をチェックする「SvUPGRADE」マクロ ラッパーを使用します。
「sv_upgrade」なので、クロークしません。 「svtype」も参照してください。

void sv_upgrade(SV *const sv, svtype new_type)

sv_usepvn_flags
SV に「ptr」を使用して文字列値を検索するように指示します。通常は文字列が格納されます
ただし、sv_usepvn を使用すると、SV が外部の文字列を使用できるようになります。 「ptr」
Newx によって割り当てられたメモリを指す必要があります。それは何かの始まりに違いない
Newx されたメモリ ブロックであり、その中間へのポインタではありません (OOK と
コピーオンライト）、「malloc」などの Newx 以外のメモリ アロケータからのものではありません。の
文字列の長さ「len」を指定する必要があります。デフォルトでは、この機能は「更新」されます。
「ptr」が指すメモリを（つまり、realloc、move）、そのポインタを
sv_usepvn に渡した後、プログラマによって解放または使用されますが、どちらも使用すべきではありません。
そのポインタの「後ろ」のポインタ (例: ptr + 1) が使用されます。

「flags」と SV_SMAGIC が true の場合、SvSETMAGIC を呼び出します。 「フラグ」の場合 &
SV_HAS_TRAILING_NUL が true の場合、「ptr[len]」は「NUL」でなければならず、realloc は
スキップされる（つまり、バッファは実際には「len」より少なくとも 1 バイト長い、そして
「SvPVX」に保存するための要件をすでに満たしています）。

void sv_usepvn_flags(SV *const sv, char* ptr,
const STRLEN レン、
const U32 フラグ)

sv_utf8_decode
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

SV の PV が UTF-8 のオクテット シーケンスであり、マルチバイトが含まれている場合
文字の場合、「SvUTF8」フラグがオンになり、文字のように見えます。もし
PV に半角文字のみが含まれている場合、「SvUTF8」フラグはオフのままです。スキャン
PV が有効であるかどうかを確認し、PV が無効な UTF-8 である場合は false を返します。

bool sv_utf8_decode(SV *const sv)

sv_utf8_downgrade
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

SV の PV を文字からバイトに変換しようとします。 PV に含まれている場合
バイトに収まらない文字の場合、この変換は失敗します。この場合、
false を返すか、「fail_ok」が true でない場合はクロークします。

これは汎用の Unicode からバイト エンコードへのインターフェイスではありません。Encode を使用してください。
そのための拡張機能。

bool sv_utf8_downgrade(SV *const sv,
const bool 失敗_ok)

sv_utf8_encode
SV の PV を UTF-8 に変換しますが、「SvUTF8」フラグをオフにして、
またオクテットのように見えます。

void sv_utf8_encode(SV *const sv)

sv_utf8_upgrade
SV の PV を UTF-8 エンコード形式に変換します。 SV を文字列形式に強制します
まだそうでない場合は。必要に応じて、「sv」に対して「mg_get」を実行します。常に設定します
文字列全体が同じであっても将来の有効性チェックを回避するための SvUTF8 フラグ
UTF-8ではそうではありません。変換された文字列のバイト数を返します。

これは Unicode インターフェイスへの汎用バイト エンコーディングではありません。Encode を使用してください。
そのための拡張機能。

STRLEN sv_utf8_upgrade(SV *sv)

sv_utf8_upgrade_flags
SV の PV を UTF-8 エンコード形式に変換します。 SV を文字列形式に強制します
まだそうでない場合は。将来の有効性チェックを避けるために、常に SvUTF8 フラグを設定します。
UTF-8 ではすべてのバイトが不変であっても。 「flags」に「SV_GMAGIC」ビットが設定されている場合、
適切な場合は「sv」で「mg_get」を実行しますが、それ以外の場合は実行しません。

「flags」に SV_FORCE_UTF8_UPGRADE が設定されている場合、この関数は PV が
UTF-8 に変換されると展開され、それをチェックする余分な作業がスキップされます。
通常、このフラグは文字列をすでに解析したルーチンによって使用され、
そのようなキャラクターを見つけたので、作品が壊れないようにこの情報を渡します。
繰り返さなければなりません。

変換された文字列のバイト数を返します。

これは Unicode インターフェイスへの汎用バイト エンコーディングではありません。Encode を使用してください。
そのための拡張機能。

STRLEN sv_utf8_upgrade_flags(SV *const sv,
const I32 フラグ)

sv_utf8_upgrade_flags_grow
sv_utf8_upgrade_flags と似ていますが、追加パラメータ「extra」があります。
「sv」の文字列がその後に空きがあることが保証されている未使用のバイト数
戻る。これにより、呼び出し元は、埋める予定の余分なスペースを予約できるようになります。
余分な成長を避けます。

「sv_utf8_upgrade」、「sv_utf8_upgrade_nomg」、「sv_utf8_upgrade_flags」は
この機能に関して実装されています。

変換された文字列のバイト数を返します (スペアは含まれません)。

STRLEN sv_utf8_upgrade_flags_grow(SV *const sv,
const I32 フラグ、
STRLEN エクストラ）

sv_utf8_upgrade_nomg
sv_utf8_upgrade と似ていますが、「sv」に対して魔法を実行しません。

STRLEN sv_utf8_upgrade_nomg(SV *sv)

sv_vcatpvf
「vsprintf」のように引数を処理し、フォーマットされた出力を SV に追加します。
「セット」マジックは扱いません。 「sv_vcatpvf_mg」を参照してください。

通常はフロントエンド「sv_catpvf」経由で使用されます。

void sv_vcatpvf(SV *const sv, const char *const pat,
va_list *定数引数)

sv_vcatpvfn
void sv_vcatpvfn(SV *const sv, const char *const pat,
const STRLEN パレン、
va_list *定数引数、
SV **const svargs、const I32 svmax、
bool *const might_tainted)

sv_vcatpvfn_flags
「vsprintf」のように引数を処理し、フォーマットされた出力を SV に追加します。
C スタイルの変数引数リストが欠落している (NULL) 場合は、SV の配列を使用します。
汚染チェックを有効にして実行すると、結果が「maybe_tainted」によって示されます。
は信頼できません (多くの場合、ロケールの使用が原因です)。

「sv_vcatpvfn」として呼び出されるか、フラグに「SV_GMAGIC」が含まれる場合、呼び出しは get magic になります。

通常、フロントエンド「sv_vcatpvf」および「sv_vcatpvf_mg」のいずれかを介して使用されます。

void sv_vcatpvfn_flags(SV *const sv,
const char *const pat、
const STRLEN パレン、
va_list *定数引数、
SV **const svargs、
const I32 SVMAX、
bool *const might_tainted、
const U32 フラグ)

sv_vcatpvf_mg
「sv_vcatpvf」と似ていますが、「set」マジックも処理します。

通常はフロントエンド「sv_catpvf_mg」経由で使用されます。

void sv_vcatpvf_mg(SV *const sv,
const char *const pat、
va_list *定数引数)

sv_vsetpvf
「sv_vcatpvf」と同様に機能しますが、テキストを追加するのではなく、SV にコピーします。
「セット」マジックは扱いません。 「sv_vsetpvf_mg」を参照してください。

通常はフロントエンド「sv_setpvf」経由で使用されます。

void sv_vsetpvf(SV *const sv, const char *const pat,
va_list *定数引数)

sv_vsetpvfn
「sv_vcatpvfn」と同様に機能しますが、テキストを追加するのではなく SV にコピーします。

通常、フロントエンド「sv_vsetpvf」および「sv_vsetpvf_mg」のいずれかを介して使用されます。

void sv_vsetpvfn(SV *const sv, const char *const pat,
const STRLEN パレン、
va_list *定数引数、
SV **const svargs、const I32 svmax、
bool *const might_tainted)

sv_vsetpvf_mg
「sv_vsetpvf」と似ていますが、「set」マジックも処理します。

通常はフロントエンド「sv_setpvf_mg」経由で使用されます。

void sv_vsetpvf_mg(SV *const sv,
const char *const pat、
va_list *定数引数)

Unicode サポート

perlguts の「Unicode Support」には、この API の概要が記載されています。

「文字の分類」および「大文字と小文字の変更」も参照してください。多彩な機能
このセクション以外でも特に Unicode で動作します。文字列「utf8」を検索します。
このドキュメント。

bytes_cmp_utf8
「b」、「blen」の文字シーケンス (オクテットとして保存) を、
「u」、「ulen」の文字シーケンス (UTF-8 として保存)。該当する場合は 0 を返します。
等しい、最初の文字列が 1 番目の文字列より小さい場合は -2 または -1、場合は +2 または +XNUMX
最初の文字列は 2 番目の文字列より大きいです。

短い文字列が文字列の先頭と一致した場合は、-1 または +1 が返されます。
長い文字列。文字間に違いがあった場合は、-2 または +2 が返されます。
文字列の中で。

int bytes_cmp_utf8(const U8 *b, STRLEN ブレン,
const U8 *u、STRLEN ulen)

bytes_from_utf8
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

長さ「len」の文字列「s」を UTF-8 からネイティブのバイトエンコーディングに変換します。
「utf8_to_bytes」とは異なりますが、「bytes_to_utf8」と同様に、新しく作成されたファイルへのポインタを返します。
作成された文字列を作成し、新しい長さを含むように「len」を更新します。原本を返却します
string 変換が行われない場合、「len」は変更されません。 「is_utf8」の場合は何もしない
「s」が変換されるか、完全に次のもので構成される場合、「is_utf0」を 8 に設定します。
utf8 で不変の文字 (つまり、非 EBCDIC マシン上の US-ASCII)。

U8* bytes_from_utf8(const U8 *s, STRLEN *len,
ブール値 *is_utf8)

bytes_to_utf8
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

長さ「len」バイトの文字列「s」をネイティブエンコーディングから UTF-8 に変換します。
新しく作成された文字列へのポインタを返し、新しい文字列を反映するように「len」を設定します。
バイト単位の長さ。

文字列の末尾には「NUL」文字が書き込まれます。

ネイティブ以外のエンコーディング (Latin8 または
EBCDIC)、「sv_recode_to_utf8」() を参照してください。

U8* bytes_to_utf8(const U8 *s, STRLEN *len)

DO_UTF8 "sv" 内の PV を処理するかどうかを示す bool を返します。
UTF-8でエンコードされています。

これを使うべきです After 「SvPV()」またはそのバリアントの 1 つへの呼び出し（必要な場合）
文字列のオーバーロードを呼び出すと、内部の UTF-8 エンコード フラグが更新されます。

bool DO_UTF8(SV* sv)

フォールドEQ_utf8
文字列「s1」と「s2」の先頭部分（いずれかまたは両方）が一致する場合、true を返します。
それらは UTF-8 である可能性があります) は、大文字と小文字を区別せずに同じです。それ以外の場合は false。どうやって
文字列のどこまでを比較するかは、他の入力パラメータによって決まります。

「u1」が true の場合、文字列「s1」は UTF-8 でエンコードされた Unicode であるとみなされます。
それ以外の場合は、ネイティブ 8 ビット エンコーディングであるとみなされます。 「u2」に対応
「s2」に関して。

バイト長「l1」がゼロ以外の場合、「s1」のどこまでフォールドをチェックするかを示します。
平等。つまり、「s1」+「l1」が到達目標となります。スキャン
ゴールに到達し、スキャンしない限り、一致とは見なされません。
その目標を超えて続けることはできません。 「s2」に対する「l2」も同様です。

「pe1」が NULL でなく、それが指すポインタが NULL でない場合、そのポインタは
「s1」の最大点から 1 バイト後の位置への終了ポインタと見なされます。
これを超えると、いかなる状況でもスキャンは続行されなくなります。 (このルーチンは
UTF-8 でエンコードされた入力文字列が不正な形式ではないことを前提としています。不正な入力が可能
「pe1」を超えて読み取られるようにします）。これは、「l1」と「pe1」の両方が
が指定されており、「pe1」が「s1」+「l1」より小さい場合、一致は決して成功しません。
なぜなら、それは決してその目標に到達することができない（そして実際に反対されている）からです。
「s2」に対する「pe2」も同様です。

「s1」と「s2」の少なくとも 1 つはゴールを持っている必要があります (「l2」と「lXNUMX」の少なくとも XNUMX つはゴールを持っている必要があります)
ゼロ以外である必要があります)、両方が一致する場合、一致を成功させるためには両方に到達する必要があります。
また、キャラクターの折り目が複数のキャラクターの場合は、その全てが折り目である必要があります。
一致しました (「折りたたみ」については、以下の tr21 リファレンスを参照してください)。

一致が成功した場合、「pe1」が NULL でない場合は、
の始まり 次の 一致したものを超える「s1」の文字。それに応じて
「pe2」と「s2」の場合。

大文字と小文字を区別しないために、代わりに Unicode の「大文字と小文字の区別」が使用されます。
両方の文字の大文字/小文字については、を参照してください。
<http://www.unicode.org/unicode/reports/tr21/> (ケースのマッピング)。

I32foldEQ_utf8(const char *s1, char **pe1, UV l1,
bool u1、const char *s2、char **pe2、
UV l2、ブール u2)

isUTF8_CHAR
正当な UTF-8 (または UTF-XNUMX) を形成する「s」で始まるバイト数を返します。
EBCDIC) でエンコードされた文字。「s」内の「e - s」バイトのみを検索します。
「s」から「e - 0」までのシーケンスが整形式の UTF-1 でない場合は 8 を返します。

INVARIANT 文字 (つまり、非 EBCDIC マシン上の ASCII) は有効であることに注意してください。
UTF-8 文字。

STRLEN isUTF8_CHAR(const U8 *s, const U8 *e)

is_ascii_string
これは、「is_invariant_string」と誤解を招くような名前の同義語です。 ASCIIっぽい
プラットフォームでは、この名前は誤解を招くものではありません。ASCII 範囲の文字は正確に
UTF-8 の不変条件。しかし、EBCDIC マシンには ASCII だけではなく、より多くの不変条件があります。
文字なので、「is_invariant_string」が推奨されます。

bool is_ascii_string(const U8 *s, STRLEN len)

is_invariant_string
文字列「s」の最初の「len」バイトが同じである場合に true を返します。
文字列の UTF-8 エンコーディング (または EBCDIC マシンの UTF-EBCDIC エンコーディング)。
つまり、UTF-8 で不変である場合です。 ASCII っぽいマシンでは、すべての ASCII
この定義に適合するのは ASCII 文字だけです。 EBCDIC マシンでは、
ASCII 範囲の文字は不変ですが、C1 コントロールと
「\c?」 (これは EBCDIC の ASCII 範囲にありません)。

「len」が 0 の場合、strlen(s) を使用して計算されます (つまり、これを使用すると、
オプションでは、「s」に「NUL」文字を埋め込むことはできず、
終端「NUL」バイト）。

「is_utf8_string」()、「is_utf8_string_loclen」()、および「is_utfXNUMX_string_loclen」も参照してください。
「is_utf8_string_loc」()。

bool is_invariant_string(const U8 *s, STRLEN len)

is_utf8_string
文字列「s」の最初の「len」バイトが有効な UTF-8 文字列を形成する場合は true を返します。
それ以外の場合は false。 「len」が 0 の場合、strlen(s) を使用して計算されます (これは
このオプションを使用する場合、「s」には「NUL」文字を埋め込むことができないことを意味します。
終端「NUL」バイトが必要です)。すべての文字が ASCII であることに注意してください
「有効な UTF-8 文字列」を構成します。

「is_invariant_string」()、「is_utf8_string_loclen」()、および「is_invariant_string」も参照してください。
「is_utf8_string_loc」()。

bool is_utf8_string(const U8 *s, STRLEN len)

is_utf8_string_loc
「is_utf8_string」と似ていますが、失敗の場所を保存します（次の場合）
"utf8ness failed") または場所 "s"+"len" ("utf8ness success" の場合)
「ep」で。

「is_utf8_string_loclen」() および「is_utf8_string」() も参照してください。

bool is_utf8_string_loc(const U8 *s, STRLEN len,
const U8 **ep)

is_utf8_string_loclen
"is_utf8_string"() と似ていますが、失敗の場所を保存します (
"utf8ness failed") または場所 "s"+"len" ("utf8ness success" の場合)
「ep」には UTF-8 でエンコードされた文字の数、「el」には UTF-XNUMX でエンコードされた文字の数が入ります。

「is_utf8_string_loc」() および「is_utf8_string」() も参照してください。

bool is_utf8_string_loclen(const U8 *s, STRLEN len,
const U8 **ep、STRLEN *el)

pv_uni_display
スカラー「dsv」に、文字列「spv」、長さ「len」の表示可能なバージョンを構築します。
表示可能なバージョンの長さは最大でも「pvlim」バイトです (それ以上の場合、残りは
切り詰められ、「...」が追加されます)。

「flags」引数には、表示するように UNI_DISPLAY_ISPRINT を設定できます。 isPRINT()できる
文字自体をそのまま表示し、UNI_DISPLAY_BACKSLASH で \\[nrfta\\] を表示します。
バックスラッシュ付きバージョン (「\n」など) (UNI_DISPLAY_BACKSLASH が優先されます)
\\ の場合は UNI_DISPLAY_ISPRINT)。 UNI_DISPLAY_QQ (およびそのエイリアス UNI_DISPLAY_REGEX)
UNI_DISPLAY_BACKSLASH と UNI_DISPLAY_ISPRINT の両方をオンにします。

「dsv」のPVへのポインタが返されます。

「sv_uni_display」も参照してください。

char* pv_uni_display(SV *dsv, const U8 *spv,
STRLEN len、STRLEN pvlim、
UVフラグ)

sv_cat_decode
エンコードは Encode オブジェクトであると想定され、SSV の PV は次のように想定されます。
そのエンコードとデコードのオクテットは、入力が開始される位置 (PV
+ *オフセット) を指しました。 DSV は、デコードされた UTF-8 文字列を連結します。
ＳＳＶ。デコード出力に文字列 tstr が表示されるか、または
入力は ssv の PV で終了します。オフセットポイントとなる値
ssv 上の最後の入力位置に変更されます。

ターミネータが見つかった場合は TRUE を返し、それ以外の場合は FALSE を返します。

bool sv_cat_decode(SV* dsv, SV *エンコーディング, SV *ssv,
int *offset, char* tstr, int tlen)

sv_recode_to_utf8
エンコーディングは Encode オブジェクトであると想定され、エントリ時に SV の PV は次のようになります。
そのエンコーディングではオクテットであるとみなされ、SV は Unicode に変換されます。
(およびUTF-8)。

SV がすでに UTF-8 である場合 (または POK ではない場合)、またはエンコーディングが
参照、SV には何も行われません。エンコードが「Encode::XS」でない場合
オブジェクトをエンコードすると、悪いことが起こります。 （見る lib/encoding.pm エンコードします。)

SV の PV が返されます。

char* sv_recode_to_utf8(SV* sv, SV *エンコーディング)

sv_uni_display
スカラー「dsv」に対して、スカラー「sv」の表示可能なバージョンを構築します。
表示可能なバージョンの長さは最大でも「pvlim」バイトです (それ以上の場合、残りは
切り詰められ、「...」が追加されます)。

「flags」引数は「pv_uni_display」() と同様です。

「dsv」のPVへのポインタが返されます。

char* sv_uni_display(SV *dsv, SV *ssv, STRLEN pvlim,
UVフラグ)

to_utf8_case
「p」には、文字をエンコードする UTF-8 文字列へのポインタが含まれます。
変換された。このルーチンは、「p」の文字が整形式であることを前提としています。

"ustrp" は、変換結果を格納する文字バッファへのポインタです。
「lenp」は結果の長さへのポインタです。

「swashp」は、使用するスワッシュへのポインタです。

特別なマッピングと通常のマッピングの両方が次の場所に保存されます。 lib/unicore/To/Foo.pl,
SWASHNEW によってロードされ、使用して lib/utf8_heavy.pl。 「特別な」（通常はそうではありませんが、
複数文字のマッピング) が最初に試行されます。

「special」は文字列で、通常は「NULL」または「」です。 「NULL」は、特別な処理を行わないことを意味します。
マッピング; 「」は特別なマッピングを使用することを意味します。この2つ以外の値は、
次のような特別なマッピングを含むハッシュの名前として扱われます。
「utf8::ToSpecLower」。

「normal」は「ToLower」のような文字列で、スワッシュ %utf8::ToLower を意味します。

UV to_utf8_case(const U8 *p, U8* ustrp,
STRLEN *lenp、SV **スワッシュ、
const char *通常、
const char *特殊)

to_utf8_fold
代わりに「toFOLD_utf8」を使用してください。

UV to_utf8_fold(const U8 *p, U8* ustrp,
STRLEN *lenp)

to_utf8_ lower
代わりに「toLOWER_utf8」を使用してください。

UV to_utf8_ lower(const U8 *p, U8* ustrp,
STRLEN *lenp)

to_utf8_title
代わりに「toTITLE_utf8」を使用してください。

UV to_utf8_title(const U8 *p, U8* ustrp,
STRLEN *lenp)

to_utf8_upper
代わりに「toUPPER_utf8」を使用してください。

UV to_utf8_upper(const U8 *p, U8* ustrp,
STRLEN *lenp)

utf8n_to_uvchr
この機能は、非常に特殊な状況でのみ使用してください。ほとんどのコード
これを直接呼び出すのではなく、「utf8_to_uvchr_buf」() を使用する必要があります。

最下位レベルの UTF-8 デコード ルーチン。のネイティブ コード ポイント値を返します。
文字列「s」の最初の文字。UTF-8 (または UTF-EBCDIC) であると想定されます。
エンコーディングであり、「curlen」バイト以下であること。 *retlen (「retlen」が NULL でない場合)
その文字の長さをバイト単位で設定します。

「flags」の値は、「s」がウェルを指していない場合の動作を決定します。
形成された UTF-8 文字。 flags が 0 の場合、奇形が見つかった場合は XNUMX になります。
返され、*retlen が ("s" + *retlen) が次に可能な位置になるように設定されます。
「s」では、不正ではない文字を始めることができます。また、UTF-8 の警告が表示された場合は、
字句的に無効になっていない場合は、警告が発生します。

さまざまな ALLOW フラグを「フラグ」に設定して、個々のアクセスを許可する (警告しない) ことができます。
シーケンスが長すぎる（つまり、
同じコードポイントを表現できる短いシーケンスです。長すぎるシーケンスは
潜在的なセキュリティ問題のため、UTF-8 標準では明示的に禁止されています)。
もう 1 つの不正な例は、文字の最初のバイトが正当なものではないことです。
最初のバイト。見る utf8.h そのようなフラグのリストについては、許可される長さ 0 の文字列の場合、
この関数は 0 を返します。許可された長すぎるシーケンスの場合、計算されたコード ポイント
が返されます。他の許可されているすべての不正な形式については、Unicode REPLACEMENT
これらには決定可能な妥当な値がないため、CHARACTER が返されます。

UTF8_CHECK_ONLY フラグは、(他のユーザーによって) 許可されていない場合の動作をオーバーライドします。
flags) の奇形が見つかりました。このフラグが設定されている場合、ルーチンは次のように仮定します。
呼び出し元は警告を出しますが、この関数は黙って "retlen" を次のように設定するだけです。
「-1」(「STRLEN」にキャスト) はゼロを返します。

この API では、「NUL」のデコードが成功したかどうかを明確にする必要があることに注意してください。
次のように、文字が入力され、エラーが返されます (UTF8_CHECK_ONLY フラグが設定されていない場合)。
どちらの場合も、0 が返されます。曖昧さを避けるために、ゼロが返されたときに、最初の
"s" のバイトも 0 です。そうである場合、入力は「NUL」でした。そうでない場合は、入力に
エラー。

特定のコードポイントには問題があると考えられます。これらは Unicode サロゲートです。
Unicode の非文字、および Unicode の最大値 0x10FFFF を超えるコード ポイント。による
デフォルトでは、これらは通常のコードポイントとみなされますが、特定の状況では、
彼らに対する特別な対応。 「flags」に UTF8_DISALLOW_ILLEGAL_INTERCHANGE が含まれる場合、
3 つのクラスはすべて奇形として扱われ、そのように扱われます。旗
UTF8_DISALLOW_SURROGATE、UTF8_DISALLOW_NONCHAR、および UTF8_DISALLOW_SUPER (意味
法的な Unicode の最大値を超える）これらのカテゴリを禁止するように設定できます
個別に

フラグ UTF8_WARN_ILLEGAL_INTERCHANGE、UTF8_WARN_SURROGATE、UTF8_WARN_NONCHAR、
および UTF8_WARN_SUPER により、それぞれの警告メッセージが生成されます。
カテゴリが含まれていますが、それ以外の場合、コード ポイントは有効であると見なされます (そうでない場合)。
奇形）。カテゴリーを奇形として扱い、引き上げるには
警告の場合は、WARN フラグと DISALLOW フラグの両方を指定します。 (ただし、警告は次のとおりです。
字句的に無効になっている場合、または UTF8_CHECK_ONLY も指定されている場合は発生しません。)

非常に大きなコード ポイント (0x7FFF_FFFF 以上) は、より問題があると考えられます。
その他は Unicode の法定最大値を超えています。理由はいくつかあります。
ASCII プラットフォームで表現するには少なくとも 32 ビットが必要ですが、そうではありません。
EBCDIC プラットフォームと元の UTF-8 仕様ではまったく表現可能です
この数値を超えることはありません (現在の 0x10FFFF 制限は後で課されました)。 (
小さいもの、つまり 32 ビットに収まるものは、ASCII の UV で表現できます。
これは、実行できる操作の数を意味します。
ASCII プラットフォームでの UTF-8 エンコードはかなり制限されています。
これらの大きなコード ポイントは、0xFE または 0xFF を含むバイトで始まります。の
UTF8_DISALLOW_FE_FF フラグを指定すると、それらは不正なものとして扱われますが、
Unicode より小さいコード ポイントを許可します。 (もちろん、UTF8_DISALLOW_SUPER は
これらを含め、Unicode より上のすべてのコード ポイントを不正なものとして扱います。)
同様に、UTF8_WARN_FE_FF は他の WARN フラグと同様に動作しますが、適用されるのは
これらのコードポイントに。

Unicode 文字に対応する他のすべてのコード ポイント (私的使用を含む)
そして、まだ割り当てられていないものは、決して不正とはみなされず、警告もされません。

UV utf8n_to_uvchr(const U8 *s, STRLENcurlen,
STRLEN *retlen、U32 フラグ)

utf8n_to_uvuni
代わりに「utf8_to_uvchr_buf」を使用するか、まれに「utf8n_to_uvchr」を使用します。

この関数は、EBCDIC と ASCII の両方を処理するコードに便利でした。
Unicode プロパティを持つプラットフォームですが、Perl v5.20 以降では、その区別がなくなりました。
プラットフォーム間のやり取りは、ほとんどのコードからは見えないようになっているため、
機能があなたが望むものになる可能性は非常に低いです。この正確な情報が必要な場合は、
機能の場合は、代わりに「NATIVE_TO_UNI(utf8_to_uvchr_buf(...))」を使用するか、
「NATIVE_TO_UNI(utf8n_to_uvchr(...))」。

UV utf8n_to_uvuni(const U8 *s, STRLENcurlen,
STRLEN *retlen、U32 フラグ)

UTF8スキップ
UTF-8 でエンコードされた文字のバイト数を返します。その最初の文字 (おそらく
のみ）バイトは「s」で示されます。

STRLEN UTF8SKIP(char* s)

utf8_距離
UTF-8 ポインター「a」と「b」の間の UTF-8 文字数を返します。

警告: ポインタが同じ UTF-8 内を指していることが「わかっている」場合にのみ使用してください。
バッファ。

IV utf8_ distance(const U8 *a, const U8 *b)

utf8_ホップ
「off」文字で置き換えられた UTF-8 ポインタ「s」を前方または
後方。

警告: 「off」が UTF-8 データ内にあることを*知っている*場合を除き、次のコマンドを使用しないでください。
"s" によって指される * そして * エントリでは "s" がその最初のバイトに位置合わせされる
文字、または文字の最後のバイトの直後。

U8* utf8_hop(const U8 *s、I32 オフ)

utf8_length
UTF-8 文字でエンコードされた文字列「s」の長さを文字数で返します。に停車します
「e」（両端を含む）。 「e < s」の場合、またはスキャンが「e」を超えて終了する場合は、鳴きます。

STRLEN utf8_length(const U8* s, const U8 *e)

utf8_to_bytes
注: この機能は実験的なものであり、予告なく変更または削除される場合があります。

長さ「len」の文字列「s」を UTF-8 からネイティブのバイトエンコーディングに変換します。
「bytes_to_utf8」とは異なり、これは元の文字列を上書きし、「len」を次のように更新します。
新しい長さが含まれます。失敗した場合は 1 を返し、「len」を -XNUMX に設定します。

文字列のコピーが必要な場合は、「bytes_from_utf8」を参照してください。

U8* utf8_to_bytes(U8 *s, STRLEN *len)

utf8_to_uvchr_buf
文字列「s」の最初の文字のネイティブ コード ポイントを返します。
UTF-8 エンコードであると想定されます。 "send" は "s" の末尾を超えた 1 を指します。
*retlen は、その文字の長さ (バイト単位) に設定されます。

「s」が整形式の UTF-8 文字を指していない場合、UTF8 警告が表示されます。
有効な場合、ゼロが返され、*retlen が (「retlen」が NULL でない場合) -1 に設定されます。もし
これらの警告はオフになり、明確に定義されている場合は計算値 (または Unicode
そうでない場合は REPLACEMENT CHARACTER)、サイレントに返され、*retlen が設定されます (場合
"retlen" は NULL ではない)、そのため ("s" + *retlen) が "s" 内の次の可能な位置になります。
それは、不正ではない文字を開始する可能性があります。 詳細については、「utf8n_to_uvchr」を参照してください。
REPLACEMENT CHARACTER が返されたとき。

UV utf8_to_uvchr_buf(const U8 *s, const U8 *send,
STRLEN *リレン)

utf8_to_uvuni_buf
廃止されました! この関数は Perl の将来のリリースから削除される予定です。
新しいコードには使用しないでください。 既存のコードから削除してください。

コードで Unicode を扱う必要があるのは非常にまれな状況です (
ネイティブとは対照的) コードポイント。それらの少数のケースでは、次を使用します
代わりに「NATIVE_TO_UNI(utf8_to_uvchr_buf(...))」を使用します。

文字列の最初の文字の Unicode (非ネイティブ) コード ポイントを返します。
「s」は UTF-8 エンコーディングであると想定されます。 "send" は末尾を超えて 1 を指します。
「す」。 「retlen」は、その文字の長さ (バイト単位) に設定されます。

「s」が整形式の UTF-8 文字を指していない場合、UTF8 警告が表示されます。
有効な場合、ゼロが返され、*retlen が (「retlen」が NULL でない場合) -1 に設定されます。もし
これらの警告はオフであり、明確に定義されている場合は計算値 (または Unicode
REPLACEMENT CHARACTER (そうでない場合) がサイレントに返され、*retlen が設定されます (そうでない場合)。
"retlen" は NULL ではない)、そのため ("s" + *retlen) が "s" 内の次の可能な位置になります。
それは、不正ではない文字を開始する可能性があります。 詳細については、「utf8n_to_uvchr」を参照してください。
REPLACEMENT CHARACTER が返されたとき。

UV utf8_to_uvuni_buf(const U8 *s, const U8 *send,
STRLEN *リレン)

UVCHR_SKIP
エンコード時にコードポイント「cp」を表すために必要なバイト数を返します。
UTF-8として。 「cp」は、255 未満の場合はネイティブ (ASCII または EBCDIC) コード ポイントです。ある
それ以外の場合は Unicode コード ポイント。

STRLEN UVCHR_SKIP(UV cp)

uvchr_to_utf8
ネイティブ コード ポイント「uv」の UTF-8 表現を末尾に追加します。
文字列「d」; 「d」には少なくとも「UVCHR_SKIP(uv)+1」(最大「UTF8_MAXBYTES+1」)が必要です
無料のバイトが利用可能です。戻り値は終了後のバイトへのポインタです。
新キャラクターの。言い換えると、

d = uvchr_to_utf8(d, uv);

ワイドネイティブ文字を意識した推奨の言い方です

*(d++) = 紫外線;

この関数は、任意の UV を入力として受け入れます。非 Unicode コードを禁止または警告するには
問題がある可能性のある点については、「uvchr_to_utf8_flags」を参照してください。

U8* uvchr_to_utf8(U8 *d, UV uv)

uvchr_to_utf8_flags
ネイティブ コード ポイント「uv」の UTF-8 表現を末尾に追加します。
文字列「d」; 「d」には少なくとも「UVCHR_SKIP(uv)+1」(最大「UTF8_MAXBYTES+1」)が必要です
無料のバイトが利用可能です。戻り値は終了後のバイトへのポインタです。
新キャラクターの。言い換えると、

d = uvchr_to_utf8_flags(d, uv, flags);

または、ほとんどの場合、

d = uvchr_to_utf8_flags(d, uv, 0);

これは Unicode を意識した言い方です

*(d++) = 紫外線;

この関数は、UTF-8 ではないコードポイントでも UTF-XNUMX に変換します (警告はしません)。
「フラグ」に 1 つ以上の Unicode が含まれていない限り、法的な Unicode であるか、問題がある
次のフラグ:

「uv」が Unicode サロゲート コード ポイントであり、UNICODE_WARN_SURROGATE が設定されている場合、
UTF8 警告が有効になっている場合、関数は警告を生成します。代わりに
UNICODE_DISALLOW_SURROGATE が設定されている場合、関数は失敗し、NULL を返します。もし
両方のフラグが設定されている場合、関数は警告を出し、NULL を返します。

UNICODE_WARN_NONCHAR フラグと UNICODE_DISALLOW_NONCHAR フラグは、
この関数は Unicode の非文字を処理します。同様に、UNICODE_WARN_SUPER
UNICODE_DISALLOW_SUPER フラグは、上記のコード ポイントの処理に影響します。
Unicode の最大値は 0x10FFFF です。 0x7FFF_FFFF を超えるコード ポイント (偶数
移植性が低い) は、他の Unicode コードを超える場合でも、警告および/または禁止される可能性があります。
ポイントは、UNICODE_WARN_FE_FF フラグと UNICODE_DISALLOW_FE_FF フラグによって受け入れられます。

最後に、フラグ UNICODE_WARN_ILLEGAL_INTERCHANGE は、次の 4 つすべてを選択します。
上記の WARN フラグ。 UNICODE_DISALLOW_ILLEGAL_INTERCHANGE は 4 つすべてを選択します
フラグを禁止します。

U8* uvchr_to_utf8_flags(U8 *d、UV uv、UV フラグ)

uvoffuni_to_utf8_flags
この機能は、非常に特殊な状況でのみ使用してください。その代わり、
ほとんど を コード すべき つかいます 「uvchr_to_utf8」 or 「uvchr_to_utf8_flags」.

この関数はそれらと似ていますが、入力は厳密な Unicode です (
ネイティブ）コードポイント。非常にまれな状況でのみ、コードで
ネイティブコードポイント。

詳細は「uvchr_to_utf8_flags」の説明を参照してください。

U8* uvoffuni_to_utf8_flags(U8 *d、UV uv、UV フラグ)

uvuni_to_utf8_flags
代わりに、ほぼ確実に「uvchr_to_utf8」または「uvchr_to_utf8_flags」を使用する必要があります。

この関数は、「uvoffuni_to_utf8_flags」の非推奨の同義語であり、それ自体は、
非推奨ではありませんが、孤立した状況でのみ使用する必要があります。これら
関数は、EBCDIC と ASCII の両方を処理するコードに便利でした
Unicode プロパティを持つプラットフォームですが、Perl v5.20 以降では、その区別がなくなりました。
プラットフォーム間のやり取りは、ほとんどのコードからは見えないようになっているため、
機能があなたが望むものになる可能性は非常に低いです。

U8* uvuni_to_utf8_flags(U8 *d、UV uv、UV フラグ)

Variables 作成した by 「xsubpp」 と 「xsubpp」 内部 機能

新しいXSプロト
XSUB を Perl サブルーチンとして接続するために「xsubpp」によって使用されます。 Perl プロトタイプをサブルーチンに追加します。

XS_APIVERSION_BOOTCHECK
XS モジュールがコンパイルされた Perl API バージョンを確認するマクロ
ロード先の Perl インタープリターの API バージョンと一致します。

XS_APIVERSION_BOOTCHECK;

XS_VERSION
XS モジュールのバージョン識別子。通常、これは自動的に処理されます。
「ExtUtils::MakeMaker」。 「XS_VERSION_BOOTCHECK」を参照してください。

XS_VERSION_BOOTCHECK
PM モジュールの $VERSION 変数が XS モジュールの変数と一致することを確認するマクロ
「XS_VERSION」変数。これは通常、「xsubpp」によって自動的に処理されます。見る
perlxs の「VERSIONCHECK: キーワード」。

XS_VERSION_BOOTCHECK;

バージョン管理

新しいバージョン
SV で渡されたものに基づいて新しいバージョン オブジェクトを返します。

SV *sv = 新しいバージョン(SV *ver);

ver SV で渡されたものは変更しません。アップグレードする場合は、「upg_version」を参照してください。
SV。

SV* 新しいバージョン(SV *ver)

プレスキャン_バージョン
指定された文字列がバージョン オブジェクトとして解析できるかどうかを検証しますが、解析できないかどうかを検証します。
実際に解析を実行します。厳格な検証ルールまたは緩い検証ルールを使用できます。できる
オプションで、解析コードを保存するためにいくつかのヒント変数を設定します。
トークン化。

const char* prescan_version(const char *s, bool strict,
const char** errstr、
bool *sqv、
int *ssaw_10 進数、
int *swidth、bool *salpha)

スキャンバージョン
解析されたバージョン文字列の後の次の文字へのポインタも返します。
渡されたSVをRVにアップグレードする場合。

関数は、次のような既存の SV を使用して呼び出す必要があります。

SV = 新しいSV（0）;
s = scan_version(s, SV *sv, bool qv);

文字列に前処理を実行して、文字列が正しいことを確認します。
バージョンの特徴。オブジェクトにアンダースコアが含まれている場合にフラグを立てる
(これは、これがアルファ版であることを示します)。ブール値 qv は、バージョンが
たとえそうでなくても、複数の小数があるかのように解釈される必要があります。

const char* scan_version(const char *s, SV *rv, bool qv)

アップグレード_バージョン
提供された SV のバージョン オブジェクトへのインプレース アップグレード。

SV *sv = upg_version(SV *sv, bool qv);

アップグレードされた SV へのポインタを返します。強制したい場合はブール値 qv を設定します
この SV は「拡張」バージョンとして解釈されます。

SV* upg_version(SV *ver, bool qv)

vcmp バージョンオブジェクト認識 cmp。両方のオペランドが既に次のように変換されている必要があります。
バージョンオブジェクト。

int vcmp(SV *lhv, SV *rhv)

vnormal バージョン オブジェクトを受け入れ、正規化された文字列表現を返します。電話
以下のように：

sv = vnormal(rv);

注: オブジェクトを直接渡すことも、RV 内に含まれる SV を渡すこともできます。

返される SV の refcount は 1 です。

SV* vnormal(SV *vs)

vnumify バージョン オブジェクトを受け入れ、正規化された浮動小数点表現を返します。
次のように呼び出します。

sv = vnumify(rv);

注: オブジェクトを直接渡すことも、RV 内に含まれる SV を渡すこともできます。

返される SV の refcount は 1 です。

SV* vnumify(SV *vs)

vstringify
Perl の以前のバージョンとの互換性を最大限に維持するために、これは
関数は浮動小数点表記または複数のドットを返します。
元のバージョンに 1 つ以上のドットが含まれているかどうかに応じて表記します。
。

返される SV の refcount は 1 です。

SV* vstringify(SV *vs)

vverify SV にバージョン オブジェクトの有効な内部構造が含まれていることを検証します。それ
バージョン オブジェクト (RV) またはハッシュ自体 (HV) のいずれかを渡すことができます。もし
構造体が有効な場合、HV を返します。構造体が無効な場合は、戻り値が返されます。
ヌル。

SV *hv = vverify(sv);

最低限の構造のみを確認していることに注意してください（混乱しないように）
追加のハッシュ エントリを含む可能性がある派生クラスによる):

SV* vverify(SV *vs)

警告 と 死ぬ

croak これは、Perl の「die」関数への XS インターフェイスです。

sprintf スタイルのフォーマット パターンと引数リストを取得します。これらは生成するために使用されます
文字列メッセージ。 メッセージが改行で終わっていない場合は、次のようになります。
説明されているように、コード内の現在の位置を示すものを追加して拡張されています。
「mess_sv」の場合。

エラー メッセージは例外として使用され、デフォルトで制御が返されます。
最も近い囲み「eval」ですが、$SIG{__DIE__} によって変更される可能性があります。
ハンドラ。いずれにせよ、「croak」関数は正常に戻ることはありません。

歴史的な理由により、「pat」が null の場合、「ERRSV」($@) の内容は次のようになります。
からエラー メッセージを作成する代わりに、エラー メッセージまたはオブジェクトとして使用されます。
引数。文字列以外のオブジェクトをスローする場合、またはエラー メッセージを作成する場合は、
SV を自分で使用する場合は、「croak_sv」関数を使用することをお勧めします。
「ERRSV」の破壊が含まれます。

void croak(const char *pat, ...)

croak_no_modify
「Perl_croak(aTHX_ "%s", PL_no_modify)」とまったく同じですが、terser を生成します。
「Perl_croak」を使用するよりもオブジェクトコードを変更します。例外コードパスで使用されるコードが少なくなる
CPU キャッシュの負荷を軽減します。

void croak_no_modify()

croak_sv
これは、Perl の「die」関数への XS インターフェイスです。

「baseex」はエラー メッセージまたはオブジェクトです。参考になれば使わせていただきます
そのまま。それ以外の場合は文字列として使用され、改行で終わらない場合は
その後、コード内の現在の位置を示すものを使用して拡張されます。
「mess_sv」で説明したとおりです。

エラー メッセージまたはオブジェクトは例外として使用され、デフォルトで返されます。
コントロールは最も近い囲み「eval」に設定されますが、
$SIG{__DIE__} ハンドラー。いずれの場合も、「croak_sv」関数は戻りません。
正常に。

単純な文字列メッセージで終了するには、「croak」関数の方が便利かもしれません。

void croak_sv(SV *baseex)

die 戻り値の型を除き、「croak」と同じように動作します。のみ使用する必要があります
ここで、「OP *」戻り値の型は必須です。関数が実際に戻ることはありません。

OP * die(const char *pat, ...)

die_sv 戻り値の型を除き、「croak_sv」と同じように動作します。使用する必要があります
"OP *" 戻り値の型が必要な場合のみ。この関数は実際には決して
戻る。

OP * die_sv(SV *baseex)

vcroak これは、Perl の「die」関数への XS インターフェイスです。

「pat」と「args」は sprintf スタイルの形式パターンとカプセル化された引数です
リスト。 これらは文字列メッセージを生成するために使用されます。 メッセージが終わらない場合
改行を使用すると、現在の内容を示すもので拡張されます。
「mess_sv」で説明されているように、コード内の場所。

エラー メッセージは例外として使用され、デフォルトで制御が返されます。
最も近い囲み「eval」ですが、$SIG{__DIE__} によって変更される可能性があります。
ハンドラ。いずれにせよ、「croak」関数は正常に戻ることはありません。

歴史的な理由により、「pat」が null の場合、「ERRSV」($@) の内容は次のようになります。
からエラー メッセージを作成する代わりに、エラー メッセージまたはオブジェクトとして使用されます。
引数。文字列以外のオブジェクトをスローする場合、またはエラー メッセージを作成する場合は、
SV を自分で使用する場合は、「croak_sv」関数を使用することをお勧めします。
「ERRSV」の破壊が含まれます。

void vcroak(const char *pat, va_​​list *args)

vwarn これは、Perl の「warn」関数への XS インターフェイスです。

「pat」と「args」は sprintf スタイルの形式パターンとカプセル化された引数です
リスト。 これらは文字列メッセージを生成するために使用されます。 メッセージが終わらない場合
改行を使用すると、現在の内容を示すもので拡張されます。
「mess_sv」で説明されているように、コード内の場所。

エラー メッセージまたはオブジェクトはデフォルトで標準エラーに書き込まれますが、
$SIG{__WARN__} ハンドラーによって変更される可能性があります。

「vcroak」とは異なり、「pat」を null にすることはできません。

void vwarn(const char *pat, va_​​list *args)

warn これは、Perl の「warn」関数への XS インターフェイスです。

sprintf スタイルのフォーマット パターンと引数リストを取得します。これらは生成するために使用されます
文字列メッセージ。 メッセージが改行で終わっていない場合は、次のようになります。
説明されているように、コード内の現在の位置を示すものを追加して拡張されています。
「mess_sv」の場合。

エラー メッセージまたはオブジェクトはデフォルトで標準エラーに書き込まれますが、
$SIG{__WARN__} ハンドラーによって変更される可能性があります。

「croak」とは異なり、「pat」を null にすることはできません。

void warn(const char *pat, ...)

warn_sv これは、Perl の「warn」関数への XS インターフェイスです。

「baseex」はエラー メッセージまたはオブジェクトです。参考になれば使わせていただきます
そのまま。それ以外の場合は文字列として使用され、改行で終わらない場合は
その後、コード内の現在の位置を示すものを使用して拡張されます。
「mess_sv」で説明したとおりです。

エラー メッセージまたはオブジェクトはデフォルトで標準エラーに書き込まれますが、
$SIG{__WARN__} ハンドラーによって変更される可能性があります。

単純な文字列メッセージで警告するには、「warn」関数の方が便利です。

void warn_sv(SV *baseex)

文書化されていない 機能

次の関数はパブリック API の一部としてフラグが立てられていますが、現在は
文書化されていない。インターフェースは変更される可能性があるため、自己責任で使用してください。
このドキュメントに記載されていない機能は一般公開を目的としていないため、公開する必要があります。
いかなる状況でも使用しないでください。

以下の文書化されていない関数のいずれかを使用する場合は、
そのための書類を提出すること。パッチが受け入れられた場合、これは、
インターフェイスは安定しています (明示的に別のマークが付けられていない限り)。

GetVars
Gv_AM更新
PerlIO_clearrr
PerlIO_close
PerlIO_context_layers
PerlIO_eof
PerlIO_エラー
PerlIO_ファイル番号
PerlIO_fill
PerlIO_flush
PerlIO_get_base
PerlIO_get_bufsiz
PerlIO_get_cnt
PerlIO_get_ptr
PerlIO_read
PerlIO_seek
PerlIO_set_cnt
PerlIO_set_ptrcnt
PerlIO_setlinebuf
PerlIO_stderr
PerlIO_stdin
PerlIO_stdout
PerlIO_tell
PerlIO_未読
PerlIO_write
amagic_call
amagic_deref_call
any_dup
atfork_lock
atfork_unlock
av_arylen_p
av_iter_p
block_gimme
call_atexit
呼び出しリスト
呼び出し
キャスト_i32
キャスト_iv
キャスト_ulong
キャスト_uv
ck_warner
ck_warner_d
警告する
ckwarn_d
clone_params_del
clone_params_new
croak_memory_wrap
croak_nocontext
cighandler
cx_ダンプ
cx_dup
cxinc
deb
deb_nocontext
デバップ
デブプロフダンプ
デブスタック
debstackptrs
破綻
ディスパッチ_シグナル
die_nocontext
dirp_dup
do_aspawn
do_binmode
do_close
do_gv_dump
do_gvgv_dump
do_hv_dump
do_join
do_magic_dump
do_op_dump
do_open
do_open9
do_openn
do_pmop_dump
do_spawn
do_spawn_nowait
do_sprintf
do_sv_dump
汚染行為
ドレフ
風下
ダワンタレイ
dump_eval
ダンプフォーム
dump_indent
dump_mstats
ダンプサブ
dump_vindent
フィルター追加
フィルターデル
フィルター読み取り
フォールドEQ_latin1
form_nocontext
fp_dup
fprintf_nocontext
free_global_struct
free_tmps
get_context
get_mstats
get_op_descs
get_op_names
get_paddr
get_vtbl
gp_dup
gp_free
gp_ref
gv_AVadd
gv_HVadd
gv_IOadd
gv_SVadd
gv_add_by_type
gv_autoload4
gv_autoload_pv
gv_autoload_pvn
gv_autoload_sv
gv_check
gv_ダンプ
gv_efullname
gv_efullname3
gv_efullname4
gv_fetchfile
gv_fetchfile_flags
gv_fetchpv
gv_fetchpvn_flags
gv_fetchsv
gv_フルネーム
gv_フルネーム3
gv_フルネーム4
gv_handler
gv_name_set
彼_dup
hek_dup
hv_common
hv_common_key_len
hv_delayfree_ent
hv_eiter_p
hv_eiter_set
hv_free_ent
hv_ksplit
hv_name_set
hv_placeholders_get
hv_placeholders_set
hv_rand_set
hv_liter_p
hv_liter_set
ibcmp_utf8
init_global_struct
初期化スタック
init_tm
命令
is_lvalue_sub
Leave_scope
load_module_nocontext
マジックダンプ
malloc関数
マークスタック_グロー
混乱のコンテキスト
無料
mg_dup
mg_size
mini_mktime
より多くのスイッチ
mro_get_from_name
mro_get_private_data
mro_set_mro
mro_set_private_data
my_atof
my_atof2
my_bcopy
my_bzero
my_chsize
my_cxt_index
my_cxt_init
my_dirfd
私の出口
my_failure_exit
my_fflush_all
私のフォーク
my_lstat
my_memcmp
my_memset
my_pclose
my_popen
my_popen_list
my_setenv
私のソケットペア
my_stat
私のstrftime
新しいANONATTRSUB
newアノンハッシュ
新しいANONLIST
新しいANOSUB
新しいATTRSUB
新しいAVREF
新しいCVREF
新しいフォーム
新しいGVREF
新しいGVgen
newGVgen_flags
新しいHVREF
新しいHVhv
新しいIO
新しいマイサブ
新しいPROG
新しいRV
新しいサブ
新しいSVREF
newSVpvf_nocontext
新しいスタック情報
忍者
op_refcnt_lock
op_refcnt_unlock
パーサー_dup
perl_alloc_using
perl_clone_using
pmop_dump
ポップスコープ
プレグコンプ
pregexec
プレグフリー
プレグフリー2
printf_nocontext
ptr_table_fetch
ptr_table_free
ptr_table_new
ptr_table_split
ptr_table_store
プッシュスコープ
再コンパイル
re_dup_ガッツ
re_intuit_start
re_intuit_string
再割り当て
リエントラントフリー
reentrant_init
再入可能_再試行
reentrant_size
参照
reg_named_buff_all
reg_named_buff_exists
reg_named_buff_fetch
reg_named_buff_firstkey
reg_named_buff_nextkey
reg_named_buff_scalar
regclass_swash
regdump
regdupe_internal
regexec_flags
regfree_internal
色を再設定する
次へ
繰り返します
ニンスト
信号
rsignal_state
runops_debug
runops_standard
rvpv_dup
安全なsyscalloc
セーフシスフリー
セーフシスロック
セーフシスリアロック
保存_I16
保存_I32
保存_I8
save_adelete
保存_aelem
save_aelem_flags
保存_割り当て
保存_aptr
保存
保存ブール
save_clearsv
保存_削除
セーブデストラクター
セーブ_デストラクター_x
save_freeop
save_freepv
save_freesv
save_generic_pvref
save_generic_svref
セーブ_GP
ハッシュの保存
保存_h削除
セーブ_ヘレム
save_helem_flags
ヒントの保存
保存_hptr
save_int
アイテムの保存
保存_iv
保存リスト
長く保存
save_mortalizesv
save_nogv
保存操作
save_padsv_and_mortalize
保存_pptr
save_pushi32ptr
save_pushtr
save_pushptrptr
コンテキストの保存
保存_スカラー
save_set_svflags
save_shared_pvref
保存_sptr
セーブ_svref
セーブ_vptr
セーブスタック_グロー
savestack_grow_cnt
スキャン番号
scan_vstring
シード
セットコンテキスト
set_numeric_local
set_numeric_radix
set_numeric_standard
シェアヘク
si_dup
ss_dup
stack_grow
start_subparse
str_to_version
sv_2iv
sv_2pv
sv_2uv
sv_catpvf_mg_nocontext
sv_catpvf_nocontext
sv_dup
sv_dup_inc
sv_peek
sv_pvn_nomg
sv_setpvf_mg_nocontext
sv_setpvf_nocontext
スワッシュフェッチ
swash_init
sys_init
sys_init3
sys_intern_clear
sys_intern_dup
sys_intern_init
システム用語
taint_env
taint_proper
リンクを外す
共有解除
utf16_to_utf8
utf16_to_utf8_reversed
uvuni_to_utf8
ヴデブ
フォーム
vload_module
vnewSVpvf
ヴワーナー
warn_nocontext
ワーナー
warner_nocontext
ウィッチ
whatsig_pv
whatsig_pvn
どのシグ_sv

作者

1997 年 XNUMX 月まで、この文書はジェフ・オカモトによって管理されていました。[メール保護]>。 それは
現在、Perl 自体の一部として維持されています。

Dean Roehrich、Malcolm Beattie、Andreas Koenig からの多くの支援と提案により、
ポール・ハドソン、イリヤ・ザカレヴィッチ、ポール・マーキス、ニール・バウワーズ、マシュー・グリーン、ティム・バンス、
スパイダー・ボードマン、ウルリッヒ・ファイファー、スティーブン・マッカマント、グルサミー・サラシー。

Dean Roehrich による API リスト[メール保護]>.

Benjamin Stuhl によるソース内のコメントから自動生成されるように更新されました。

onworks.net サービスを使用して perlapi オンラインを使用する