powershell クラス関数 括弧 構文エラー

Question

前提・実現したいこと

クラスの機能を勉強しています

functionを実装中に以下のエラーメッセージが発生しました。

このエラーをなくす方法を知りたいです。

発生している問題・エラーメッセージ

Missing '(' in class method parameter list
Missing function body in function declaration

該当のソースコード

class pstest {
    [bool] $KeyAddress
    function pstest{
        Param (
            #Target Registry Address
            [Parameter(Mandatory)]
            [string]
            $KeyAddress,
            # Target Property List
            [Parameter(Mandatory)]
            [List]
            $KeyName
        )
        $this.$KeyAddress
        
    }
    function test {
        param (
        )
        return "a"
    }
}

$testcase001 = New-Object pstest("Registry::HKCR\","Name")
$testcase001.test

試したこと

paramの書き方や、エラーメッセージを検索しましたが、解決の糸口がつかめません。

補足情報（FW/ツールのバージョンなど）

######Vscode

• バージョン: 1.45.1 (system setup)
• コミット: 5763d909d5f12fe19f215cbfdd29a91c0fa9208a
• 日付: 2020-05-14T08:27:35.169Z
• Electron: 7.2.4
• Chrome: 78.0.3904.130
• Node.js: 12.8.1
• V8: 7.8.279.23-electron.0
• OS: Windows_NT x64 10.0.18363

######拡張機能

• ms-vscode.powershellを使用

######powershell

• PSVersion 7.0.1
• PSEdition Core
• GitCommitId 7.0.1
• OS Microsoft Windows 10.0.18363
• Platform Win32NT
• PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
• PSRemotingProtocolVersion 2.3
• SerializationVersion 1.1.0.1
• WSManStackVersion 3.0

Comments

[Zuishin]

https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_classes?view=powershell-7

書き方が違います。

[Zuishin]

クラスの書き方を知らないのに関係ない Param をググって侍や Qiita を見ているから解決の糸口がつかめないのであって、クラスの書き方を知らなければクラスの書き方を公式ヘルプで調べればいいんです。

わからないことがあったらまず Get-Help about_ を実行します。すると、何かについて説明したドキュメント一覧が並ぶので、そこから見ていきます。
この場合は about_Classes を見ると解決できます。

[ShortArrow]

公式ドキュメントのリンクありがとうございます。
about_functionsとabout_Classを読み返しました。

ドキュメントに項目が無いということは、クラス関数ではparam書式が使用できないんですね。
powershell好きだったんですが、初めて嫌いなところが出来ました。

Powershell拡張機能にて、`function`スニペットを使用すると、
```powershell
function FunctionName {
param (
OptionalParameters
)

}
```
と出てくるので、勘違いして思い込みをしていました。先入観が怖いです。
function って先頭につきっぱなしですけど、これは関数宣言の書式ではなくて、戻り値の型なんですね。

Pythonの拡張機能では`function`スニペットで、`class function`か`nomal`かなど、選択できます。そこから類推して、Powershellではどちらも同じ書式だから区別する必要が無いから、スニペットもこうなっていると思ってしまいました。

今考えると、Powershellの`function`スニペットは`normal`と`advance`、`inline`の３種ありますが、
ふつうはどれでも書けるけど、クラス関数だけは`inline`しか使えないということなのかなと推理できます。

いつも`https://docs.microsoft.com/`のブックマークから階層を降りていくか、「Microsoft Docs」を検索ワードに含めて検索していたので、`Get-Help about_ `という使い方があるのは知らなかったです。ありがとうございます。

[ShortArrow]

いまさらに精読していまして、気が付いたのですが、
ひょっとして、Powershellではmethodとfunctionって別次元の存在なのですか？

[Zuishin]

クラスに書くのは PowerShell の function(コマンドレット)でなく、.NET のメソッドなので、別物と思っておけばいいと思います。

例えばパラメーターセットは PowerShell 独自のシステムなので、.NET メソッドでは使えません。

呼び出す時も、function は引数を空白区切りで与えますが、.NET メソッドはカッコで包んでカンマ区切りで与えます。

[ShortArrow]

ありがとうございます。

ほかの言語と同じ考え方で、なんとなくでコーディングできるだろうと、甘く見ていました。Powershellは、ひと味違いました。

ただ構文を知らないだけではなく、概念が存在しないものを作ろうとしていたとは。改めて、先入観が怖いです。

[Zuishin]

本来の PowerShell のオブジェクト指向は、継承を持たないインスタンスベースなんですが、.NET のクラスベースのオブジェクトも使うことができるため、二種類のオブジェクト指向システムがあることになります。COM も入れれば三種類ですね。PowerShell を使って .NET クラスの作成まで行いたいという要望から生まれたのが class 構文です。三種類のシステムはそれぞれ設計思想が違うため、これらが違うものだという意識を持っておいた方が良いと思います。

継承が必要ないのであれば、Add-Member で NoteProperty や ScriptMethod を追加することでオブジェクトを扱うことができます。作られた当初はこれで十分と思われていたんでしょうね。

Answer 1

そもそもPoweShellには、classの中にfunctionを書く構文が存在しないのではないでしょうか？

https://docs.microsoft.com/ja-jp/powershell/scripting/dsc/resources/authoringresourceclass?view=powershell-7
https://www.vwnet.jp/Windows/PowerShell/2017082001/PSv5Class01.htm

質問に書いてあるコードには問題が多すぎて何をやりたいのか理解できませんが、以下コードのようにすればエラーが発生せずに動きます。

class pstest {
    [string] $KeyAddress
    pstest([string] $KeyAddress, [string] $KeyName) {
        $this.KeyAddress = $KeyAddress
    }
    [string] test() {
        return $this.KeyAddress
    }
}

$testcase001 = New-Object pstest("Registry::HKCR\","Name")
$testcase001.test()

Comments

[ShortArrow]

ありがとうございます。書きかけで、そのまま投げた回答側のことを考えていないコードでした。それにもかかわらず的確な回答をいただきありがとうございます。

最終的に以下の内容で理解できました。

https://www.vwnet.jp/Windows/PowerShell/MakePSCredential.htm
>>Class は拡張された function で内部に値(プロパティ)を持ち、メソッドで操作が出来ます。

[Zuishin]

> Class は拡張された function で内部に値(プロパティ)を持ち、メソッドで操作が出来ます。

ちょっとこの表現は酷すぎるので、これで理解できたと思ったなら調べ直した方がいいと思います。そしてそのページを参考にするのはやめましょう。

高評価を取り消し、低評価します。

クラスでできなくて function でできることはありますし、function もプロパティを持ちます。

[Zuishin]

またこのページでは、クラスとオブジェクトを混同しています。

分かりやすく見える嘘は本当を覆い隠し、本当のことをわかりにくくします。

[ShortArrow]

ありがとうございます。最後まで学習を進める前に気が付かせていただいて助かりました。

ちゃんと公式ドキュメントを読むようにします。