構造体定義における Pirvate メンバと Public メンバ

構造体のメンバ(変数と関数)を定義するときは、修飾子 public および private を使用して、ユーザおよびデバッガに対するメンバの可視性を制御できます。

Public メンバに対しては、外部コードからアクセスすることができます。修飾子を指定しない場合は、メンバは既定値で public であるとみなされます。3ds Max 2010 よりも前のリリースでは、すべてのメンバが常に public でした。

Private メンバには、構造体インスタンス内からのみアクセスできます。private メンバにアクセスを試みると、ランタイムエラーが発生します。構造体を暗号化されたスクリプト内に定義すると、メンバ値はデバッガやエラーダンプには表示されません。

サポートされる 2 つのイベントハンドラである on create do および on clone do は、構造体定義の public セクションで定義された場合でも、必ず自動的に private になります。

例:

struct foo2
(
public
A = 1,
B = 3,
fn error = throw "ZZZ",
private
C = 77,
fn errorPrivate = throw "ZZZ",
on create do format "in create: %\n" this,
on clone do format "in clone: %\n" this
)
 
f = foo2() --creating calls the 'on create do()' handler:

--> #Struct:foo2(
-->   error:<fn>; Public,
-->   c:<data>; Private,
-->   b:<data>; Public,
-->   errorPrivate:<fn>; Private,
-->   a:<data>; Public)
--> undefined
--> in create: (foo2 a:1 b:3)
--> (foo2 a:1 b:3)
--> OK

f = foo2 a:1 b:3 c:4 --passing three parameters fails:

-- Runtime error: Attempting to access private member: "c" in: #Struct:foo2(
-- b:<data>; Public,
-- errorPrivate:<fn>; Private,
-- c:<data>; Private,
-- error:<fn>; Public,
-- a:<data>; Public)

f = foo2 a:10 b:30 --passing two parameters works:

in create: (foo2 a:10 b:30)
(foo2 a:10 b:30)

f = foo2 10 30 --passing two arguments works:

in create: (foo2 a:10 b:30)
(foo2 a:10 b:30)

f = foo2 1 3 4 --trying to pass three arguments fails:

-- Runtime error: Attempting to access private member: "c" in: #Struct:foo2(
-- b:<data>; Public,
-- errorPrivate:<fn>; Private,
-- c:<data>; Private,
-- error:<fn>; Public,
-- a:<data>; Public)

f.errorPrivate() --calling the private error() function fails:

-- Runtime error: Attempting to access private member: "errorPrivate" in: (foo2 a:10 b:30)

f.error() --calling the public error() function works:

-- Frame:
-- Runtime error: ZZZ

f2 = copy f --creating a copy of the existing struct

in clone: (foo2 a:10 b:30)
(foo2 a:10 b:30)

showProperties f --the method prints the type of the members

a:<data>; Public
b:<data>; Public
error:<fn>; Public
errorPrivate:<fn>; Private
c:<data>; Private
true