Tutorial - Tableur Calc d'OpenOffice.org par l'exemple

Accueil Fonctions Calc Menu Basic EDI OOo 1.x EDI OOo 2.x EDI LibO - OOo 3.x Affectation touche Affectation icône Etape par étape Macro débutant Fonctions Basic Dialogues OOo1-2 Dialogues LibO-OOo3 Quelques exemples Exemples dialogue Fonctions perso Définitions Recherche sur site

FONCTIONS BASIC. Variables

Accès direct : Menu fonctions Basic, Textes, Dates et heures, Logiques, mathématiques, Ecran, Fichiers, Variables, Erreurs, Divers,

Fonctions	T^*	Retour	Exemple	Résultat	Commentaires
Array (Argument list)	F		MaVariable = Array ("A", "B", "C", "D") Msgbox MaVariable(2)	C	Retourne le champ de données. § DimArray, IsArray
CBool (Expression1 {= \| <> \| < \| > \| <= \| >=} Expression2)	F	Boolean	A=1 :B=1 MaVariable = CBool (A=B)	True	Convertit une comparaison de chaînes de caractères ou une comparaison numérique en expression logique, ou une expression numérique en expression logique.
CBool (Expression1 {= \| <> \| < \| > \| <= \| >=} Expression2)	F	Boolean	MaVariable = CBool (1=2)	False
CCur (Expression)	F	Monnaie			Convertit une expression chaîne de caractères ou numérique en expression monétaire. Les paramètres locaux, séparateurs décimales, symbole monnaie sont utilisés.
CDate (Expression)	F	Date	MaVariable= cDate (38542.4753)	09/07/2005 11:24:26	Convertit une expression chaîne de caractères ou numérique en valeur de date. § CDateFromIso
CDate (Expression)	F	Date	MaVariable= Cdate ("09/07/2005 11:24:26")	09/07/2005 11:24:26
CDbl (Expression)	F	Double	MaVariable= CDbl(654.321)	654,321	Convertit une expression chaîne de caractères ou numérique en valeur de type Double.
CDec (Expression)	F		MaVariable = CDec("1234,56")	1234,56 suivant format décimal	Convertit une expression chaîne de caractères ou numérique en valeur décimale
			MaVariable = CDec("1234.56")	1234,56 suivant format décimal
			MaVariable = CDec("09/07/2005")	0
			MaVariable = CDec("bonjour")	0
CInt (Expression)	F	Entier	MaVariable= CInt("1234.56")	1235	Convertit une expression chaîne de caractères ou numérique en nombre entier.
CInt (Expression)	F	Entier	MaVariable= CInt(1234.56)	1235
CLng (Expression)	F	Long	MaVariable= CInt("1234.56")	1235	Convertit une expression chaîne de caractères ou numérique en nombre entier long.
CLng (Expression)	F	Long	MaVariable= CInt(1234.56)	1235
Const Text = Expression	I		MaVariable = 10		Définit une chaîne de caractères comme constante.
CSng (Expression)	F	Single	MaVariable = CSng(654.321)	654,321	Convertit une expression chaîne de caractères ou numérique en valeur de type Single
CStr (Expression)	F	Chaîne	MaVariable = Cstr("123.5")	123,5	Convertit une expression numérique ou chaîne en expression chaîne de caractères.
CStr (Expression)	F	Chaîne	MaVariable = Cstr(123.5)	123,5
CVar (Expression)	F	Variant			Convertit une expression numérique ou chaîne en expression de type variant
CVErr (Expression)	F	Variant			Convertit une expression numérique ou chaîne en expression de type variant et de sous-type "Erreur"
DefBool Characterrange1[, Characterrange2[,...]]	I	Boolean	DefBool b	Toutes variables commençant par b = boolean	Définit le type de variable correspondant à une plage de lettres si aucun caractère de déclaration de type ou mot-clé n'a été spécifié
DefDate Characterrange1[, Characterrange2[,...]]	I	Date	DefDate d, h	Toutes variables commençant par d, h = date
DefDbl Characterrange1[, Characterrange2[,...]]	I	Double
DefInt Characterrange1[, Characterrange2[,...]]	I	Entier
DefLng Characterrange1[, Characterrange2[,...]]	I	Long
DefObj Characterrange1[, Characterrange2[,...]]	I	Objet
DefSng Characterrange1[, Characterrange2[,...]]	I	Simple
DefStr Characterrange1[, Characterrange2[,...]]	I	Chaîne
DefVar Characterrange1[, Characterrange2[,...]]	I	Variant
DimArray (Argument list)	F				Retourne une matrice au format variante. § Array
EqualUnoObjects (oObj1, oObj2)	F	Boolean
[ReDim] Dim VarName [(start To end)] [As VarType] [, VarName2 [(start To end)] [As VarType][,...]]			Dim MaVariable As Variant		VarName : tout nom de variable ou de matrice. Start, End : nombre d'éléments (NumberElements=(end-start)+1) et plage d'index. Si ReDim est appliquée au niveau de la procédure, les paramètres Start et End peuvent être des expressions numériques. VarType : type de données d'une variable.
			Dim X As Long, Y As Single
			Dim MaFiche As Object
			Dim MaVariable (5 to 10, 15 To 20) As String
FindObject (ObjName As String)
FindPropertyObject (ObjVar, PropName As String)
Global VarName[(start To end)] [As VarType][, VarName2[(start To end)] [As VarType][,...]]	I		Global MaVariable As Integer		Dimensionne une variable ou une matrice au niveau du module (hors sous-routine ou fonction), valides dans toutes les bibliothèques et tous les modules de la session active. § Public, Static
HasUnoInterfaces (oTest, Nom-Interface-Uno 1 [, Nom-Interface-Uno 2, ...])
IsArray (Var)	F	Boolean	Dim A as string Dim B(10) As String print IsArray(A()) print IsArray(B())	False (pour A) True (pour B)	Teste si une variable est un champ de données dans une matrice.
IsDate (Expression)	F	Boolean	MaVariable = IsDate ("09/07/2005")	True	Teste si une expression chaîne ou numérique peut être convertie en variable de date
IsDate (Expression)	F	Boolean	MaVariable = IsDate ("09072005")	False
IsEmpty (Var)	F	Boolean			Teste si une variable contient la valeur Empty, qui indique une variable non initialisée.
IsMissing (ArgumentName)	F	Boolean			Teste si une fonction est appelée via un paramètre facultatif. § Optional
IsNull (Var)	F	Boolean			Teste si une variante contient la valeur spéciale Null, indiquant une variable sans données.
IsNumeric (Var)	F	Boolean	MaVariable = IsNumeric ("123")	True	Teste si une expression est un nombre.
IsNumeric (Var)	F	Boolean	MaVariable = IsNumeric ("ABC")	False	Teste si une expression est un nombre.
IsObject (VarObjet)	F	Boolean			Teste si une variable d'objet est un objet OLE.
IsUnoStruct (nom de type Uno)	F	Boolean
LBound (NomMatrice [, Dimension])	F	Entier	Dim Z (2 to 5) As Long print LBound(Z())	2	Retourne la limite inférieure d'une matrice. § UBound
LBound (NomMatrice [, Dimension])	F	Entier	Dim Z (2 to 5, 7 to 9) As Long print LBound(Z()) print LBound(Z(),2)	2 7	Retourne la limite inférieure d'une matrice. § UBound
[Let] VarName=Expression	I		Let MaVariable = 10		Assigne une valeur à une variable. Instruction non indispensable. § Set
Option Base { 0 \| 1}	I		Option Base 1		Définit 0 ou 1 comme limite inférieure par défaut des matrices.
Option Explicit	I		Option Explicit		Indique que chaque variable du code doit être explicitement déclarée avec l'instruction Dim. L'instruction est placée avant le code de programme exécutable dans un module.
Optional			Optional MaVariable		Permet de définir des paramètres facultatifs. § IsMissing
Public VarName[(start To end)] [As VarType][, VarName2[(start To end)] [As VarType][,...]]	I		Public MaVariable As Long		Dimensionne une variable ou une matrice au niveau du module (hors sous-routine ou fonction), valides dans toutes les bibliothèques et tous les modules. § Global, Static
Set VarObjet = Objet	I				Affecte une référence d'objet à une variable ou une propriété. ObjectVar : variable ou propriété pour laquelle une référence d'objet doit être définie. Object : objet auquel doit renvoyer la variable ou la propriété.
Static VarName[(start To end)] [As VarType], VarName2[(start To end)] [As VarType], ...	I		Static MaVariable As Long		Déclare une variable ou une matrice dans une sous-routine ou une fonction. les valeurs sont conservées après la fermeture de la sous-routine ou fonction. Les conventions relatives à Dim sont également applicables. § Global, Public
Type					Permet de déclarer ses propres types.
TypeName (Variable)	F	Chaîne	Retour = TypeName (MaVariable)		Retourne les informations relatives à une variable donnée. § VarType
UBound (NomMatrice [, Dimension])	F	Entier	Dim Z (2 to 5) As Long print UBound(Z())	5	Retourne la limite supérieure d'une matrice. § LBound
UBound (NomMatrice [, Dimension])	F	Entier	Dim Z (2 to 5, 7 to 9) As Long print UBound(Z()) print UBound(Z(),2)	5 9	Retourne la limite supérieure d'une matrice. § LBound
VarType (Variable)	F	Entier	Retour = TypeName (MaVariable)		Retourne les informations relatives à une variable donnée. § TypeName

^* F : Fonction, I : Instruction, O : Opérateur
^** Les fonctions équivalentes Calc peuvent n'être qu'approchantes.
[Entre crochets, options]

Les différents types de variables

Il est recommandé de forcer la déclaration de variables avec l'instruction Option Explicit. Elle doit être la première ligne du module, avant le premier Sub.

Type	Type de variable	Infos	Exemples	VarType	Caractère	Defxxx
Bool	Booléen	VRAI ou FAUX (0)	Dim MaVariable As Boolean	11		DefBool
Boolean
Currency	Monétaire avec 4 chiffres après la virgule	-922 337 203 685 477,5808 à +922 337 203 685 477,5807	Dim MaVariable@	6	@
			Dim MaVariable As Currency
Date	Dates ou heures		Dim Variable As Date	7		DefDate
Double	Virgule flottante en double précision	1,79769313486232 x 10E308 à 4,94065645841247 x 10E-324	Dim MaVariable#	5	#	DefDbl
			Dim MaVariable As Double
Integer	Entier	-32768 à +32767	Dim MaVariable%	2	%	DefInt
			Dim MaVariable As Integer
Long	Entier de grande valeur	-2 147 483 648 à +2 147 483 647	Dim MaVariable&	3	&	DefLng
			Dim MaVariable As Long
Object	Objet			9		DefObj
Single	Virgule flottante en simple précision	3,402823 x 10E38 à 1,401298 x 10E-45	Dim MaVariable!	4	!
			Dim MaVariable As Single
String	Chaîne de caractères	65 535 caractères maxi	Dim MaVariable$	8	$
			Dim MaVariable As String
Variant	Peut contenir tous les types spécifiés par la définition		Dim MaVariable As Variant	12		DefVar
Empty	Variable non initialisée			0
Null	Donnée invalide			1

Les différents formats de variables

code	Description
0	Si un nombre à un chiffre à la position du 0, ce chiffre est affiché. Cela implique que les zéros non significatifs sont affichés. Les décimales supplémentaires sont arrondies.
#	Comme 0 mais les zéros non significatifs ne sont pas affichés.
.	L'emplacement du point détermine le nombre de chiffres à placer avant et après le séparateur décimal.
%	Multiplie le nombre par 100 et affiche le signe % à l'endroit indiqué dans la chaîne de formatage.
EE+ ee+	Si le format contient au moins un caractère de formatage (0 ou #) à droite du symbole, le nombre est affiché en notation scientifique. La lettre E (ou e) est insérée entre le nombre et son exposant. Le nombre de caractères de formatage à droite du symbole détermine le nombre de chiffres de l'exposant. Si l'exposant est négatif, le signe moins est affiché juste avant la valeur de l'exposant. Si l'exposant est positif, le signe n'est affiché que si explicitement écrit dans le format (E+ ou e+).
,	La virgule est le caractère représentant le séparateur de milliers. Il sépare les milliers des centaines et des unités. Ce séparateur n'est affiché que s'il est encadré par des caractères de formatage de chiffres (0 or #).
- + $ ( ) espace	Plus (+), moins (-), dollar ($), espaces, ou parenthèses rentrés dans la chaîne de formatage ne sont pas interprétés, et sont donc affichés tels quels.
General Number	Les nombres sont affichés tels quels.
Currency	Le nombre est affiché au format monétaire suivant la configuration de l'ordinateur.
Fixed	Au moins un chiffre est affiché devant le séparateur décimal.
Standard	Le nombre est affiché au format décimal suivant la configuration de l'ordinateur.
Scientific	Le nombre est affiché au format scientifique.