Your documentation
| From: | Bernhard Sept, BHS Schulungen | Date: | Sun, 24 Feb 2002 19:41:14 +0000 |
| Subject: | Your documentation | ||
| Groups: | php.mirrors | ||
| Request: | Send a blank email to php-mirrors+get-8836@lists.php.net to get a copy of this message | ||
Hi there,
First of all, you folks did a great job - specially on the
documentation.
There is just one little thing: You will find on most pages of your doc
something like:
Function blabla (parameter1, parameter2)
And then you will see basically no description of the function.
If you are interested, I could work on changing the doc for you!
Regards
B. Sept
Example:
Returns an array that corresponds to the fetched row, or FALSE if there
are no more rows.
mysql_fetch_array() is an extended version of mysql_fetch_row()
<function.mysql-fetch-row.php> . In addition to storing the data in the
numeric indices of the result array, it also stores the data in
associative indices, using the field names as keys.
If two or more columns of the result have the same field names
Suggestion (from the VisualBasic documentation)
Dim Statement
Declares variables <JavaScript:alink_4.Click()> and allocates storage
space.
Syntax
Dim [WithEvents] varname[([subscripts])] [As [New] type] [, [WithEvents]
varname[([subscripts])] [As [New] type]] . . .
The Dim statement syntax has these parts:
Part Description
WithEvents Optional. Keyword <JavaScript:alink_5.Click()> that
specifies that varname is an object variable
<JavaScript:alink_6.Click()> used to respond to events triggered by an
ActiveX object <JavaScript:alink_7.Click()> . WithEvents is valid only
in class modules <JavaScript:alink_8.Click()> . You can declare as many
individual variables as you like using WithEvents, but you can't create
arrays <JavaScript:alink_9.Click()> with WithEvents. You can't use New
with WithEvents.
varname Required. Name of the variable; follows standard variable naming
conventions.
subscripts Optional. Dimensions of an array variable; up to 60
multiple dimensions may be declared. The subscripts argument uses the
following syntax:
[lower To] upper [, [lower To] upper] . . .
When not explicitly stated in lower, the lower bound of an array is
controlled by the Option Base statement. The lower bound is zero if no
Option Base statement is present.
New Optional. Keyword that enables implicit creation of an object.
If you use New when declaring the object variable, a new instance of the
object is created on first reference to it, so you don't have to use the
Set statement to assign the object reference. The New keyword can't be
used to declare variables of any intrinsic data type
<JavaScript:alink_10.Click()> , can't be used to declare instances of
dependent objects, and can't be used with WithEvents.
type Optional. Data type of the variable; may be Byte
<JavaScript:alink_11.Click()> , Boolean <JavaScript:alink_12.Click()> ,
Integer <JavaScript:alink_13.Click()> , Long
<JavaScript:alink_14.Click()> , Currency <JavaScript:alink_15.Click()> ,
Single <JavaScript:alink_16.Click()> , Double
<JavaScript:alink_17.Click()> , Decimal <JavaScript:alink_18.Click()>
(not currently supported), Date <JavaScript:alink_19.Click()> , String
<JavaScript:alink_20.Click()> (for variable-length strings), String *
length (for fixed-length strings), Object <JavaScript:alink_21.Click()>
, Variant <JavaScript:alink_22.Click()> , a user-defined type
<JavaScript:alink_23.Click()> , or an object type
<JavaScript:alink_24.Click()> . Use a separate As type clause for each
variable you declare.
Remarks
Variables declared with Dim at the module level
<JavaScript:alink_25.Click()> are available to all procedures within
the module <JavaScript:alink_26.Click()> . At the procedure level
<JavaScript:alink_27.Click()> , variables are available only within the
procedure.
Use the Dim statement at module or procedure level to declare the data
type of a variable. For example, the following statement declares a
variable as an Integer.
Dim NumberOfEmployees As Integer
Also use a Dim statement to declare the object type of a variable. The
following declares a variable for a new instance of a worksheet.
Dim X As New Worksheet
If the New keyword is not used when declaring an object variable, the
variable that refers to the object must be assigned an existing object
using the Set statement before it can be used. Until it is assigned an
object, the declared object variable has the special value Nothing,
which indicates that it doesn't refer to any particular instance of an
object.
You can also use the Dim statement with empty parentheses to declare a
dynamic array. After declaring a dynamic array, use the ReDim statement
within a procedure to define the number of dimensions and elements in
the array. If you try to redeclare a dimension for an array variable
whose size was explicitly specified in a Private, Public, or Dim
statement, an error occurs.
If you don't specify a data type or object type, and there is no Deftype
statement in the module, the variable is Variant by default.
When variables are initialized, a numeric variable is initialized to 0,
a variable-length string is initialized to a zero-length string (""),
and a fixed-length string is filled with zeros. Variant variables are
initialized to Empty <JavaScript:alink_28.Click()> . Each element of a
user-defined type variable is initialized as if it were a separate
variable.
Note When you use the Dim statement in a procedure, you generally put
the Dim statement at the beginning of the procedure.
BHS Schulungen
Bernhard Sept
Messerschmidstrasse 2
D 72160 Horb
mail@b-sept.de
tel +49 7486 9332
fax +49 7486 9331
mobil +49 172 258 3304