API Basic ByRef ja - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki

ByRef

ClassicUO • Basic

パラメーターは SUB/FUNCTION にデータを渡します。ByRef は変更値を呼び出し元へ書き戻し、ByVal は呼び出し元の変数を保ちます。Optional は省略引数を補い、ParamArray は残りの引数を集めます。呼び出す命令ではなく宣言の修飾子です。

正確な構文

Sub Adjust(ByRef amount, ByVal increment)
Adjust(amount, 3)
Bump(items[index])
Function name(ByRef value As type)

パラメーター

name / As type — name / As type: パラメーター名と任意の As 入力型変換。位置または name:=value で引数を対応させ、修飾子は宣言に記述します。Basic.NamedArguments を参照。
ByRef — ByRef：書き込み可能な変数または既存の添字要素です。このエンジンは ByVal を省略した場合も書き戻し、VB.NET の既定とは異なります。リテラル、定数、計算式は一時値です。
ByVal — ByVal：値のローカルコピーです。パラメーターの再代入は呼び出し元の変数を置換しません。配列とオブジェクトは参照を共有し、深いコピーではありません。
Optional / defaultValue — Optional / defaultValue：末尾の引数を省略した場合に = 後の式を評価します。既定値を明示してください。ない場合は未初期化の Unit になります。
ParamArray — ParamArray values()：最後のパラメーターが残りの値をゼロ個以上受け取ります。配列一つなら直接再使用し、スカラーなら新しい配列を作ります。GetArrayLength が長さを返します。

戻り値

修飾子は値を返しません。RETURN が結果を別に設定します。ByRef は引数の変更であり戻り値ではありません。RETURN のない SUB は Unit を返します。例の数値は計算結果で、TRUE/FALSE のフラグではありません。

動作

引数は左から右へ一度ずつ評価します。添字付き ByRef はコンテナーと添字／キーを保持し、別の引数がコンテナー変数を再代入しても書き戻し先は変わりません。
入口でローカルパラメーターを作ります。終了時は内部 FINALLY の後、パラメーター順に ByRef を書き戻します。本文からエラーで抜ける場合も同様です。同じ変数を二度渡しても二つのローカル値は即時連動せず、最後の書き戻しが残ります。
ByVal は呼び出し元の変数の置換を防ぎますが、共有する配列やオブジェクト内部は変更できます。ReDim は新しいローカル参照を作ります。独立したデータには明示的なコピーが必要です。
位置指定の呼び出しでは：Optional は末尾から省略し、コンマ間の空引数は使えません。既定値は省略ごとに評価するエンジンの式でよく、VB.NET の定数である必要はありません。位置指定を先に書き、最初の名前付き引数以降はすべて名前付きにします。必須引数は省略できません。スクリプトで省略した Optional は、渡した式の後に宣言順で既定式を評価します。ネイティブのオーバーロードは登録済みの名前と個数だけを使い、既定値を追加しません。
ParamArray はまとめたスカラーを元の変数へ書き戻しません。配列を明示して渡した場合、要素変更は呼び出し元にも見えます。別の ParamArray に渡しても入れ子は増えません。
意図を示すため ByRef と ByVal を明示してください。ユーザー手続きのスクリプト呼び出しの規則であり、組み込み命令の引数は各ページに説明があります。
ParamArray は名前で指定できません。名前付き呼び出しでは空のままにでき、要素を渡すには完全な位置指定呼び出しを使います。空のカンマ枠は未対応です。位置指定を先にする部分仕様で、新しい VB.NET の自由な混在ではありません。スレッドやゲーム待機時間は増やしません。

使用例

1. 変数を変更する

# Adjust は amount=5 を ByRef、increment=3 を ByVal で受け取ります。amount は 8 になって書き戻されます。Main は Integer 8 を返し、Adjust に結果はありません。
Option Explicit On
Sub Adjust(ByRef amount, ByVal increment)
    amount += increment
End Sub
Sub Main()
    Var amount = 5
    Adjust(amount, 3)
    Return amount
End Sub

パラメーターと実行の説明:

Adjust は amount=5 を ByRef、increment=3 を ByVal で受け取ります。amount は 8 になって書き戻されます。Main は Integer 8 を返し、Adjust に結果はありません。

2. 添字を一度だけ評価する

# items[0]=5。NextIndex が calls を増やして 0 を返し、Bump がその要素を 6 にします。再評価しないため calls=1。Main は 6*100+1、Integer 601 を返します。
Option Explicit On
Function NextIndex(ByRef calls)
    calls += 1
    Return 0
End Function
Sub Bump(ByRef amount)
    amount += 1
End Sub
Sub Main()
    Dim items[0]
    items[0] = 5
    Var calls = 0
    Bump(items[NextIndex(calls)])
    Return items[0] * 100 + calls
End Sub

パラメーターと実行の説明:

items[0]=5。NextIndex が calls を増やして 0 を返し、Bump がその要素を 6 にします。再評価しないため calls=1。Main は 6*100+1、Integer 601 を返します。

3. 同じ変数を二つのパラメーターへ

# 両方が 5 を受け取り、first は 6、second は 7 になります。終了時に value へ 6、次に 7 を書き戻します。Main は 8 ではなく Integer 7 を返します。
Option Explicit On
Sub Change(ByRef first, ByRef second)
    first += 1
    second += 2
End Sub
Sub Main()
    Var value = 5
    Change(value, value)
    Return value
End Sub

パラメーターと実行の説明:

両方が 5 を受け取り、first は 6、second は 7 になります。終了時に value へ 6、次に 7 を書き戻します。Main は 8 ではなく Integer 7 を返します。

en · ru · uk · fr · de · it · es · zh-tw · ja · ko

Basic