MPS 2026.2 ヘルプ

SModel 言語クエリ

比較

:eq: および :ne: 演算子は、ノードの等価性を比較するために使用できます。演算子は null セーフです。

クエリ

名前でノードを取得する

node-ptr/.../ 構成要素を使用して、その名前を使用してノードへの参照を取得します。

ndptr1.png

ノードが特定のものであることを確認するために、「is」操作が使用可能です。

equals.is(Object->equals);

ノードへのポインターを取得するには、ポインター構造を使用します。

ndptr2.png

名前で概念を取得する

概念 /.../ 構造を使用して、名前を指定して概念宣言を取得します。

concept<CommandList> myConcept = concept/CommandList/;  

コンセプトスイッチ構造を使用して、手元のコンセプトに応じてロジックをブランチオフにすることができます。

ConceptSwitch.png

機能へのアクセス

SModel 言語を使用して、次の機能にアクセスできます。

  • プロパティ

  • 子供

  • 参照

それらにアクセスするには、次の構文が使用されます。

<node expression>.featureName.

フィーチャがプロパティである場合、式全体のタイプはプロパティのタイプです。フィーチャーが参照または 0..1 またはカーディナリティーの子である場合、この式のタイプは node <LinkTarget> です(LinkTarget は参照または子宣言のターゲットコンセプトです)。フィーチャーが 0..n カーディナリティーの子である場合、この式のタイプは nlist <LinkTarget> です。

いわゆる暗黙的選択を使用して、子ノードの機能にアクセスできます。例: 次のクエリ:

thisNode.children.grandChildren

MPS によって次のようなものに自動的に変換されます。

thisNode.children.selectMany({~it => it.grandChildren; })

その結果、指定されたリンク宣言のチェーンを介してアクセス可能なすべての非 null モデル要素のプレーンコレクションが作成されます。

null チェック

MPS では null は自由に扱われるため、null 値をチェックする方法が必要です。isNull および isNotNull 操作は、ここで私たちの友達です。

IsInstanceOf チェックと型キャスト

ノードが特定の概念のインスタンスであるかどうかを確認する必要がある場合がよくあります。Java の instanceof 演算子は Java オブジェクトしか認識しないため、MPS ノードには適用できません。このようなチェックを行うには、次の構文を使用する必要があります。

<node expression>.isInstanceOf(Concept)

また、isExactly 操作があります。これは、ノードの概念がユーザーによって指定されたものと正確に一致するかどうかをチェックします。

コンセプトに対してノードのタイプを確認したら、通常、コンセプトインスタンスに式をキャストし、このコンセプトの機能の一部にアクセスする必要があります。そのためには、次の構文を使用する必要があります。

<node expression> : Concept

ノードを特定の概念インスタンスにキャストする別の方法は、as キャスト式を使用することです。

<node expression> as Concept

通常のキャスト(コロンを使用)と as キャストの違いは、左側の式の結果を指定された Concept インスタンスに安全にキャストできない場合の状況を処理する方法にあります: NullPointer 例外がレギュラーによってスローされますこの場合はキャストしますが、as キャストによって null が返されます。

これを smodel 言語の null セーフドット演算子と組み合わせると、モデル内を移動するための非常に便利な方法が得られます。

node.parent as BinaryOperation.leftExpression as BinaryOperation.leftExpression.isLValue()

ノードコレクションキャスト

ノードのコレクションは、ofConcept 構成要素を使用して、ノードの概念によってフィルタリングおよびキャストできます。

node.statements.ofConcept<LocalVariableDeclaration>

seq.ofConcept<MyConcept> は seq.ofType<node<MyConcept>> と同等です

アスペクトコレクションキャスト

seq.ofAspect<structure> は特定の側面のノードをフィルターします

親

ノードの親を見つけるために、すべてのノードで親操作を使用できます。

子

子操作を使用して、現在のノードのすべての直接の子ノードにアクセスできます。この操作には、オプションのパラメーター linkQualifier があります。このパラメーターを使用すると、children <linkQualifier> 操作の結果は node.linkQualifier 操作呼び出しと同等であるため、linkQualifier グループ / ロールに属する子のみが呼び出されます。例: classDef.children <annotation、member>

兄弟クエリ

AST を操作するとき、ノードの兄弟(つまり、検討中のノードと同じロールと親を持つノード)にアクセスすることがよくあります。このタスクには、次の操作があります。

  • next-sibling/prev-sibling- ノードの次 / 前の兄弟を返します。そのような兄弟が存在しない場合、null が返されます。

  • next-siblings/prev-siblings- ノードの次 / 前の兄弟の nlist を返します。これらの操作には、現在のノードを含めるかどうかを指定するオプションのパラメーターがあります。

  • 兄弟 - ノードのすべての兄弟の nlist を返します。これらの操作には、現在のノードを含めるかどうかを指定するオプションのパラメーターがあります。

上位

モデル操作において、特定のノードのすべての祖先(親、祖父母、さらにその先の祖先)を見つける必要がある場合がよくあります。このような場合のために、次の 2 つの操作があります。

  • 祖先 - ノードの単一の祖先を返します

  • 祖先 - ノードのすべての祖先を返します。どちらにも、リストを絞り込むための次のパラメーターがあります。

  • コンセプトタイプの制約: concept = Concept、[ConceptList] のコンセプト

  • 現在のノードを含めるかどうかを示すフラグ: +

例: myNode.ancestors <concept = InstanceMethodDeclaration、+>

子孫

また、指定されたノードのすべての子孫(直接の子、子の子など)を見つけることも役立ちます。このような目的のために子孫操作があります。以下のパラメーターがあります。

  • コンセプトタイプの制約: concept = Concept、[ConceptList] のコンセプト

  • 現在のノードを含めるかどうかを示すフラグ: +

例: myNode.descendants <concept = InstanceMethodDeclaration>

ルートとモデルを含む

指定されたノードの最上位の祖先ノードにアクセスするには、包含ルート操作を利用できます。モデル操作の結果として、包含モデルが使用可能になります。

以下に例を示します。

  • node <> containsRoot = myNode.taining root

  • モデル owningModel = myNode.model

モデルクエリ

model-ptr/.../ 式は、モデルへの解決可能な参照を取得します。リポジトリを使用すると、model <> タイプに解決できます。

多くの場合、特定の条件を満たすモデル内のすべてのノードを検索する必要があります。model <> タイプの式に適用可能ないくつかの操作があります。

  • roots()/rootsIncludingImported()- 指定されたコンセプトのインスタンスであるモデル内のすべてのルートを返します

  • nodes()/nodesIncludingImported()- 指定されたコンセプトのインスタンスであるモデル内のすべてのノードを返します

例: model.roots(<all>)、model.nodes(IfStatement) または model.nodes(#someNode.concept)

検索範囲クエリ

状況によっては、指定されたノードにどの参照を設定できるかを調べたいことがあります。このような場合には、検索範囲操作があります。次の構文で呼び出すことができます。

<node expression>.search scope(link, operationContext)

コンセプトリテラル

多くの場合、指定された概念への参照が必要です。このタスクには、概念リテラルがあります。次の構文があります。

concept/ConceptName/

例: concept <IfStatement> コンセプト = concept/IfStatement/

コンセプト操作

指定されたノードの概念を見つけたい場合は、ノードで概念操作を呼び出すことができます。

例: concept <IfStatement> コンセプト = myNode.concept

非推奨の型からの移行

ConceptNode <> タイプと conceptNode 操作は非推奨になりました。asConcept 操作がコンセプト <> に conceptNode <> を変換します。一方、asNode 操作は逆の変換を行い、concept <> の node <AbstractConceptDeclaration> を返します。

概念階層クエリ

概念タイプを使用して、式のスーパー / サブコンセプトを照会できます。次の操作を自由に行えます。

  • スーパーコンセプト / すべて - 指定された概念のすべてのスーパーコンセプトを返します。現在の概念を含める / 除外するオプションがあります -super-concepts/all <+>

  • super-concepts/direct- 指定された概念のすべての直接スーパーコンセプトを返します。繰り返しますが、現在の概念を含める / 除外するオプションがあります -super-concepts/direct <+>

  • sub-concepts - サブコンセプトを返します

例:

concept <IfStatement> concept = myNode.concept;

list <concept <>> superConceptsAll = concept.super-concepts/all;

concept.super-concepts/direct <+>;

Concept.sub-concepts(model);

concept <IfStatement> concept = myNode.concept;

list <concept <>> superConceptsAll = concept.super-concepts/all;

concept.super-concepts/direct <+>;

concept.sub-concepts(model、myScope);

hasRole 操作

ノードに特定のロールがあるかどうかを確認したい場合があります。このために、次の構文があります。

<node expression>.hasRole(Concept : child)

以下に例を示します。

myNode.hasRole(IfStatement : elsifClauses)

リンククエリ

リンク操作により、ノード間のリンクの詳細にアクセスできます。SReferenceLink の smodel タイプである関連付けを返します。

association link = link/ClassCreator : constructorDeclaration/; SReferenceLink l = link link.isOptional(); link.getDeclarationNode(); link.getOwner(); link.getName(); link.getTargetConcept(); link.getScope(decl/); ...

リンククエリを含む

次の式を使用して、あるノードが別のノード(親)に追加された場合:

parent.childLinkRole.add(node)

その後、次の操作を呼び出して、包含関係情報にアクセスできます。

  • containsRole- このノードを含む親ノードの子ロールを表す文字列を返します (上記の場合の「childLinkRole」)

  • containingLink - 戻るノード <LinkDeclaration> このノードを含む親ノードのリンク宣言を表します

  • index- 対応するロールを持つ子のリストでこのノードのインデックスを表す int 値を返します。上記のモデルに対する次のクエリと同じです。

parent.childLinkRole.indexOf(node)

ダウンキャスト

より低い意味レベルへのダウンキャスト

SModel 言語は、生の MPS クラスで機能するコードを生成します。これらのクラスは通常の作業ではかなり低レベルですが、例外的なケースでは、それらにアクセスする必要がある場合があります。低レベルのオブジェクトにアクセスするには、ダウンキャストを使用してセマンティックレベルの構成を下げる必要があります。構文は次のとおりです。

<node expression>/

以下に例を示します。

myNode/ .getConcept()。findProperty("name" )

2026 年 8 月 06 日