API Chr ja

Chr

API · BASIC

Русский · English · Українська · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

ASC · Chr · len · StrComp

ClassicUO • Runtime API

文字列を組み立てる Unicode 文字や制御文字を作ります。

正確な構文

Chr(value:Integer) -> String

パラメーター

• value — Integer コードを 0..0x10FFFF に制限します。サロゲート 0xD800..0xDFFF は捕捉可能なエラーです。

戻り値

1 または 2 UTF-16 コード単位の String。Chr(0) は空文字列ではなく NUL。絵文字は 2 単位になり、ASC では元の完全なコードに戻りません。

動作

• サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。
• Integer が必要で、Decimal を直接渡せません。タブや改行は文字でありキー操作ではありません。表示は出力先に依存します。

内部関数：呼び出しから結果まで

BasicChr がコードを制限して ConvertFromUtf32 を呼びます。0xFFFF より大きい有効コードはサロゲートペアになります。

1. BasicChr / Char.ConvertFromUtf32

BasicChr がコードを制限して ConvertFromUtf32 を呼びます。0xFFFF より大きい有効コードはサロゲートペアになります。

1 または 2 UTF-16 コード単位の String。Chr(0) は空文字列ではなく NUL。絵文字は 2 単位になり、ASC では元の完全なコードに戻りません。

プロジェクトのソース: external/InjectionScript/src/InjectionScript/Runtime/InjectionApi.cs; 関数 BasicChr / Char.ConvertFromUtf32.

Integer が必要で、Decimal を直接渡せません。タブや改行は文字でありキー操作ではありません。表示は出力先に依存します。

使用例

タブ区切りデータ

# タブ区切りデータ
#
# 文字列を組み立てる Unicode 文字や制御文字を作ります。
#
# 1 または 2 UTF-16 コード単位の String。Chr(0) は空文字列ではなく NUL。絵文字は 2 単位になり、ASC では元の完全なコードに戻りません。

SUB Main()
    # Chr(9) が ore と 50 を区切り、後で使う ore<TAB>50 を返します。
    # サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。

    Dim resource = "ore"
    Dim amount = 50
    Return resource & Chr(9) & CStr(amount)
END SUB

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

• Chr(9) が ore と 50 を区切り、後で使う ore50 を返します。
• サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。

2 行を準備する

# 2 行を準備する
#
# 文字列を組み立てる Unicode 文字や制御文字を作ります。
#
# 1 または 2 UTF-16 コード単位の String。Chr(0) は空文字列ではなく NUL。絵文字は 2 単位になり、ASC では元の完全なコードに戻りません。

SUB Main()
    # Chr(13) と Chr(10) が First と Second の間に CRLF を入れます。送信はしません。
    # サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。

    Dim summary = "First" & Chr(13) & Chr(10) & "Second"
    Return summary
END SUB

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

• Chr(13) と Chr(10) が First と Second の間に CRLF を入れます。送信はしません。
• サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。

不正コードを処理する

# 不正コードを処理する
#
# 文字列を組み立てる Unicode 文字や制御文字を作ります。
#
# 1 または 2 UTF-16 コード単位の String。Chr(0) は空文字列ではなく NUL。絵文字は 2 単位になり、ASC では元の完全なコードに戻りません。

SUB Main()
    # SafeCharacter はエラー時に空文字列を返します。0x1F600 は有効で、1 Unicode スカラーでも Len は 2 です。
    # サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。

    Dim symbol = SafeCharacter(0x1F600)
    Return Len(symbol)
END SUB

Function SafeCharacter(code)
    Try
        Return Chr(code)
    Catch problem
        Return ""
    End Try
End Function

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

• SafeCharacter はエラー時に空文字列を返します。0x1F600 は有効で、1 Unicode スカラーでも Len は 2 です。
• サンプルデータをローカルで処理して値を返します。チャット送信、スクリプト停止、アイテム移動、サーバー通信は行いません。