タグ

ブックマーク / smdn.jp (3)

  • XMLドキュメントコメントを用いたドキュメントの作成 - smdn.jp

    クラスライブラリなどを提供する場合、同時に使い方や詳細な仕様をまとめたドキュメント(APIリファレンス)も提供する場合があります。 これらを個別に作成・メンテナンスすることも出来ますが、バージョンアップを重ねる度に実装とドキュメントの内容の同期を取るのは手間のかかる作業です。 これを解決する一つの方法として、ソースコード中にコメントとして直接APIのリファレンスを記述することで、実装とドキュメントの同期をしやすくするというやり方があります。 この場合、コメントからドキュメントを作成する方法が問題となってきます。 Doxygenなどこの様な機能を提供する専用のツールは存在しますが、C#およびVBコンパイラではこの様な要求を満たすXMLドキュメントコメントという機能がコンパイラの機能として用意されています。 XMLドキュメントコメントは、Javadocと同様の機能を提供するものです。 ここでは

    XMLドキュメントコメントを用いたドキュメントの作成 - smdn.jp
  • 比較演算子のオーバーロードとIComparable<T>インターフェイス - smdn.jp

    IComparable<T>インターフェースやIComparer<T>インターフェイスで実装されるCompareToメソッド・Compareメソッドは、<, >, <=, >= といった比較演算子の役割と似たものですが、両者は全く独立したものであり、このインターフェイスを実装したからといって比較演算子を用いた比較が出来るようになるわけではありません。 比較演算子を用いて比較するには、別途演算子をオーバーロードしなければなりません。 また逆に、比較演算子をオーバーロードしたからといってソートが出来るようになるというわけでもありません。 ソートするには型がIComparable<T>やIComparableなどのインターフェイスを実装している必要があります。 しかし、独自のクラスを構築する際、IComparable<T>等による比較(さらにソート)と比較演算子による比較の両方が出来るようにした

    比較演算子のオーバーロードとIComparable<T>インターフェイス - smdn.jp
  • オブジェクトの複製 (ICloneable, Clone, MemberwiseClone) - smdn.jp

    ひとくちに複製と言っても、単純にコピー元の値をコピー先に代入することで行う複製や、なんらかのメソッドを呼び出すことで行う複製などさまざまな方法があります。 また複製を行う機能を実装する場合も、構造体やクラスなど複数のフィールドからなる型ではすべてのフィールドを複製する必要があります。 これらの他の型を内包する複合型の場合では、内包するオブジェクトも含めて複製するか、参照のみをコピーするかといったことが考えられます。 さらに、.NET Frameworkでは型には値型と参照型の二種類が存在するため、複製の際にはそれらの違いも考慮する必要があります。 ここではオブジェクトの複製を作成する方法と、複製を作成する機能を提供するICloneableインターフェイスについて解説します。

    オブジェクトの複製 (ICloneable, Clone, MemberwiseClone) - smdn.jp
    rby
    rby 2016/11/22
  • 1