stackTrace

ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

stackTrace [-dump] [-parameterCount uint] [-parameterType uint uint] [-parameterValue uint uint] [-state boolean]

stackTrace は、取り消し可能、照会可能、および編集不可能です。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-dump(-d)
MEL コールの現在のスタックをダンプします。
-parameterCount(-pc)	uint
特定のスタック レベルでの関数のパラメータ数を整数で返します。
-parameterType(-pt)	uint uint
特定のスタック レベルで指定された関数パラメータのタイプを文字列で返します。引数は次のとおりです。スタック インデックス、パラメータ インデックス。戻り値は、int、int[]、float、float[]、vector、vector[]、string、string[] です。
-parameterValue(-pv)	uint uint
特定のスタック レベルで指定された関数パラメータの値を返します。戻り値のタイプはパラメータの実際のタイプに一致します。例外はベクトルおよびベクトル配列で、float 配列として返されます。しかし、これらの結果をベクトル/ベクトル配列に割り当てることが可能で、投影は自動的に行われます(後述の MEL の例を参照)。引数は次のとおりです。スタック インデックス、パラメータ インデックス。
-state(-s)	boolean
MEL スタック トレースの表示をオンまたはオフにします。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// Have the stack trace show up on MEL script errors
stackTrace -state on;
// No stack trace for MEL script errors
stackTrace -state off;

// The following is an example of the use of the parameterCount/Type/Value flags.
// A function is defined which uses stackTrace to examine its own inputs.
proc foo( int $inty, int $intya[], float $floaty, float $floatya[], string $stringy, string $stringya[], vector $vectory, vector $vectorya[] )
{
	string $dump[] = `stackTrace -q -d`;
	print( $dump[0] );
	int $count = `stackTrace -pc 0`;
	print( "parameter count: " + $count + "\n" );
	int $i;
	for ( $i=0; $i<$count; $i++ )
	{
		string $type = `stackTrace -pt 0 $i`;
		print( "parameter " + $i + " type: " + $type + "\n" );
		switch ( $type )
		{
		case "int":
			int $val_i = `stackTrace -pv 0 $i`;
			print( "   value: " + $val_i + "\n" );
			break;
		case "float":
			float $val_f = `stackTrace -pv 0 $i`;
			print( "   value: " + $val_f + "\n" );
			break;
		case "string":
			string $val_s = `stackTrace -pv 0 $i`;
			print( "   value: " + $val_s + "\n" );
			break;
		case "vector":
			vector $val_v = `stackTrace -pv 0 $i`;
			print( "   value: <<" + $val_v + ">>\n" );
			break;
		case "int[]":
			int $val_ia[] = `stackTrace -pv 0 $i`;
			print( "   value: [" );
			for ( $j in $val_ia ) print( $j + ", " );
			print( "]\n" );
			break;
		case "float[]":
			float $val_fa[] = `stackTrace -pv 0 $i`;
			print( "   value: [" );
			for ( $f in $val_fa ) print( $f + ", " );
			print( "]\n" );
			break;
		case "string[]":
			string $val_sa[] = `stackTrace -pv 0 $i`;
			print( "   value: [" );
			for ( $s in $val_sa ) print( $s + ", " );
			print( "]\n" );
			break;
		case "vector[]":
			vector $val_va[] = `stackTrace -pv 0 $i`;
			print( "   value: [" );
			for ( $v in $val_va ) print( "<<" + $v + ">>, " );
			print( "]\n" );
			break;
		}
	}
}
// Make some input arrays.
int $i[3] = { 9, 6, 3 };
float $f[4] = { 5.0, 7.0, 9.0, 23.0 };
string $s[2] = { "monkey", "ape" };
vector $v[2] = { <<0.1,0.2,0.3>>, <<7,7,11>> };
// Invoke the function.
foo( 42, $i, 3.14, $f, "oook", $s, <<0,0,1>>, $v );