IMu API for .Net
This section describes use of the IMu API for .Net; it is applicable for both C# and Visual Basic programmers.
Data types
C# and Visual Basic .Net programmers are familiar with two kinds of data
types. Each language has its own conventional types and standardized
.Net types. For example, an integer variable is declared idiomatically in C#
as int
while in Visual Basic it is declared as Integer
. The standard
.Net type for both of these is Int32
.
This documentation uses conventional types wherever possible. Using
conventional types in documentation makes it easier for the reader to follow
the code examples. However, this creates a minor problem in the text where the
type of a variable or property or the return value of a method is referred to.
For example, the AddFetchSet
method of IMu's Module class returns an
int
in C# and an Integer
in VB (both of which are equivalent to the
standard .Net type Int32
). Explicitly describing the method's return
value for both C# and VB this way is cumbersome and confusing. To avoid this,
where a data type is referred to in the general text, a generic term for the
type is usually used instead. For example, the AddFetchSet
method is
described as returning an integer. Similarly a method such as FindKey
which
returns a long
in C# and a Long
in VB (both of which are equivalent to
the standard .Net type Int64
) is described as returning a long integer.