Hitoshina - Languageについて

Hitoshina - Languageは、Second Life向けのプログラミング言語です。
Hitoshinaの理念である「より良いSecond Lifeへの貢献」という理念に沿って、
メモリ使用量の削減や高速化といった最適化のノウハウを集約し、様々な人が意識せずにそれらの恩恵を受けられるようにすることを目標としています。
ビルドするとスクリプト言語 LSL(Linden Scripting Language)のコードを出力します。

特徴

• 最適化 — 定数畳み込み、インライン展開、デッドコード削除などの自動最適化。
• 関数とプロシージャの分離 — 純粋な関数と副作用のあるプロシージャを文法的に区別。
• テスト機能 — 関数の単体テストとモック機能。
• 静的解析 — 送信チャンネルに対する受信チャンネルが存在しないなどの意味的な誤りを検出。

Second Life の基本概念

Hitoshina - Languageを理解するために、Second Lifeの以下の概念を知っておくと役立ちます。

• オブジェクト: ワールド内に存在する3Dモデル。1つ以上のプリム（パーツ）で構成され、プリムをリンクしたものをリンクセットと呼びます。
• スクリプト: オブジェクトに埋め込まれるプログラム。イベント（初期化、タッチ、メッセージ受信等）に応じて動作します。
• アバター: プレイヤーのキャラクター。UUID で一意に識別されます。
• チャンネル: スクリプト間通信のための番号付きメッセージバス。チャンネル0はワールドチャット。
• プリム: オブジェクトを構成する個々のパーツ。リンクセット内ではリンク番号で識別されます。HLの prim 宣言はこのプリムに対応します。

クイックスタート

最小限の.hlファイル例

script main;

main #init {
    "Hello, World!" -> world;
}

• script main; — main という名前のスクリプトインスタンスを宣言します。コンパイル時に output/main.lsl として出力されます。
• main #init { ... } — main スクリプトの初期化イベントハンドラーです。スクリプトが開始されたときに1度だけ実行されます。
• "Hello, World!" -> world; — 文字列をワールドチャット（チャンネル0の公開チャット）に送信します。-> はメッセージ送信演算子、world は送信先です。

このスクリプトをコンパイルすると、script main; の宣言に対応する output/main.lsl が生成されます。

default {
    state_entry() {
        llSay(0, "Hello, World!");
    }
}

コンパイル手順

# コンパイル（.hlファイルからLSLを生成）
hl main.hl

# 出力: output/main.lsl

生成された .lsl ファイルをSecond Lifeのオブジェクトに設置して使用します。

プロジェクト作成

# プロジェクトディレクトリを作成
hl new my_project

以下のディレクトリ構造が作成されます。

my_project/
├── lib/       # ライブラリファイル (.hlib)
├── prc/       # プロシージャライブラリ (.hprc)
├── msg/       # メッセージハンドラー (.hmsg)
├── output/    # 出力ファイル (.lsl)
├── tests/     # テストファイル (.hltest)
└── main.hl    # メインスクリプト（初期テンプレート）

各ディレクトリ・ファイルの役割は以下の通りです。

• lib/ — 複数のスクリプトで共有する関数や定数を .hlib ファイルとして格納します。import math_lib; のように読み込みます。
• prc/ — 再利用可能なプロシージャ（副作用を伴う処理）を .hprc ファイルとして格納します。include common_proc; のように読み込みます。
• msg/ — スクリプト間のメッセージ受信時に実行される処理を .hmsg ファイルとして分離・定義します。メインファイルからメッセージ送信時に -> sub @handler_name の形式で指定します。
• output/ — hl main.hl でコンパイルすると、ここにLSLファイルが生成されます。このファイルをSecond Lifeに設置します。
• tests/ — .hltest ファイルで単体テストを記述します。hl test コマンドで実行できます。
• main.hl — プロジェクトのエントリポイントとなるメインスクリプト。以下の初期テンプレートが書き込まれた状態で生成されます。

script main;

main #init {
    "Hello, World!" -> world;
}

文法概要

この章では、Hitoshina - Languageの全体像を簡潔に紹介します。各トピックの詳細な構文仕様は後続のセクションを参照してください。

プログラムの構造

HLプログラムは、メインファイル（.hl）を中心に構成されます。メインファイルにはスクリプトの定義、イベントハンドラー、そして処理の本体を記述します。

script main;               // スクリプトインスタンスの宣言
prim btn;                  // プリムの宣言

const int CH = 100;        // 定数の定義

main #init {               // 初期化イベント
    "Ready" -> owner;      // オーナーにメッセージ送信
}

データ型

基本型として int, float, str, bool, key（UUID）, vec（3Dベクター）, rot（回転）があります。リストは ilist, slist 等の型付きリストで安全に操作できます。詳細は型システムを参照してください。

変数と定数

int count = 0;                     // 変数定義
const int MAX_COUNT = 100;         // 定数定義（大文字命名）

関数とプロシージャ

HLでは関数とプロシージャを明確に区別します。

• 関数: 値を計算して返します。式のみで構成されます。
• プロシージャ: 副作用(※)のある処理を実行します。ブロック構文を持ちます。

※副作用とは、関数の外部に影響を与える操作のことです。メッセージ送信（->）やグローバル変数の書き換えなどが副作用に当たります。HLでは関数に副作用を持たせることができないため、どこから呼び出しても同じ入力に対して同じ結果が保証されます。

script main;

// 関数: 式で値を返す
int add(int a, int b) = a + b;

// プロシージャ: ブロックで処理を記述
#greet |str name| {
    "Hello, " + name -> world;
}

main #init {
    add(5, 3) -> owner;    // "8"
    #greet|"World"|;       // "Hello, World"
}

詳細は基本構文を参照してください。

イベント駆動モデル

Second Lifeのスクリプトはイベント駆動で動作します。HLでは #init（初期化）、#timer（タイマー）、#listen（メッセージ受信）、#touch_start（タッチ）などのイベントハンドラーを定義できます。

script main;

main #listen :0 |str msg| {        // チャンネル0のメッセージを受信
    msg -> owner;                  // オーナーに転送
}

詳細は基本構文 — イベントハンドラーを参照してください。

メッセージの送受信

-> 演算子でメッセージを送信します。送信先は world（公開チャット）、owner（オーナー）、またはユーザー定義のスクリプト・アバターを指定できます。

script main;
script sub;

main #init {
    "公開メッセージ" -> world;          // ワールドチャット
    "秘密のメッセージ" -> owner;        // オーナーのみ
    "データ":100 -> sub;                // チャンネル100でsubスクリプトへ
}

sub #linkmsg :100 |str msg| {           // チャンネル100のメッセージを受信
    msg -> owner;
}

詳細はメッセージ送信を参照してください。

条件分岐とループ

script main;

main #init {
    int count = 7;

    if 10 < count {
        "Large" -> owner;
    } elif 5 < count {
        "Medium" -> owner;
    } else {
        "Small" -> owner;
    }

    slist items = ["Apple", "Banana", "Cherry"];
    for str item in items {
        item -> owner;
    }
}

詳細はブロック構文を参照してください。

ファイル構成

コードを用途別のファイルに分割できます。

詳細はファイルタイプを参照してください。

ファイルタイプ

Hitoshina - Languageでは、用途に応じて5種類のファイルタイプを使い分けます。

メインファイル（.hl）

メインファイルはLSLスクリプトを生成するためのエントリーポイントとなるファイルです。

定義可能な要素:

• script/avatar/prim定義（script main;、avatar player = "UUID";等）
• イベントハンドラー（#init、#timer、#listen、#touch、#linkmsg等）
• プロシージャ定義（#proc { ... }形式）
• 関数定義（int add(int a, int b) = a + b;形式）
• 定数定義（const int MAX = 100;形式）
• context定義（グローバル状態管理用の構造体）
• プロパティ定義（#attachable、#animable、#cache_linknum、#memory_limit_kb）
• import文（.hlibファイルの参照）
• include文（.hprcファイルの参照）

定義できない要素:

• ref文（.hmsgファイル専用）
• test定義（.hltestファイル専用）

重要: メインファイルのイベントハンドラーやプロシージャ内ではブロック構文を使用します。関数呼び出しは式として使用できますが、void関数（戻り値なし関数）は存在しません。副作用を伴う処理にはプロシージャを使用してください。

例:

project/
└── main.hl

script main;

const int MAX_COUNT = 10;

context @main {
    int counter = 0;
}

#debug |str msg| {
    msg -> owner;
}

main #init |context ctx| {
    "Hello" -> world;
    ctx.counter += 1;
    #debug|"Initialized"|;
}

main #listen:0 |str msg, context ctx| {
    if ctx.counter < MAX_COUNT {
        ctx.counter += 1;
        "Count: " + ctx.counter -> owner;
    }
}

ライブラリファイル（.hlib）

ライブラリファイルは、再利用可能な関数と定数を定義します。

定義可能な要素:

• 関数定義（int add(int a, int b) = a + b;）
• 定数定義（const int MAX_VALUE = 100;）
• 他のライブラリのimport

定義できない要素:

• script/avatar/prim定義
• イベントハンドラー
• プロシージャ定義
• プロパティ定義

例:

project/
└── lib/
    └── math_utils.hlib

const int MAX_VALUE = 100;

int add(int a, int b) = a + b;
int clamp(int x, int max) = max < x ? max : x;

プロシージャライブラリファイル（.hprc）

プロシージャライブラリファイルは、再利用可能なプロシージャを定義します。

定義可能な要素:

• プロシージャ定義（#proc_name { ... } または #proc_name|params| { ... }）
• 他のライブラリのimport
• 他のプロシージャライブラリのinclude

定義できない要素:

• script/avatar/prim定義
• イベントハンドラー
• 関数定義
• 定数定義
• プロパティ定義

例:

project/
└── prc/
    └── greet.hprc

#say_hello |str name| {
    "Hello, " + name -> world;
}

メッセージハンドラーファイル（.hmsg）

メッセージハンドラーファイルは、メッセージ送信時に呼び出される処理を分離して定義します。

定義可能な要素:

• ref文（参照先のスクリプトファイル指定）
• import文
• include文（.hprcファイルの参照）
• 定数定義
• 関数定義
• プロシージャ定義
• linkmsgイベントハンドラー

定義できない要素:

• script/avatar/prim定義
• context定義
• その他のイベントハンドラー（#init、#timer、#listen、#touch等）

例:

project/
├── main.hl
└── msg/
    └── greeting.hmsg

script main;
script sub;

main #init {
    "Hello":100 -> sub @ greeting;  // msg/greeting.hmsg を呼び出してsubスクリプトへ送信
}

ref main;

sub #linkmsg :100 |str msg| {
    msg -> world;
}

contextパラメータの使用:

.hmsgファイル内のlinkmsgハンドラでは、親.hlファイルで定義されたcontextフィールドにcontextパラメータ経由でアクセスできます。

script main;
script dialog;

context @dialog {
    str dialog_part = "";
}

main #init {
    "menu":100 -> dialog @ menu;
}

ref main;

dialog #linkmsg :100 |str msg, context ctx| {
    ctx.dialog_part = msg;  // 親.hlのcontext @dialog のフィールドにアクセス
}

テストファイル（.hltest）

テストファイルは、単体テストを記述するためのファイルです。

定義可能な要素:

• import文
• テスト式（比較式形式）
• モック定義

定義できない要素:

• script/avatar/prim定義
• イベントハンドラー
• 関数定義
• プロシージャ定義・呼び出し
• 定数定義
• メッセージ送信
• context定義
• プロパティ定義

例:

project/
├── lib/
│   └── math_utils.hlib
└── tests/
    └── math_utils_test.hltest

テスト対象のライブラリとテスト例：

int add(int a, int b) = a + b;
int clamp(int x, int max) = max < x ? max : x;

import math_utils as m;

// add関数のテスト
m::add(1, 2) == 3;
m::add(-1, 1) == 0;

// clamp関数のテスト
m::clamp(50, 100) == 50;
m::clamp(150, 100) == 100;

テスト結果：

✅ m::add(1, 2) == 3
✅ m::add(-1, 1) == 0
✅ m::clamp(50, 100) == 50
✅ m::clamp(150, 100) == 100

test result: ok. 4 passed; 0 failed

ファイルタイプ対照表

各ファイルタイプで使用可能な構文の一覧です。

基本構文

この章では、HLプログラムを構成する基本的な構文要素を詳しく説明します。

import文

import <ライブラリ名>;
import <ライブラリ名> as <エイリアス名>;

外部ライブラリファイル（.hlib）で定義された関数・定数を現在のファイルで使用可能にします。

例：

int add(int a, int b) = a + b;

import math_utils;

script main;

main #init {
    int result = math_utils::add(5, 3);
    result -> owner;  // "8" と表示
}

include文

include <ライブラリ名>;
include <ライブラリ名> as <エイリアス名>;

外部プロシージャライブラリファイル（.hprc）で定義されたプロシージャを現在のファイルで使用可能にします。

例：

#say_hello |str name| {
    "Hello, " + name -> world;
}

include greet;

script main;

main #init {
    #greet::say_hello|"World"|;
}

識別子の命名規則

通常識別子（変数名、関数名、スクリプト名等）

• 小文字英字、数字、アンダースコアのみ使用可能。
• 先頭に数字は使用不可。
• 例: main, my_variable, count_items, user_id_123

定数識別子

• 大文字英字、数字、アンダースコアのみ使用可能。
• 先頭に数字は使用不可。
• 例: MAX_COUNT, DEFAULT_MESSAGE, CH_PUBLIC, API_KEY_1

script/avatar/prim定義

Second Lifeのエンティティに対応するインスタンスを宣言します。

• script: LSLスクリプトに対応。script main; は output/main.lsl を生成します。1つの .hl ファイルから複数スクリプトのコードを生成できます（例: script main; script sub; → output/main.lsl, output/sub.lsl）。
• avatar: プレイヤーキャラクター。定義時にUUIDを指定して識別します（UUID必須）。
• prim: リンクセット内の個々のプリム（パーツ）。リンク番号で識別され、色変更やタッチ検出などの操作対象となります。

script <識別子名>;
avatar <識別子名> = "<UUID文字列>";
prim <識別子名>;

// カンマ区切りで複数のインスタンスを一括宣言可能
prim <識別子名>, <識別子名>, ...;
script <識別子名>, <識別子名>, ...;

prims定義（primのグループ化）

複数のprimをワイルドカードパターンでグループ化します。

import standard as std;

script main;
main #cache_linknum;

prim btn123;
prim btn456;
prim btn789;

// primsグループ定義（ワイルドカード`*`の数が文字数を表す）
prims btn*** = btn123, btn456, btn789;  // btn + 3文字 = 6文字のprimをグループ化

// primsグループへのメソッド呼び出しは各primに展開される
main #init {
    #btn***.set_color|std::ALL_SIDES, <1,0,0>, 1.0|;
    // 展開結果:
    // #btn123.set_color|std::ALL_SIDES, <1,0,0>, 1.0|;
    // #btn456.set_color|std::ALL_SIDES, <1,0,0>, 1.0|;
    // #btn789.set_color|std::ALL_SIDES, <1,0,0>, 1.0|;
}

// primsグループのタッチイベント（パターンマッチングで条件生成）
btn*** #touch_start @main |prim obj| {
    obj.name() -> owner;  // タッチされたprimの識別子名
    obj.desc() -> owner;  // タッチされたprimの説明
}

制約:

• ワイルドカードは後置のみ（btn***は可、***btnは不可）。
• 宣言時に代入が必須（prims btn***;のみは不可）。
• パターンに一致する全primの代入が必須。
• prim型とprims型は相互変換不可。

イベントハンドラー

Second Lifeのスクリプトはイベント駆動で動作します。HLでは スクリプト識別子 #イベント名 の形式でイベントハンドラーを定義します。

init イベント

スクリプトの開始時（リセット時や装着時）に1度だけ実行されます。

<スクリプト識別子> #init {
    // 処理内容
}

<スクリプト識別子> #init|context <変数名>| {
    // 処理内容（contextアクセス可）
}

<スクリプト識別子> #init|bool <変数名>| {
    // 処理内容（bool 変数で起動コンテキストを区別可能）
}

<スクリプト識別子> #init|bool <変数名>, context <変数名>| {
    // 処理内容（bool 変数 + contextアクセス）
}

bool パラメータ（任意）: #attachable が指定されたスクリプトでは、#init の内容は LSL の state_entry と attach(key id) の両方に展開されます。bool パラメータを宣言すると、その変数は state_entry 経路では false、装着時の attach 経路では true として参照可能となり、装着時にのみ実行したい処理を分岐できます。#attachable が指定されていない場合、bool 変数は常に false となります。

script main;
main #attachable;

main #init|bool is_attach| {
    if is_attach {
        "attached!" -> owner;
    } else {
        "started" -> owner;
    }
}

timer イベント

設定された間隔で繰り返し実行されます。標準プロシージャの set_timer() でタイマーを設定します。

<スクリプト識別子> #timer {
    // 処理内容
}

<スクリプト識別子> #timer|context <変数名>| {
    // 処理内容（contextアクセス可）
}

listen イベント

指定チャンネルのチャットメッセージを受信します。チャンネル0はワールドチャット（公開チャット）で、それ以外の番号はスクリプト間通信に使用します。

// パラメータ省略
<スクリプト識別子> #listen :<チャンネル番号> {
    // 処理内容
}

// メッセージのみ
<スクリプト識別子> #listen :<チャンネル番号> |str msg| {
    // 処理内容
}

// 全パラメータ指定
<スクリプト識別子> #listen :<チャンネル番号> |str name, key id, str msg| {
    // 処理内容（name: 送信者名、id: 送信者UUID、msg: メッセージ）
}

// contextアクセス
<スクリプト識別子> #listen :<チャンネル番号> |str msg, context ctx| {
    // 処理内容（contextアクセス可）
}

// オーナーフィルタとの組み合わせ
<スクリプト識別子> #listen :<チャンネル番号> + owner |str msg| {
    // 処理内容（オーナーのみ受信）
}

パラメータ（全て省略可能、順序固定）:

• str <変数名> — 送信者名
• key <変数名> — 送信者UUID
• str <変数名> — メッセージ本文
• context <変数名> — contextアクセス（末尾に指定）

指定可能な組み合わせ:

• |str name, key id, str msg| — 送信者名・UUID・メッセージ
• |str name, key id| — 送信者名・UUID
• |str name, str msg| — 送信者名・メッセージ
• |key id, str msg| — UUID・メッセージ
• |key id| — UUID のみ
• |str msg| — メッセージのみ
• 省略可
• 上記いずれにも , context <変数名> を末尾に追加可能

※ 単独の str パラメータはメッセージ本文として解釈されます。

チャンネル番号:

• リテラル値: #listen :0、#listen :123
• 定数名: #listen :PUBLIC_CHANNEL
• ライブラリ定数: #listen :const::CH_PUBLIC

オーナーフィルタ (+ owner):

• オーナーからのメッセージのみを受信。

linkmsg イベント

同一オブジェクト内の他スクリプトからリンクメッセージを受信したときに実行されます。

<スクリプト識別子> #linkmsg :<チャンネル番号> |str msg| {
    // 処理内容
}

// contextアクセス
<スクリプト識別子> #linkmsg :<チャンネル番号> |str msg, context ctx| {
    // 処理内容（contextアクセス可）
}

touch_start イベント

プレイヤーがプリムをクリック（タッチ）した瞬間に1回実行されます。プリム識別子で受け取り対象を指定し、@ でスクリプトを紐付けます。

<プリム識別子> #touch_start @ <スクリプト識別子> {
    // 処理内容
}

<プリム識別子> #touch_start :<面指定> @ <スクリプト識別子> {
    // 処理内容（特定の面がタッチされた場合のみ実行）
}

// primパラメータ（タッチされたプリムの情報を取得）
<プリム識別子> #touch_start @ <スクリプト識別子> |prim <変数名>| {
    <変数名>.name() -> owner;  // プリムの識別子名
    <変数名>.desc() -> owner;  // プリムのDescription
}

// primパラメータとcontextパラメータの組み合わせ
<プリム識別子> #touch_start @ <スクリプト識別子> |prim <変数名>, context <ctx変数名>| {
    // 処理内容
}

// primsグループの場合も同様（パターンマッチングで条件生成）
<primsグループ識別子> #touch_start @ <スクリプト識別子> |prim <変数名>| {
    <変数名>.name() -> owner;  // タッチされた個別primの識別子名
}

primパラメータのメソッド:

• <変数名>.name(): プリムの識別子名を取得（str型）。
• <変数名>.desc(): プリムのDescriptionを取得（str型）。

LSL変換時の展開例：

// obj.name() → llGetLinkName($link_num)
// obj.desc() → llList2String(llGetObjectDetails(llGetLinkKey($link_num), [OBJECT_DESC]), 0)

※ メソッドがブロック内で参照されていない場合は、該当コードは生成されません（最適化）。

touch イベント

プレイヤーがプリムをタッチしている間、継続的に実行されます。パラメータは#touch_startと同様です。

// 基本
<プリム識別子> #touch @ <スクリプト識別子> {
    // 処理内容
}

// 面指定
<プリム識別子> #touch :<面指定> @ <スクリプト識別子> {
    // 処理内容
}

// primパラメータ（タッチされたプリムの情報を取得）
<プリム識別子> #touch @ <スクリプト識別子> |prim <変数名>| {
    <変数名>.name() -> owner;  // プリムの識別子名
    <変数名>.desc() -> owner;  // プリムのDescription
}

// primパラメータとcontextの組み合わせ
<プリム識別子> #touch @ <スクリプト識別子> |prim <変数名>, context <ctx変数名>| {
    // 処理内容
}

#touch_startとの違い:

sensorイベント

標準プロシージャの sensor_repeat() / sensor() で開始されたセンサーがオブジェクト/エージェントを検出した時に実行されます。

<スクリプト識別子> #sensor |int <検出数変数>| {
    // <検出数変数>: 検出されたエンティティの数（int型）
}

<スクリプト識別子> #sensor |int <検出数変数>, context <ctx変数名>| {
    // contextパラメータとの併用も可能
}

no_sensorイベント

センサーが何も検出しなかった時に実行されます。

<スクリプト識別子> #no_sensor {
    // 処理内容
}

<スクリプト識別子> #no_sensor |context <ctx変数名>| {
    // contextパラメータとの併用も可能
}

run_time_permissionsイベント

標準プロシージャの request_permissions() で要求したパーミッションが許可/拒否された時に実行されます。パーミッション変数（int型）はビットマスクで、付与されたパーミッションを表します。

<スクリプト識別子> #run_time_permissions |int <パーミッション変数>| {
    // <パーミッション変数>: 付与されたパーミッションのビットマスク（int型）
}

<スクリプト識別子> #run_time_permissions |int <パーミッション変数>, context <ctx変数名>| {
    // contextパラメータとの併用も可能
}

dataserverイベント

標準ライブラリの request_agent_data() / get_notecard_line() 等の非同期データリクエストが完了した時に実行されます。クエリID変数（key型）でリクエストを識別し、データ変数（str型）に返却データが入ります。

<スクリプト識別子> #dataserver |key <クエリID変数>, str <データ変数>| {
    // <クエリID変数>: リクエストを識別するクエリID（key型）
    // <データ変数>: 返却されたデータ（str型）
}

<スクリプト識別子> #dataserver |key <クエリID変数>, str <データ変数>, context <ctx変数名>| {
    // contextパラメータとの併用も可能
}

changed イベント

オブジェクトに何らかの変化（インベントリ追加、リンク変更、リージョン移動など）があった時に実行されます。int 変数には変化の種類を表すビットフィールドが渡されます。

<スクリプト識別子> #changed |int <変化フラグ変数>| {
    // <変化フラグ変数>: 変化の種類を表すビットフィールド（int型）
    //   CHANGED_INVENTORY, CHANGED_COLOR, CHANGED_SHAPE, CHANGED_SCALE,
    //   CHANGED_TEXTURE, CHANGED_LINK, CHANGED_ALLOWED_DROP, CHANGED_OWNER,
    //   CHANGED_REGION, CHANGED_TELEPORT, CHANGED_REGION_START, CHANGED_MEDIA,
    //   CHANGED_RENDER_MATERIAL のビット和
}

<スクリプト識別子> #changed |int <変化フラグ変数>, context <ctx変数名>| {
    // contextパラメータとの併用も可能
}

LSL 変換:

changed(integer change)
{
    // ブロック内容
}

on_rez イベント

オブジェクトがインワールドに rez された時、またはアバターが装着した時に実行されます。int 変数には llRezObject() 等で渡された start_param 値が入り、ユーザーや別オブジェクトから手動で rez された場合は通常 0 です。

<スクリプト識別子> #on_rez |int <start_param変数>| {
    // <start_param変数>: rez 時の start_param 値（int型）
}

<スクリプト識別子> #on_rez |int <start_param変数>, context <ctx変数名>| {
    // contextパラメータとの併用も可能
}

LSL 変換:

on_rez(integer start_param)
{
    // ブロック内容
}

プロシージャと関数の違い

プロシージャ定義

// パラメータなし
#<プロシージャ名> {
    // 処理内容
}

// パラメータ付き
#<プロシージャ名> |<引数リスト>| {
    // 処理内容
}

例：

script main;

#debug_print |str message| {
    message -> world;
}

main #init {
    #debug_print|"Hello"|;
}

プロシージャ呼び出し

#<プロシージャ名>;
#<プロシージャ名>|<引数>|;

関数定義

関数は値を計算して返すために使用します。.hl、.hlib、.hmsgファイルで定義できます。

<戻り値型> <関数名>(<引数リスト>) = <式>;

例：

script main;

int add(int a, int b) = a + b;

main #init {
    int result = add(5, 3);
    result -> owner;  // "8" と表示
}

重要: 関数本体は式のみで構成されます。以下の構文は使用できません：

• 変数定義・再代入。
• プロシージャ呼び出し。
• メッセージ送信。
• 制御構文（if文、while文、for each文）。

関数専用の式

関数本体では、通常の式に加えて以下の特殊な式を使用できます。これらは関数定義内でのみ使用可能で、ブロック構文（イベントハンドラーやプロシージャ）では使用できません。

三項演算子

条件に基づいて値を返します。

script main;

str status(bool flag) = flag ? "yes" : "no";
str classify(int x) = 10 < x ? "big" : "small";

main #init {
    status(true) -> owner;   // "yes"
    status(false) -> owner;  // "no"
    classify(15) -> owner;   // "big"
    classify(3) -> owner;    // "small"
}

match式

値に対してパターンマッチングを行い、一致したパターンに対応する結果を返します。

script main;

// 基本形式: 値 ? パターン1 => 結果1 ? パターン2 => 結果2 : デフォルト
str status(int code) = code
    ? 0 => "success"
    ? 1 => "error"
    : "unknown";

main #init {
    status(0) -> owner;  // "success"
    status(1) -> owner;  // "error"
    status(9) -> owner;  // "unknown"
}

as句を使用した変数束縛:

match式の対象となる値に名前を付けて、パターンの結果式で参照できます。

script main;

str check(str code) = code.substr(0, 0) as c
    ? "A" => "admin:" + c
    ? "U" => "user:" + c
    : "unknown:" + c;

main #init {
    check("A01") -> owner;  // "admin:A"
    check("U99") -> owner;  // "user:U"
    check("X00") -> owner;  // "unknown:X"
}

map式

コレクション（リスト型またはstr型）の各要素を変換して新しいリストを返します。str型の場合、1文字ずつイテレーションされます。

script main;

// 基本形式: map 型 変数 in リスト : 変換式
ilist increment(ilist numbers) = map int n in numbers : n + 1;

// インデックス付き: index キーワードでインデックスを取得
slist with_index(slist items) = map str s in items index i : s + i.to_str();

// レンジ形式: map int 変数 = 開始 to 終了 : 変換式
// 変数はint型のみ。レンジは両端含む（開始 <= 変数 <= 終了）
ilist make_range() = map int i = 0 to 2 : i + 10;

// str型コレクション: 1文字ずつ変換
slist chars(str text) = map str c in text : c + "!";

main #init {
    increment([1, 2, 3]).join(", ") -> owner;    // "2, 3, 4"
    with_index(["a", "b"]).join(", ") -> owner;  // "a0, b1"
    make_range().join(", ") -> owner;            // "10, 11, 12"
    chars("hi").join(", ") -> owner;             // "h!, i!"
}

find式

リストから条件に一致する最初の要素を検索し、対応する値を返します。パターンマッチ形式と三項演算子形式の2つの構文をサポートしています。

script main;

// パターンマッチ形式: find 型 変数 in リスト : 比較対象 ? パターン => 結果 : デフォルト
// 各要素の先頭文字で種別を判定し、最初に一致した要素から結果を返す
str classify_first(slist codes) =
    find str c in codes : c.substr(0, 0)
    ? "A" => "admin: " + c
    ? "U" => "user: " + c
    : "unknown";

// パターンマッチ形式（as 再束縛）: find 型 変数 in リスト : 比較対象 as 識別子 ? パターン => 結果 : デフォルト
// 比較対象の評価結果を新しい識別子に束縛して以降のパターン内で参照可能（match 式の as 再束縛と同等）
// as 識別子の名前がループ変数と同名の場合はループ変数をシャドーする
str classify_upper(slist names) =
    find str item in names : item.to_upper() as item
    ? "ALICE" => "is_alice"
    : "none";

// 三項演算子形式: find 型 変数 in リスト : 条件式 ? 真の値 : 偽の値
// 指定キーワードを含む最初のメッセージを返す
str find_with_keyword(slist messages, str keyword) =
    find str msg in messages : 0 <= msg.index_of(keyword) ? msg : "not found";

// レンジ形式: find int 変数 = 開始 to 終了 : 三項演算子形式
// 変数はint型のみ。レンジは両端含む（開始 <= 変数 <= 終了）
// 1〜10 で最初に divisor の倍数となる数を返す
str first_multiple_of(int divisor) =
    find int i = 1 to 10 : i % divisor == 0 ? "first: " + i.to_str() : "none";

main #init {
    classify_first(["X01", "U99", "A02"]) -> owner;                            // "user: U99"
    classify_upper(["bob", "alice", "carol"]) -> owner;                        // "is_alice"
    find_with_keyword(["hello world", "test code", "say hi"], "hi") -> owner;  // "say hi"
    first_multiple_of(3) -> owner;                                             // "first: 3"
}

fold式

コレクション（リスト型またはstr型）の各要素を集約して単一の値を返します。str型の場合、1文字ずつイテレーションされます。

script main;

// 基本形式: fold 型 変数 in リスト : 集約式
int sum_all(ilist numbers) = fold int n in numbers : n;
str concat_all(slist words) = fold str w in words : w;

// str型コレクション: 1文字ずつ集約
str separate(str text) = fold str c in text : c + ",";

// レンジ形式: fold int 変数 = 開始 to 終了 : 集約式
// 変数はint型のみ。レンジは両端含む（開始 <= 変数 <= 終了）
int sum_range() = fold int i = 0 to 2 : i;

// アキュムレータ付き形式: ループ間で独立した状態を追跡する変数を追加できる
// 構文: fold 型 変数 = 開始 to 終了, アキュムレータ型 アキュムレータ名 = 初期値 : 集約式, 更新式
// コレクション形式: fold 型 変数 in リスト, アキュムレータ型 アキュムレータ名 = 初期値 : 集約式, 更新式
// 各イテレーションで: 1) 集約式を評価して結果を累積、2) 更新式でアキュムレータを更新
str fx() = fold int i = 0 to 2, int acc = 0 : (i + acc).to_str(), i + 1;

// str型コレクション + アキュムレータ: セパレータ付き結合
str join_chars(str text) = fold str c in text, str sep = "" : sep + c, ",";

main #init {
    sum_all([1, 2, 3]) -> owner;           // 6  (1 + 2 + 3)
    concat_all(["a", "b", "c"]) -> owner;  // "abc"
    separate("abc") -> owner;              // "a,b,c,"
    sum_range() -> owner;                  // 3  (0 + 1 + 2)
    fx() -> owner;                         // "024"
    join_chars("abc") -> owner;            // "a,b,c"
}

定数定義

const <型> <定数識別子> = <定数式>;

定数式にはリテラル値、他の定数参照、およびそれらの演算式を使用できます。 変数参照、関数呼び出し、メソッド呼び出し等の非定数式は使用できません（E0602エラー）。

整数定数式の計算結果が int の範囲（-2147483648〜2147483647）を超える場合は E0308 エラーになります。リテラル同士の式（const int BAD = 2147483647 + 1;）に加え、同一ファイル内の非ライブラリ定数を参照する式（const int MAX = 2147483647; const int BAD = MAX + 1;）も検出対象です。コンパイル時（定数畳み込み）に評価されるため、overflow を含むファイルは LSL 生成がスキップされます。なお、ライブラリ定数（lib::MAX）を介した overflow は現時点では検出されません。この検査は定数定義に限らず、通常の文の中の整数定数式（例: int x = 2147483647 + 1;）にも適用されます。

例：

const int MAX_COUNT = 10;
const str DEFAULT_MESSAGE = "hello";
const int CH_PUBLIC = 0;
const str GREETING = DEFAULT_MESSAGE + " world";
const int DOUBLED = MAX_COUNT * 2;

変数定義

// 新規変数定義
<型> <識別子名> = <式>;

// 変数再代入
<識別子名> = <式>;

例：

script main;

main #init {
    int count = 10;
    str message = "hello";
    count += 1;
    message -> owner;
}

ビット演算子

整数（int型）に対してビット演算を行います。Second Lifeのパーミッション処理などで使用します。

script main;

main #init {
    int a = 12;               // 0b1100
    int b = 10;               // 0b1010
    int and_result = a & b;   // 8  (0b1000)
    int or_result  = a | b;   // 14 (0b1110)
    int xor_result = a ^ b;   // 6  (0b0110)
}

注意: ダイアログ構文でボタンのグルーピングに|を使用する場合、ビットOR演算子と構文が衝突するため、演算式を括弧で囲む必要があります。

int a = 12;
int b = 10;

// NG: a | b の | がボタン区切りと区別できずエラー
a | b | "OK" | @owner:1 -> world;

// OK: 括弧で囲む
(a | b) | "OK" | @owner:1 -> world;

context定義

スクリプトごとのコンテキスト情報を定義します。@スクリプト名で所属スクリプトを指定します。 同一スクリプトに対して複数のcontext定義を行うとE1003エラーになります。 @スクリプト名で指定したスクリプトがscript文で定義されていない場合はE1004エラーになります。

context @<スクリプト名> {
    <型> <フィールド名> = <初期値>;
    <型> <フィールド名>;
    ...
}

フィールド初期化子には以下を指定可能:

• リテラル（int / float / str / key / bool / vec / rot / list）
• 定数参照（CONST または lib::CONST）
• 上記を組み合わせた算術式（+, -, *, /, %、ビット演算 & / ^ / |、論理演算、比較、単項 !、括弧）

省略時は型のゼロ値（int=0, str="", bool=false 等）。関数呼び出しや変数参照は使用できない（E0602 InvalidConstExpression）。LSL 生成時、これらの初期化子は定数畳み込みされて単一のリテラル値として出力される（LSL のグローバル変数初期化子は他のグローバル変数を参照できないため）。

例：

const int MAX_COUNT = 100;
const int BASE = 10;

context @main {
    int menu = 1;
    str text = "default";
    int max_value = MAX_COUNT;  // 定数参照
    int answer = 1 + 2 * 3;     // 算術式 → 7
    int offset = BASE + 5;       // 定数参照を含む算術式 → 15（LSL生成時に畳み込み）
    float value;                // 初期値なし（ゼロ値）
}

script main;

main #init|context ctx| {
    ctx.menu = 2;
    ctx.text = "updated";
    int current = ctx.menu;
    current -> owner;
}

プロパティ定義

// attachable定義（装着時にも#initと#animableの処理を実行）
<スクリプト識別子> #attachable;

// animable定義（アニメーション権限を自動要求）
<スクリプト識別子> #animable;

// cache_linknum定義（primのリンク番号をキャッシュ）
<スクリプト識別子> #cache_linknum;

// memory_limit_kb定義（メモリ上限をKB単位で設定）
<スクリプト識別子> #memory_limit_kb <整数値またはconst参照>;

#cache_linknumを指定すると、primインスタンスのリンク番号をキャッシュする_cache_linknum()関数が生成されます。この関数はstate_entryとattachイベントハンドラの先頭で自動的に呼び出されます。関数の先頭でllLinksetDataDeleteFound("^\\$", "")により$プレフィックス付きの既存キャッシュを全削除してから再キャッシュするため、プリム名の変更にも対応します。

primsグループが定義されている場合、グループに属するprimは個別の名前比較ではなく、プレフィックス＋長さによるパターンマッチ条件でまとめて処理されます。これにより生成コードのメモリ使用量が削減されます。グループに属さないprimは従来通り個別の名前比較で処理されます。

#memory_limit_kbを指定すると、state_entryの先頭でllSetMemoryLimitが呼び出されます。値はKB単位で指定し、1024倍されてバイト単位に変換されます。リテラル値のほか、const intで定義した定数を参照することもできます。

script main;

const int MEM_KB = 32;

main #memory_limit_kb MEM_KB;  // → llSetMemoryLimit(32768);

main #init {
    "Ready" -> owner;
}

primメソッド呼び出し

primインスタンスに対してメソッドを呼び出すことができます。

set_colorメソッド

primのカラーを設定します。

#<prim識別子>.set_color|<face>, <color>, <alpha>|;

パラメータ:

• face: 面番号（int）。ALL_SIDESで全面を指定。
• color: 色（vec）。<R, G, B>形式（各値は0.0〜1.0）。
• alpha: 透明度（float）。0.0〜1.0。

使用例:

import standard as std;

script main;
main #cache_linknum;
prim obj1;
prim obj2;

main #attachable;

main #init {
    #obj1.set_color|std::ALL_SIDES, <1.0, 0.0, 0.0>, 1.0|;  // 赤色、不透明
    #obj2.set_color|0, <0.0, 1.0, 0.0>, 0.5|;               // 面0を緑色、半透明
}

descメソッド

primの説明（Description）を取得します。

str description = #<prim識別子>.desc();

戻り値: str型（プリムの説明文字列）。

使用例:

script main;
main #cache_linknum;
prim btn;

main #init {
    #btn.desc() -> world;  // primの説明をチャットに出力
}

注意: primメソッドを使用するには#cache_linknum属性が必要です。

早期リターン文

end;

イベントハンドラーおよびプロシージャの実行を早期に終了します。関数では使用できません。

型システム

基本型

• bool: 真偽値型（true/false）。LSLではinteger型に変換（true=1, false=0）。
• int: 整数型（32bit 符号付き。範囲は -2147483648〜2147483647）。定数式の計算結果がこの範囲を超える場合はコンパイルエラー（E0308）。
• float: 浮動小数点数型。
• str: 文字列型。
• key: UUID型。
• vec: ベクター型（3次元）。
• rot: 回転型（4次元クォータニオン）。

型付きリスト

型安全なリスト操作のため、以下の型付きリスト型をサポートしています：

• ilist: 整数リスト型（要素型: int）。
• flist: 浮動小数点数リスト型（要素型: float）。
• slist: 文字列リスト型（要素型: str）。
• vlist: ベクターリスト型（要素型: vec）。
• rlist: 回転リスト型（要素型: rot）。
• klist: キーリスト型（要素型: key）。

例：

ilist numbers = [1, 2, 3];
slist names = ["Alice", "Bob"];
vlist positions = [<0,0,0>, <1,1,1>];

int first = numbers.at(0);     // 型が int と推論される
str name = names.at(1);        // 型が str と推論される

型互換性ルール

許可される暗黙変換

禁止される暗黙変換

式と演算子

式の構造

項

• リテラル値（数値、文字列、リスト等）
• 識別子
• 関数呼び出し: <関数名>(<引数リスト>)
• ライブラリ関数呼び出し: <エイリアス名>::<関数名>(<引数リスト>)
• メソッド呼び出し: <プリム>.<メソッド名>(<引数リスト>)
• フィールドアクセス: <プリム>.<フィールド名>
• ライブラリ定数アクセス: <エイリアス名>::<定数名>
• インクリメント・デクリメント: ++<変数>, <変数>++, --<変数>, <変数>--
• 括弧式: (<式>)

演算子（優先順位順）

1. 高優先度: *, /, %
2. 加減算: +, -
3. 比較: <, <=, >, >= (戻り値型: bool)
4. 等価: ==, != (戻り値型: bool)
5. 論理: &&, || (戻り値型: bool)
6. ビット: &, |, ^
7. 代入: +=, -=, *=, /=, %=

単項演算子

• 論理否定: !<式>

リテラル

// 数値
123, -456              // 整数
123.45, -67.89         // 浮動小数点数

// 文字列
"文字列内容"

// キー（UUID）
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

// ベクター
<x, y, z>

// 回転
<x, y, z, s>

// リスト
[要素1, 要素2, 要素3]

文字列エスケープシーケンス:

• \": ダブルクォート
• \\: バックスラッシュ
• \/: スラッシュ
• \n: 改行
• \r: キャリッジリターン
• \t: タブ
• \b, \f: LSL非サポートのため変換されず、\b / \f の2文字のまま出力される
• \uXXXX: Unicode文字（4桁16進数）※LSL非サポートのため変換されない

メソッド

メソッド呼び出し・チェーン

<プリム>.<メソッド名>(<引数リスト>)
<プリム>.<メソッド1>(<引数>).<メソッド2>(<引数>)

例：

str text = "hello world";
str result = text.substr(0, 5).replace("l", "x");   // "hexxo"

int number = 123;
str formatted = number.to_str().replace("1", "X");  // "X23"

組み込みメソッド

str型メソッド

str text = "Hello, World!";
text.len()                  // 13
text.substr(0, 5)           // "Hello"
text.index_of("World")      // 7
text.replace("World", "SL") // "Hello, SL!"
text.to_lower()             // "hello, world!"
text.split(", ")            // ["Hello", "World!"]
text.insert(5, "!!")        // "Hello!!, World!"
text.delete(5, 7)           // "Hello World!"

"123".to_int()              // 123

型付きリスト型メソッド（共通）

全ての型付きリスト（ilist, flist, slist, vlist, rlist, klist）で使用可能なメソッドです。

slist names = ["Alice", "Bob", "Charlie"];
names.at(1)                  // "Bob"
names.len()                  // 3
names.index_of("Charlie")    // 2
names.exists("Alice")        // true
names.join(", ")             // "Alice, Bob, Charlie"
names.slice(0, 1)            // ["Alice", "Bob"]
names.delete(1, 1)           // ["Alice", "Charlie"]

ilist nums = [10, 20, 30];
nums.at(0)                   // 10
nums.len()                   // 3

int型メソッド

int num = 42;
num.to_str()                 // "42"

key型メソッド

float型メソッド

float val = 3.14;
val.to_int()                 // 3（小数点以下切り捨て）
val.to_str()                 // "3.14"

vec型メソッド

rot型メソッド

フィールドアクセス

vec型フィールド

rot型フィールド

例：

vec position = <1.0, 2.0, 3.0>;
float x = position.x;    // 1.0

rot rotation = <0.0, 0.0, 0.0, 1.0>;
float s = rotation.s;    // 1.0

// フィールドアクセス後のメソッドチェーン
int x_int = position.x.to_int();

ブロック構文

使用可能な文

ブロック {} 内で使用可能な構文要素：

• 変数定義文
• 変数再代入文
• メッセージ送信文
• プロシージャ呼び出し文
• 条件分岐文（if/elif/else）
• switch文
• for toループ文
• for eachループ文
• 早期リターン文

制御構文

if/elif/else

if <条件> {
    // 処理
} elif <条件> {
    // 処理
} else {
    // 処理
}

while

while <条件> {
    // 処理
}

for to

for int <変数名> = <開始> to <終了> {
    // 処理
}

例：

script main;

main #init {
    for int i = 1 to 10 {
        i -> owner;
    }
}

for each

for <型> <変数名> in <コレクション> {
    // 処理
}

// インデックス付き
for <型> <変数名> in <コレクション> index <インデックス変数> {
    // 処理
}

コレクションにはリスト型（ilist, slist, flist等）またはstr型を指定できます。str型の場合、1文字ずつイテレーションされます。

例：

script main;

main #init {
    slist my_list = ["apple", "banana", "cherry"];
    for str item in my_list {
        item -> owner;
    }
}

str型コレクションの例：

script main;

main #init {
    // str型コレクション（1文字ずつイテレーション）
    for str c in "hello" {
        c -> world;
    }
}

switch

switch <式> {
    <パターン1> => <文またはブロック>;
    <パターン2> => {
        // 複数の文
    }
}

単一文として使用可能なもの：メッセージ送信、変数定義、変数再代入、プロシージャ呼び出し、プリムメソッド呼び出し。

例：

script main;

#greet {
    "Hello!" -> world;
}

#farewell {
    "Goodbye!" -> world;
}

main #listen:0 |str msg| {
    switch msg {
        "hello" => #greet;
        "bye" => {
            #farewell;
            "See you" -> world;
        }
    }
}

デフォルトパターン _:

_（ワイルドカード）を使用すると、どのパターンにも一致しなかった場合の処理を記述できます。

switch face {
    0 => #btn0.set_color|1, <1.0, 0.0, 0.0>, 1.0|;
    1 => #btn1.set_color|1, <0.0, 1.0, 0.0>, 1.0|;
    _ => #btn0.set_color|0, <1.0, 1.0, 1.0>, 1.0|;
}

早期リターン

イベントハンドラーおよびプロシージャの実行を早期に終了します。関数では使用できません。

end;

例：

script main;

#greet |str name| {
    // nameが空なら何もしない
    if name == "" {
        end;
    }
    ("Hello, " + name + "!") -> owner;
}

main #init {
    #greet|"Alice"|;
    #greet|""|;     // end; で処理を抜ける
}

標準ライブラリ

使用方法

標準ライブラリ関数を使用するには、standardライブラリをimportし、プレフィックス付きで呼び出す必要があります。

import standard as std;

script main;

str get_value() = std::read_from_lsd("key");  // 正しい
// str get_value() = read_from_lsd("key");    // エラー

各関数の説明では 戻り値型 関数名(引数型 引数名, ...) の形式（Hitoshina Language の宣言と同じ）でシグネチャを示します。

数学関数

int abs(int value)

絶対値を返す。

• 引数:
  • value (int): 対象となる整数値
• 戻り値: int — 絶対値

float fabs(float value)

浮動小数点の絶対値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 浮動小数点の絶対値

float sin(float value)

正弦値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 正弦値

float cos(float value)

余弦値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 余弦値

float tan(float value)

正接値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 正接値

float asin(float value)

逆正弦値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 逆正弦値

float acos(float value)

逆余弦値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 逆余弦値

float atan2(float y, float x)

逆正接値を返す。

• 引数:
  • y (float): Y成分
  • x (float): X成分
• 戻り値: float — 逆正接値

float log(float value)

自然対数を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 自然対数

float log10(float value)

常用対数を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 常用対数

float pow(float base, float exponent)

累乗を返す。

• 引数:
  • base (float): 底
  • exponent (float): 指数
• 戻り値: float — 累乗

float sqrt(float value)

平方根を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: float — 平方根

int ceil(float value)

天井関数（切り上げ）。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: int — 整数

int floor(float value)

床関数（切り下げ）。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: int — 整数

int round(float value)

四捨五入した値を返す。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: int — 四捨五入した値

float frand(float range)

0からrange未満の乱数を返す。

• 引数:
  • range (float): 乱数の上限（この値未満が返される）
• 戻り値: float — 0からrange未満の乱数

int mod_pow(int a, int b, int c)

モジュラべき乗 (a^b) mod c を計算。

• 引数:
  • a (int): 底
  • b (int): 指数
  • c (int): 法（モジュロ）
• 戻り値: int — (a の b 乗) を c で割った剰余

文字列関数

int string_length(str text)

文字列の長さを返す。

• 引数:
  • text (str): 対象の文字列
• 戻り値: int — 文字列の長さ

str get_sub_string(str source, int start, int end)

部分文字列を返す。

• 引数:
  • source (str): 元の文字列
  • start (int): 開始インデックス（0始まり）
  • end (int): 終了インデックス（0始まり、負値で末尾からの位置）
• 戻り値: str — 部分文字列

str string_trim(str text, int type)

文字列の前後の空白を削除。

• 引数:
  • text (str): 対象の文字列
  • type (int): 種別を指定するフラグ値
• 戻り値: str — 文字列

str to_lower(str text)

文字列を小文字に変換。

• 引数:
  • text (str): 対象の文字列
• 戻り値: str — 文字列

str to_upper(str text)

文字列を大文字に変換。

• 引数:
  • text (str): 対象の文字列
• 戻り値: str — 文字列

int substring_index(str source, str pattern)

部分文字列の位置を検索。

• 引数:
  • source (str): 元の文字列
  • pattern (str): 検索パターン文字列
• 戻り値: int — 部分文字列の位置

str insert_string(str dst, int pos, str src)

文字列を挿入。

• 引数:
  • dst (str): 対象の文字列
  • pos (int): 挿入位置（0始まりのインデックス）
  • src (str): 元の文字列
• 戻り値: str — 文字列

str delete_sub_string(str src, int start, int end)

部分文字列を削除。

• 引数:
  • src (str): 元の文字列
  • start (int): 開始インデックス（0始まり）
  • end (int): 終了インデックス（0始まり、負値で末尾からの位置）
• 戻り値: str — 文字列

str replace_sub_string(str src, str pattern, str replacement, int count)

部分文字列を置換。

• 引数:
  • src (str): 元の文字列
  • pattern (str): 検索パターン文字列
  • replacement (str): 置換後の文字列
  • count (int): 置換回数（0で全件置換）
• 戻り値: str — 文字列

slist parse_string(str src, slist separators, slist spacers)

文字列をリストに分割。

• 引数:
  • src (str): 元の文字列
  • separators (slist): 区切り文字のリスト
  • spacers (slist): スペーサー文字のリスト（区切りつつ結果に含める）
• 戻り値: slist — 文字列リスト

slist parse_string_keep_nulls(str src, slist separators, slist spacers)

文字列をリストに分割（空要素保持）。

• 引数:
  • src (str): 元の文字列
  • separators (slist): 区切り文字のリスト
  • spacers (slist): スペーサー文字のリスト（区切りつつ結果に含める）
• 戻り値: slist — 文字列リスト

slist csv_to_list(str src)

CSVをリストに変換。

• 引数:
  • src (str): 元の文字列
• 戻り値: slist — 文字列リスト

str list_to_csv(slist src)

リストをCSVに変換。

• 引数:
  • src (slist): 元のリスト
• 戻り値: str — 文字列

str dump_list_to_string(slist src, str separator)

リストを文字列に結合。

• 引数:
  • src (slist): 元のリスト
  • separator (str): 区切り文字列
• 戻り値: str — 文字列

str char(int val)

Unicodeコードポイントから文字を生成。

• 引数:
  • val (int): 文字を生成するUnicodeコードポイント
• 戻り値: str — 生成された1文字の文字列

int ord(str val, int index)

文字列中の指定位置の文字のUnicodeコードポイントを取得。

• 引数:
  • val (str): 対象の文字列
  • index (int): コードポイントを取得する文字位置（0始まり）
• 戻り値: int — 指定位置の文字のUnicodeコードポイント

リスト関数

int get_list_length(ilist list)

リストの長さを返す（非推奨: .len()メソッドを使用してください）。

• 引数:
  • list (ilist): 対象の整数リスト
• 戻り値: int — 整数

int list_find(slist src, slist test)

リスト内のリストを検索。

• 引数:
  • src (slist): 元のリスト
  • test (slist): 検索対象のリスト
• 戻り値: int — リスト内のリスト

slist list_sort(slist src, int stride, int ascending)

リストをソート。

• 引数:
  • src (slist): 元のリスト
  • stride (int): ストライド（処理単位）
  • ascending (int): 昇順なら1、降順なら0
• 戻り値: slist — 文字列リスト

slist list_random(slist src, int stride)

リストをランダム化。

• 引数:
  • src (slist): 元のリスト
  • stride (int): ストライド（処理単位）
• 戻り値: slist — 文字列リスト

slist list_insert(slist dst, slist src, int pos)

リストにリストを挿入。

• 引数:
  • dst (slist): 対象のリスト
  • src (slist): 元のリスト
  • pos (int): 挿入位置（0始まりのインデックス）
• 戻り値: slist — 文字列リスト

slist list_replace(slist dst, slist src, int start, int end)

リストの要素を置換。

• 引数:
  • dst (slist): 対象のリスト
  • src (slist): 元のリスト
  • start (int): 開始インデックス（0始まり）
  • end (int): 終了インデックス（0始まり、負値で末尾からの位置）
• 戻り値: slist — 文字列リスト

int get_list_entry_type(slist src, int index)

リスト要素の型を取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: int — リスト要素の型

int list_to_int(slist src, int index)

リストから整数を取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: int — リストから整数

float list_to_float(slist src, int index)

リストから浮動小数点を取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: float — リストから浮動小数点

str list_to_string(slist src, int index)

リストから文字列を取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: str — リストから文字列

key list_to_key(slist src, int index)

リストからキーを取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: key — リストからキー

vec list_to_vec(slist src, int index)

リストからベクトルを取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: vec — リストからベクトル

rot list_to_rot(slist src, int index)

リストから回転を取得。

• 引数:
  • src (slist): 元のリスト
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: rot — リストから回転

float list_statistics(int operation, flist src)

リストの統計値を計算。

• 引数:
  • operation (int): 統計操作の種別（std::LIST_STAT_*定数を指定）
  • src (flist): 元のリスト
• 戻り値: float — リストの統計値

slist list_slice(slist src, int start, int end, int stride, int slice_index)

リストからストライド単位でスライスを抽出。

• 引数:
  • src (slist): スライス対象のリスト
  • start (int): 抽出開始インデックス
  • end (int): 抽出終了インデックス
  • stride (int): ストライド（要素グループのサイズ）
  • slice_index (int): 各ストライド内で抽出する要素のインデックス
• 戻り値: slist — 抽出された要素のリスト

slist list_strided(slist src, int start, int end, int stride)

リストからストライド単位で部分リストを取得。

• 引数:
  • src (slist): 部分リスト抽出対象のリスト
  • start (int): 抽出開始インデックス
  • end (int): 抽出終了インデックス
  • stride (int): ストライド（要素グループのサイズ）
• 戻り値: slist — ストライド抽出された部分リスト

int list_find_next(slist src, slist test, int instance)

リスト内で指定インスタンス番目の一致位置を検索。

• 引数:
  • src (slist): 検索対象のリスト
  • test (slist): 検索するリスト
  • instance (int): 取得する一致のインスタンス番号（0始まり、-1で最後）
• 戻り値: int — 一致開始インデックス（見つからなければ -1）

int list_find_strided(slist src, slist test, int start, int end, int stride)

ストライド境界でリスト内の一致位置を検索。

• 引数:
  • src (slist): 検索対象のリスト
  • test (slist): 検索するリスト
  • start (int): 検索開始インデックス
  • end (int): 検索終了インデックス
  • stride (int): ストライド（一致を許可する境界の間隔）
• 戻り値: int — 一致開始インデックス（見つからなければ -1）

slist list_sort_strided(slist src, int stride, int stride_index, int ascending)

ストライド単位でリストをソート。

• 引数:
  • src (slist): ソート対象のリスト
  • stride (int): ストライド（要素グループのサイズ）
  • stride_index (int): ソートキーとするストライド内のインデックス
  • ascending (int): 昇順なら TRUE、降順なら FALSE
• 戻り値: slist — ソート済みのリスト

型変換関数

int str_to_int(str text)

文字列を整数に変換。

• 引数:
  • text (str): 対象の文字列
• 戻り値: int — 整数

float str_to_float(str text)

文字列を浮動小数点に変換。

• 引数:
  • text (str): 対象の文字列
• 戻り値: float — 浮動小数点数

str int_to_str(int value)

整数を文字列に変換。

• 引数:
  • value (int): 対象となる整数値
• 戻り値: str — 文字列

str float_to_str(float value)

浮動小数点を文字列に変換。

• 引数:
  • value (float): 対象となる浮動小数点数
• 戻り値: str — 文字列

検出関数

センサーイベントやタッチイベントで使用する、検出情報を取得する関数群です。num 引数はイベント内の検出インデックス（0始まり）を指定します。

int detected_face(int num)

タッチされた面番号を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: int — タッチされた面番号

str detected_name(int num)

検出されたアバター/オブジェクトの名前を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: str — 検出されたアバター/オブジェクトの名前

key detected_key(int num)

検出されたアバター/オブジェクトのキーを取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: key — 検出されたアバター/オブジェクトのキー

vec detected_pos(int num)

検出されたアバター/オブジェクトの位置を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — 検出されたアバター/オブジェクトの位置

rot detected_rot(int num)

検出されたアバター/オブジェクトの回転を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: rot — 検出されたアバター/オブジェクトの回転

vec detected_vel(int num)

検出されたアバター/オブジェクトの速度を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — 検出されたアバター/オブジェクトの速度

vec detected_grab(int num)

検出されたグラブオフセットを取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — 検出されたグラブオフセット

int detected_type(int num)

検出されたアバター/オブジェクトのタイプを取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: int — 検出されたアバター/オブジェクトのタイプ

key detected_group(int num)

検出されたアバター/オブジェクトのグループキーを取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: key — 検出されたアバター/オブジェクトのグループキー

key detected_owner(int num)

検出されたオブジェクトの所有者キーを取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: key — 検出されたオブジェクトの所有者キー

int detected_link_number(int num)

検出されたリンク番号を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: int — 検出されたリンク番号

vec detected_touch_st(int num)

タッチされたテクスチャ座標(ST)を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — タッチされたテクスチャ座標(ST)

vec detected_touch_uv(int num)

タッチされたテクスチャ座標(UV)を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — タッチされたテクスチャ座標(UV)

vec detected_touch_normal(int num)

タッチされた面の法線を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — タッチされた面の法線

vec detected_touch_binormal(int num)

タッチされた面の従法線を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — タッチされた面の従法線

vec detected_touch_pos(int num)

タッチされたワールド座標を取得。

• 引数:
  • num (int): イベント内の検出インデックス（0始まり）
• 戻り値: vec — タッチされたワールド座標

プリムプロパティ関数

key get_owner()

プリムの所有者のキーを取得。

• 引数: なし
• 戻り値: key — プリムの所有者のキー

key get_owner_key(key id)

指定されたオブジェクトの所有者キーを取得。

• 引数:
  • id (key): 対象のキー（UUID）
• 戻り値: key — 指定されたオブジェクトの所有者キー

key get_key()

プリムのキーを取得。

• 引数: なし
• 戻り値: key — プリムのキー

str get_prim_name()

プリムの名前を取得。

• 引数: なし
• 戻り値: str — プリムの名前

int get_link_num()

スクリプトが収められているプリムのリンク番号を取得。

• 引数: なし
• 戻り値: int — スクリプトが収められているプリムのリンク番号

str link_name(int linknum)

リンク番号からリンク名を取得。

• 引数:
  • linknum (int): リンク番号（LINK_*定数も使用可）
• 戻り値: str — リンク番号からリンク名

vec get_pos()

プリムのワールド位置を取得。

• 引数: なし
• 戻り値: vec — プリムのワールド位置

rot get_rot()

プリムのワールド回転を取得。

• 引数: なし
• 戻り値: rot — プリムのワールド回転

vec get_scale()

プリムのスケールを取得。

• 引数: なし
• 戻り値: vec — プリムのスケール

vec get_local_pos()

プリムのローカル位置を取得。

• 引数: なし
• 戻り値: vec — プリムのローカル位置

rot local_rot()

プリムのローカル回転を取得。

• 引数: なし
• 戻り値: rot — プリムのローカル回転

vec get_root_pos()

ルートプリムの位置を取得。

• 引数: なし
• 戻り値: vec — ルートプリムの位置

rot get_root_rot()

ルートプリムの回転を取得。

• 引数: なし
• 戻り値: rot — ルートプリムの回転

float get_alpha(int face)

プリムのアルファ値を取得。

• 引数:
  • face (int): 面番号（-1で全面）
• 戻り値: float — プリムのアルファ値

vec get_color(int face)

プリムの色を取得。

• 引数:
  • face (int): 面番号（-1で全面）
• 戻り値: vec — プリムの色

str get_texture(int face)

テクスチャ名を取得。

• 引数:
  • face (int): 面番号（-1で全面）
• 戻り値: str — テクスチャ名

str get_object_desc()

オブジェクトの説明を取得。

• 引数: なし
• 戻り値: str — オブジェクトの説明

key get_creator()

オブジェクトの作成者キーを取得。

• 引数: なし
• 戻り値: key — オブジェクトの作成者キー

int get_number_of_prims()

リンクセット内のプリム数を取得。

• 引数: なし
• 戻り値: int — リンクセット内のプリム数

int get_number_of_sides()

プリムの面数を取得。

• 引数: なし
• 戻り値: int — プリムの面数

key get_link_key(int linknum)

リンク番号からキーを取得。

• 引数:
  • linknum (int): リンク番号（LINK_*定数も使用可）
• 戻り値: key — リンク番号からキー

int get_object_prim_count(key id)

オブジェクトのプリム数を取得。

• 引数:
  • id (key): 対象のキー（UUID）
• 戻り値: int — オブジェクトのプリム数

float get_mass()

プリムの質量を取得。

• 引数: なし
• 戻り値: float — プリムの質量

float get_object_mass(key id)

オブジェクトの質量を取得。

• 引数:
  • id (key): 対象のキー（UUID）
• 戻り値: float — オブジェクトの質量

slist get_link_prim_params(int linknum, ilist rules)

リンクプリムのパラメータリストを取得。

• 引数:
  • linknum (int): リンク番号（LINK_*定数も使用可）
  • rules (ilist): ルールリスト（プリムパラメータ定数列）
• 戻り値: slist — リンクプリムのパラメータリスト

slist get_object_details(key id, ilist params)

オブジェクトの詳細情報を取得。

• 引数:
  • id (key): 対象のキー（UUID）
  • params (ilist): パラメータリスト
• 戻り値: slist — オブジェクトの詳細情報

slist get_bounding_box(key object)

オブジェクトのバウンディングボックスを取得。

• 引数:
  • object (key): バウンディングボックスを取得する対象のキー
• 戻り値: slist — 最小コーナーと最大コーナーの2ベクトルのリスト

vec get_center_of_mass()

オブジェクトの質量中心を取得。

• 引数: なし
• 戻り値: vec — オブジェクトの質量中心のワールド座標

vec get_geometric_center()

オブジェクトの幾何中心を取得。

• 引数: なし
• 戻り値: vec — ルートプリム基準の幾何中心オフセット

int get_link_number_of_sides(int link)

リンクプリムの面数を取得。

• 引数:
  • link (int): 対象のリンク番号またはLINK定数
• 戻り値: int — リンクプリムの面（サイド）数

float get_mass_mks()

オブジェクトの質量をMKS単位（kg）で取得。

• 引数: なし
• 戻り値: float — オブジェクトの質量（kg）

float get_max_scale_factor()

オブジェクトを拡大できる最大係数を取得。

• 引数: なし
• 戻り値: float — 拡大可能な最大の倍率

float get_min_scale_factor()

オブジェクトを縮小できる最小係数を取得。

• 引数: なし
• 戻り値: float — 縮小可能な最小の倍率

slist get_primitive_params(slist params)

プリムのパラメータリストを取得。

• 引数:
  • params (slist): 取得するPRIM_*定数の指定子リスト
• 戻り値: slist — 要求したPRIM_*パラメータの値リスト

int scale_by_factor(float scaling_factor)

オブジェクト全体を係数倍にリサイズ。

• 引数:
  • scaling_factor (float): オブジェクト全体を拡大縮小する係数
• 戻り値: int — リサイズの成否を示すステータス（成功でTRUE）

vec get_texture_offset(int face)

面のテクスチャオフセットを取得。

• 引数:
  • face (int): 対象の面番号（ALL_SIDESで全面）
• 戻り値: vec — 面のテクスチャオフセット（U/Vのベクトル）

float get_texture_rot(int face)

面のテクスチャ回転を取得。

• 引数:
  • face (int): 対象の面番号（ALL_SIDESで全面）
• 戻り値: float — 面のテクスチャ回転角（ラジアン）

vec get_texture_scale(int face)

面のテクスチャスケールを取得。

• 引数:
  • face (int): 対象の面番号（ALL_SIDESで全面）
• 戻り値: vec — 面のテクスチャスケール（U/Vのベクトル）

slist get_prim_media_params(int face, slist params)

面のメディアパラメータを取得。

• 引数:
  • face (int): 対象の面番号
  • params (slist): 取得するPRIM_MEDIA_*定数のリスト
• 戻り値: slist — 要求したメディアパラメータの値リスト

int set_prim_media_params(int face, slist params)

面のメディアパラメータを設定。

• 引数:
  • face (int): 対象の面番号
  • params (slist): PRIM_MEDIA_*定数と値のパラメータリスト
• 戻り値: int — 設定の成否を示すステータス（STATUS_OK等）

int clear_prim_media(int face)

面のメディアを消去。

• 引数:
  • face (int): メディアを消去する面番号
• 戻り値: int — 消去の成否を示すステータス（STATUS_OK等）

slist get_link_media(int link, int face, slist params)

リンクプリムの面のメディアパラメータを取得。

• 引数:
  • link (int): 対象のリンク番号またはLINK定数
  • face (int): 対象の面番号
  • params (slist): 取得するPRIM_MEDIA_*定数のリスト
• 戻り値: slist — 要求したメディアパラメータの値リスト

int set_link_media(int link, int face, slist params)

リンクプリムの面のメディアパラメータを設定。

• 引数:
  • link (int): 対象のリンク番号またはLINK定数
  • face (int): 対象の面番号
  • params (slist): PRIM_MEDIA_*定数と値のパラメータリスト
• 戻り値: int — 設定の成否を示すステータス（STATUS_OK等）

int clear_link_media(int link, int face)

リンクプリムの面のメディアを消去。

• 引数:
  • link (int): 対象のリンク番号またはLINK定数
  • face (int): メディアを消去する面番号
• 戻り値: int — 消去の成否を示すステータス（STATUS_OK等）

インベントリ関数

int get_inventory_type(str name)

指定された名前のインベントリアイテムのタイプを取得。

• 引数:
  • name (str): 対象の名前
• 戻り値: int — 指定された名前のインベントリアイテムのタイプ

int get_inventory_num(int type)

指定されたタイプのインベントリアイテム数を取得。

• 引数:
  • type (int): 種別を指定するフラグ値
• 戻り値: int — 指定されたタイプのインベントリアイテム数

str get_inventory_name(int type, int index)

指定されたタイプとインデックスのインベントリアイテム名を取得。

• 引数:
  • type (int): 種別を指定するフラグ値
  • index (int): リスト内のインデックス（0始まり）
• 戻り値: str — 指定されたタイプとインデックスのインベントリアイテム名

key get_inventory_key(str name)

インベントリアイテムのキーを取得。

• 引数:
  • name (str): 対象の名前
• 戻り値: key — インベントリアイテムのキー