Visual Basic / C#　/ C++

ちょっとメモ

やまだ — Wed, 31 Aug 2011 21:57:00 GMT

ひっそりひっそり。

KAXAML

長らく更新が止まっていた軽量XAMLエディタ。で、いきなりバージョン 1.8 って何ぞ。

最新版への対応はうれしいけど、「軽量」というところが怪しくなっている気がしないでもない……。

Small Basic

帰ってきた BASIC。VB ではない Basic。ついに、1.0 リリース。

いや、こーゆーシンプルなのも懐かしくて良いかと。

自作室: .NET Framework 用の言語コンパイラを作成する

ちょっとコンパイラ作って遊んでみたい人はこの辺から？

つーことで、メモメモ。

では。

クロスオーバーさせてみよう

やまだ — Sat, 31 Jan 2009 14:49:00 GMT

ほら、やっぱりエントリが月末になったっちゃぢゃん。

＃で、間が空く分、無駄に長くなる、と。＜無駄とか言うなー。

……えーと。

やまだです。

で、タイトルの件なのですが、いや、なに、そんな大層な話ではなかったりします。

良いタイトルが浮かばなかっただけ、というのは、君と僕との秘密さっ＜もうええっちゅうに。

スペシャリストの方はいーっぱいいるので、ふかーい方の話はそっちに任せるとして、

今回は、複数の技術を組み合わせたり、比較してみると面白いかもよ、ってな話です。

役にたつかどーかはわからんけど。まぁ、私の書くものって、そんなもんです。

で、いくつか見つけたものをまとめて紹介しておこうかと。

・Ja.NET

http://www.janetdev.org/

＃ちなみに、この名前は「じゃんぬねっと」とは読まないようですｗ

.NET Framework 上で動く Java ですねー。

え？それになんの意味がある？.NET Framework 上で動かすんだったら C# や VB.NET でいーじゃん？

……そんなこと訊かれてもねぇ。いや、なんか面白そうな気がしないですか？

しない？……そーですか……。

・Glasshopper ( Mainsoft for Java EE Developer Edition )

http://dev.mainsoft.com/Default.aspx?tabid=177

Visual Studio で開発するJavaアプリ。Visual Studio で開発したアプリケーションが、Javaのコードになります。

いや、それだったら最初からJavaの方が開発効率は良い？

……まぁ、私もそう思わないでもないんですけどねー(笑)。でも、言語間の違いとかわかって面白いです。

実際の開発でそんなの使えるか、と言われると、確かに厳しそうな気もしますけど。

・eFace

http://www.soyatec.com/eface/

で、こっちは Java で XAML を使ってみよう、という話ですね。

まだまだライブラリが充実しないと、本格的に使えないかなーとも思いますけど、動くだけで面白いです。

ただねー、これ、eclipse用しか用意されてなくて、NetBeans用がないんですよねー。

最近の eclipse はアドインの嵐で、アドイン間のコンフリクトとかものすげーめんどくさい感があるので、自分で遊ぶなら NetBeans の方が好みなんですけど。

あ、そういえば eclipse と NetBeans、それぞれ使ってみると、開発環境としての考え方の違いとか、さらに Visual Studio とかと違いとかもあるので面白いですよー。

で、.NET Framework でプログラム開発とかいうと、C# か VB.NET か、いやいやC++でしょ、とかって話があったりするわけですが……。

もう、なんかね、いっそ MSILでいーんじゃないかと……思わないでもないでもなかったり。 ← どっちなんだ

＃厳密には MSIL でなくて CIL (Common Intermediate Language) が正式名称でしたっけ？

・ECMA-335 / Common Language Infrastructure (CLI)

http://www.ecma-international.org/publications/standards/Ecma-335.htm

無償で入手できる CLI 仕様。

ただねー、500頁を超えるようなドキュメントをPC上で見るのはつらいです。かといって、印刷するのも大変だし。

で、最近は MSIL で遊びつつあります。これはこれで面白いですよ。

そのうちまとめてなんとかしようかと思わないでもなかったり。

VB.NETやC#のコードがMSILではこーなってるのかー、とか、あーこの辺は Java VM と同じだー、とか、おーこっちはこーなってるのかー、とか。

ということで、ついでにJava の原典も紹介しておきましょうか、ということで。

・The Java Virtual Machine Specification

http://java.sun.com/docs/books/jvms/second_edition/html/VMSpecTOC.doc.html

大丈夫、十分英語版でも読めますよー。

＃私が紹介すると、プログラム言語仕様でないところがミソですねーｗ

それでシステム開発の役にたつのかー、という疑問もありますけど、それをいっちゃあ、ということで。

でも、知っていることの幅を広げるのは良いことかと。効率は激しく悪いかもしれないですが。

では。次は２月末日ですかね、……ってしゃれにならんな。

２月は日数が少ないから気をつけないと、って、おい。

ドキュメントは読みましょう？（しつこく Sandcastle ）

やまだ — Wed, 24 Dec 2008 23:18:00 GMT

やまだです。……えーと、お忘れかもしれませんが、そういう奴もいるんです。

……えー、いるよな……たぶん……。

少なくとも、私は「いる」と信じたい！いーから、だまされたと思って「いる」としてみろ！だまされるから！……あれ？

……はぁ、まぁ、そんなものです。

今回も、しつこく Sandcastle の話です。ほとんど、困ったときの Sandcastle ネタ、って感じになってますが。

困ったもんだ。……あ、困ってるから Sandcastle ネタなのかｗ

で、.NET Framework で API リファレンスを作成する場合、ほとんど感覚的には JavaDoc 相当箇所に同様のコメントを入れていけば良いだけなのですが、ふと疑問に思うことがあるわけです。

「クラスとメソッドはその直前にXML形式でコメントを追加すれば良い。でも、名前空間に対するコメントはどこに書けば良いのよ？」

で、これまでの対処法としては、私は以下の２つでしのいでいたりしたわけなんですが。

その１．Sandcastle Help File Builder で ShowMissingNamespaces 指定を False にする

はい、へたれですね。名前空間にはコメント付いてなくても良しとしよー、と。

この指定を False にしておくと、作成される API リファレンスで「名前空間にコメント付いてないよー」というエラーが出力されなくなります。

名前空間に対するコメントなんて、さらりとなかったことにしてしまうというｗ

その２．Sandcastle Help File Builder で Namespaces メニューボタンから個別にコメントを追加する

まぁ、こーすれば名前空間に対するコメントは記述できます。

こんな画面が開くので、中段で対象とする名前空間を選んで、下段の「Edit the summary for the selected namespace」の中にコメントを書けば良いだけなんだけど……。

なんかねー、すっきりしないのよ。他のAPI仕様はソースコード内で、名前空間はツール内で、ってコメント場所が分かれると。

Javaなんかだと、package.html ファイルをパッケージごとに作っておけるので、ソースコードとコメントがまとめて管理できるので便利なんだけどなー、とか思ったりします。

それに、<summary> タグはいいけど <remarks> タグはどうするのよ、ってな話もあったりします。

タグごと書けば、両方書けるんだけどねー。でも、生成されるファイルではどちらも <summary> タグの位置だから変なのよ。やっぱり、<summary> の内容は冒頭に、<remarks> の内容は末尾に出力して欲しいよねー、と。

ところが、この２つ以外にも方法があるってことが、ようやく最近になってわかってきたりして。

それが次に挙げる「その３」、とゆーわけです。

その３．名前空間ごとに NamespaceDoc クラスを作成する。

ということで、この方法があったりします。

つまり、名前空間のコメントを入れるためのクラスを定義してしまうってゆー、まーなんというか、盲点というか、抜け道というかｗ

C# だとこんな感じですねー。

namespace 対象とする名前空間 {
    /// <summary>
    /// 名前空間の概要
    /// </summary>
    /// <remarks>名前空間の補足</remarks>
    [System.Runtime.CompilerServices.CompilerGeneratedAttribute()]
    class NamespaceDoc {
    }
}

VB.NET だとこんな感じですねー。VB.NET だと明示的に名前空間を書かないのが通常かもしれないですが、このクラスについては明示的に書いておいた方が混乱がないかもです。

Namespace 対象とする名前空間
    ''' <summary>
    ''' 名前空間の概要
    ''' </summary>
    ''' <remarks>名前空間の補足</remarks>
    <System.Runtime.CompilerServices.CompilerGeneratedAttribute()> _
    Public Class NamespaceDoc
    End Class
End Namespace

で、これらのクラスを定義しておくと、Sandcastle でちゃんと名前空間用のコメントが反映されることとなりますー。

あ、この方法は「その２」とは共存できないようなので注意です。まぁ、当然っちゃ当然のような気もするけど。定義が重複している、とかってエラーが表示されたような……。

↑ここで再検証しないところが、またへたれですね。＃もー、そんな気力はとっくになくなっているので。

で、この方法をどこで見つけたかというとですね。えーと、さっきの「その２」で挙げたウィンドウ右下のところに「Help」ってボタンがあるですよ。

ツールの操作方法なんて直感的にわかるし、英語読むなんて面倒だしなぁ、……と放置だったんですが、ある時、なんとなく「Help」ボタンを押して、ヘルプファイルをざっと眺めてみて、……あれ？この「Using a NamespaceDoc Class」って何だ？と思ったという（苦笑）。

やっぱ、ドキュメント読むって大事だわ（笑）。

で、ドキュメントを読むことも大事だけど、空気を読むことも大事ですね、という話でした。……あれ？

えーと、……KY でごめんなさい、ごめんなさい、ごめんなさい。

内容のわりに長いエントリでごめんなさい、ごめんなさい、ごめんなさい。

それでは皆様、良いお年を。また、１月末にお会いしましょう。

……をい。　← でも、しゃれになってなかったりする…… orz

WPFでSandcastleを使ってみた

やまだ — Sun, 30 Nov 2008 20:15:00 GMT

えーと、前回の大阪勉強会以来ですかね。とりあえず11月の駆け込みエントリということでｗ

やまだです。

なんか大阪の方が私のホームになってきた感のある今日この頃、皆様いかがお過ごしでしょうか？

＃ホームレス、という話もありますがｗ

相変わらずちまちまと自宅でWPFプログラムを弄ってたりします。あまり時間もとれないし、一つ機能を入れるたびにリファクタリングの嵐で遅々としてしか進んでいなかったりしますが。

で、せっかくWPFでプログラム作ってることだし、ひさしぶりにSandcastleでAPIリファレンスでも出してみるかなぁ、と。別にWPFだからってSandcastleの何が変わるわけでもないはずで、まぁとりあえずやってみるべしと。

で、それだけのことなのに、なぜかはまること、はまること。

その１．なんか変だ

え、変なのはお前だ、って？あ、はい、まあそれは置いておくとして（認めるのかっ）

生成されたAPIリファレンスの表示が何かおかしかったりします。ドキュメント内リンクも有効になっていないし。

でも、"Build completed successfully." って表示が出てるしなぁ。ちゃんと出力されているはずなんだが……、とログを見て、途中にある文字列に気づきます。

OutOfMemory

……おーい。……ぉーぃ、ぉーぃ、ぉーぃ……。

むなしくコダマが響きます……。

……成功していないだろうがっ！

教訓１．Sandcastle Help File Builder は、成功していなくても "Build completed successfully." って表示することがあるので要注意です。何かあやしいと思ったらログを追っかけるべし！

その２．さっきは成功したのに……

え、学習効果がないのは、お前だ、って？……あー、そーかも。

なんかねー、ドキュメントの再生成を繰り返しているうちに、動作が変わるんですよ。で、原因は↑の OutOfMemory だったりして。

で、一度終了させて、もう一度起動しなおすと今度はちゃんと動いたり。

……これって、メモリリーク起こしてないか？とあらぬ疑いをかけてみる。

＃自分の期待どおりの動作しなかったら、バグだーと叫ぶ困った人、いますよねー。……はっ、私かっ！？

教訓２．Sandcastle Help File Builder が期待通りの動作をしなかった場合には、一度再起動してみましょう。今度はちゃんと動くかもよ？

その３．お前は何をしてるんだっ！？

え、意味不明なのは(以下略)。……はいはい、どーせそうですよー。

XAML では明示的にクラス定義はしないですよね。だから、".xaml.cs", ".xaml.vb" 側の partial class 側に<sammary>タグでコメントを書いています。

自分では、このやり方で問題ないように思っていたんですが、生成されたドキュメントでクラス名の一覧を見てみると、クラス名がコメントに表示されている……。おーい、自分で記述した方のコメントはどこに行ったんだー？

……と思って、クラスの方のAPIを見てみると、確かに自分が書いたコメントはありましたけど、その他にそのクラス名だけのコメントが１行追加されている……。何だコレ？

で、XAML定義をミスってIDEがエラー吐いたとき、その原因を追っかけてってわかったですよ。XAMLから生成されたC#(VB)のコードに勝手に<sammary>タグが追加されてるっ！

意味のない情報を自動生成すんなー……。

教訓３．XAMLで定義したクラスには、Visual Studioによりクラス名だけの<sammary>タグがつけられたりします。まぁ、そーゆーものなので、気にするのはやめましょう。

では、次回はまた大晦日にお会いしましょう？

帰ってきた Sandcastle

やまだ — Tue, 17 Jun 2008 01:57:00 GMT

えー……ま、いいか。

やまだです。

6/28(土) は大阪勉強会#20です。なんだかんだで話題に上がっているわりには、まだまだ空きはありそうです。

というわけで。

みんな来ない？僕は行くよー（ＴーＴ）

とか書いておきながら、私は別件のため懇親会は欠席の予定だったりしますが。

＃というか、そもそもその別件のためにこの日に大阪行きだったわけで。

で、今週末の東京勉強会#21の方まで行く体力と気力が残るだろうか……。

で、前回「Sandcastleはどこに行った？」的なエントリを書いてしまったわけなので、一応その後始末をしておこうと。

Sandcastle Help File Builder のページにいくと、Sandcastle へのリンクが張りなおされていました。

> Download the Sandcastle January 2008 release from the Microsoft Download Center

とありますね。ですが、これ、リンク先を確かめてみると実際には、May 2008 Release でした。ですので、Sandcastle の最新版が上記からダウンロードできるようです。

ということで、Microsoft の Download Center に舞い戻った、とのお話でした。

では、Sandcastle関連のリンク集を整理、ということで。

・Sandcastle May 2008 Release (v2.4.10520)

ヘルプファイル作成ツールのエンジン

・Sandcastle Help File Builder 1.7.0.0 Production

ヘルプファイル作成のGUIツール

・Sandcastle Style

以前、Presentation Style Patch と呼んでいたもの

以上でっす。

Sandcastle が消えている？

やまだ — Thu, 12 Jun 2008 02:18:00 GMT

やまだです。

こんな私ですが「書き込みを楽しみにしてるよ」という方がいらっしゃいました。ありがたいことです。

「いつも書き込みないかってチェックしてるんだけどさー」　エントリ書けてなくてますます申し訳ない……。

「画伯のエントリを」　……をい。

それ、果てしなく違いますから！何かが根本的に間違ってますから！

何が間違ってるかは内緒っ！……いや、そうじゃなくて。

ま、そーゆーどーでもよい人ことは置いときまして。

ちょっと前にこっちに書いたのですが、Sandcastle 関係のもろもろがリリースされました。

> ・Sandcastle May 2008 Release (v2.4.10520)

え、何、このリンク先……「プロジェクトはまだできてません(意訳)」って。確かにあったんですよ前は。

なんで公開直後にプロジェクト自体が消えているの？

Sandcastle がないと、Sandcastle Help File Builder だけあっても意味がないぞ。

逆なら、まだ DocProject for Sandcastle とかでなんとかなるのかもしれないけどさ。

＃でも DocProject 自体がどんなものかまだよくわかってない。わかったら教えれ < 他力本願

Sandcastle の行き先なのですが……、Builder の方のページでの関連リソースが↓みたいな感じになっちゃってます。

> Download the Sandcastle January 2008 release from (-- New site pending --).

とにかく、今はサイト自体が閉じちゃってる or 移転中みたいですね。

＃私はダウンロードしちゃってるので、ライセンスさえ問題なければ再配布してもよいけどさっ。

頼むから、ここまで来て公開停止になるって展開だけはかんべんしてくれよ～。

Sandcastle がどこに行っちゃったのか、お心当たりのある方はご一報を。（お礼は何もできないけどさっ）

では。

Sandcastle もろもろリリース

やまだ — Thu, 05 Jun 2008 03:23:00 GMT

えー、やまだです。

少し前、自分のブログを見に行ったら、ココロがお風呂に入っているところでした。ココロの秘密日記を開いたところ、「みちゃだめですよ！」といわれました。なんだかこの符合に感心してよいのか、とりあえず反省すべきなのか、そこが悩みどころです。

本格的に名前を変えようかと思いつつ、まだまだやまだです。

えー、片桐さんちのエントリでも書かれていますが、Sandcastle関連もろもろのリリースです。

・Sandcastle May 2008 Release (v2.4.10520)

.NET Framework のヘルプファイル作成エンジンですね。今回からバージョン番号も併記になったようです。

えーと変更内容は……各自でお確かめください(笑)。

【追記】「前回の」 Presentation Patch の内容が「ほとんど」取り込まれているようです。

~~でも、配布ファイルサイズがいきなり５割増しになっているのでかなり大規模改造だったのではないかと。~~

【追記】ごめんなさい。嘘です。サイズ５割増しは、Builderの方でした。

・Sandcastle Help File Builder 1.7.0.0 Production

ヘルプファイル作成のGUIツールですね。実質、これ込みで Sandcastle と呼んで良いような……。

いちいちコマンドラインから起動スクリプトの入力なんてしてられませんしねぇ。

変更内容は……片桐さんちでチェックだ！(笑)。

・Sandcastle Style

以前、Presentation Style Patch と呼んでいたもの。~~こちらは数日の後にリリース予定となってますが。~~

【追記】このエントリ書いたその日のうちに、公開されたみたいですね。

だから Patch なら最初からあてときゃよいようなものですが、何か妙なしがらみでもあるのかしら。

変更内容は……~~公開前に~~わかるわけなかろーに(笑)。

で、最新版対応の日本語化ファイルなんですが、(以下コメントに続く……)

VB使いにはC++の名前の由来が理解できない？

やまだ — Tue, 18 Mar 2008 04:37:00 GMT

東京勉強会#18 お疲れ様でした。

私は諸般の情事事情により、欠席させていただきました。しかし、ちっとも休んだ気がしないのはどうしてなんだろう(笑)。
むしろ出席するより大変だったような気が……。なぜだー。

さてさて、今回は小ネタを少々。

今までCとかC++とかJava とかになじんできたので、むしろ当たり前に思っていたことなのですが。

インクリメント／デクリメント演算子ってのがあります。軽くおさらいしておくと、インクリメント演算子とは

i = i + 1;

のことを

i++; もしくは ++i;

って書くことです。これも一種のシンタックスシュガーと呼べるものなのかもしれません。

変数の前に ++ を書くか、変数の後に ++ を書くかには微妙な差異があって、

j = ++i;

って書くと、

i = i + 1;

j = i;

の意味を持ちますが、

j = i++;

って書くと、

j = i;

i = i + 1;

の意味を持ちます。この場合、j が加算前の値をとるか加算後の値をとるかが違います。

知ってる人にとっては、非常に今更な話なんですが、この前、ちょっと VB.NET で似たような構文を書こうとしたんですよ。

あれ？ --i は書けるけど i-- が書けない。
--i って書いても、値が変わっているように見えない。

で、ようやく気がついた。VB.NET ってインクリメンタル／デクリメンタル演算子がないのですね？(→ここからタイトルにつながる)
つまり、--i って書けるように見えても、実は -(-i) の意味で二回符号を反転させるので、実は i　と変わりないってことかと。

＃嘘書いてたら指摘お願いします。

非常に紛らわしいな、と。

＃早く、○○○○っ○に言語対応表を作ってもらいたいな、と。

Sandcastle January 2008 がリリースされています。

やまだ — Thu, 24 Jan 2008 03:36:00 GMT

片桐さんのところでもアナウンスされていますが、Sandcastle Help File Builder 1.6.0.4 がリリースされています。

入手はこちらから。

で、その対象となる Sandcastle ですが、October 2007 Community Technology Preview (CTP) から一向に更新されている様子がないんですよね。どうしたもんかと思ってると、以下に最新版がありました。

Sandcastle January 2008
http://www.codeplex.com/Sandcastle

＃お、Sandcastle まで CodePlex にお引越しですね。

あと、正式リリースになりました。CTP がなくなってます！……と書きたいところなんですが、インストールすると Pre-Release Lisence とかって文字がしっかりとあるんですよねぇ。引っ越しにあたって、 CTP 表記を取りこぼした、とかだったりして？

中身を確認したところでは、旧バージョンに比べて大きな変更はなさそうですね。とりあえず、さくっと旧バージョンの時につくった日本語化ファイルを更新して動かしてみたところ特に問題はなさそうです。

コードから見るに、今回は VS2005 形式で出力した場合のフィードバック出力がちょっとまともになったっぽいですね。SHFB からフィードバック出力の有無がちゃんと指定どおりに制御できているようだし。前回は無条件に生成されていた気が……。

ただ、フィードバック時のメール表題が化けまくりになるんだが……ううむ。

Sandcastle Help File Builder 1.6.0.4 がリリースされます。

やまだ — Fri, 18 Jan 2008 01:40:00 GMT

とは言っても、まだ出てはいなかったりします。ですので「されました」ではありません。

えーと、ご存じない方のために再度書いておくと、Sandcastle ってのは .NET で API リファレンスを作成できるツールです。.NET 版 Javadoc っていうと一番簡単かなぁ？Sandacastle Help File Builder　はそれを GUI　から操作するためのツールってことになります。＃使い回し使い回し(^^;

で、Sandcastle Help File Builder のページ　によると、1/22 までに　1.6.0.4 をリリースするよって予告でした。

まあ予告だけなら今までもあったのですが、そこに "support for the Sandcastle January 2008 CTP" との記述がありました。ということは、それまでに Sandcastle も新版がリリースされるということですね。

ここ２ヶ月ばかりリリースが止まっていたので、まだ改善されていることだけでも単純にうれしいですね。ただ、何をどこまで改善されているか、が問題なんですが。正直、Javadoc の域からはまだ遠いし……。

＃ま、Javadocとは目指すところが違うといわれればそれまでですが。

あー、ほそぼそと Sandcastle の日本語化とかも進めてたりしますが、欲しい人とかいます？

Visual Basic / C# / C++

ちょっとメモ

クロスオーバーさせてみよう

ドキュメントは読みましょう？（しつこく Sandcastle ）

WPFでSandcastleを使ってみた

帰ってきた Sandcastle

Sandcastle が消えている？

Sandcastle もろもろリリース

VB使いにはC++の名前の由来が理解できない？

Sandcastle January 2008 がリリースされています。

Sandcastle Help File Builder 1.6.0.4 がリリースされます。

Visual Basic / C#　/ C++