4D v14.3Types de données |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
Types de données
|
Types de données | Champ | Variable | Expression |
Chaîne (cf. note 1) | Oui | Oui | Oui |
Numérique (cf. note 2) | Oui | Oui | Oui |
Date | Oui | Oui | Oui |
Heure | Oui | Oui | Oui |
Booléen | Oui | Oui | Oui |
Image | Oui | Oui | Oui |
Pointeur | Non | Oui | Oui |
BLOB (cf. note 3) | Oui | Oui | Non |
Tableau (cf. note 4) | Non | Oui | Non |
Entier 64 bits (cf. note 5) | Oui | Non | Non |
Float (cf. note 5) | Oui | Non | Non |
Objet (cf. note 6) | Non | Oui | Oui |
Indéfini | Non | Oui | Oui |
Notes
(1) Une chaîne peut être un champ alphanumérique, une variable de longueur fixe, ou encore une variable ou un champ de type Texte.
(2) Un numérique peut être une variable ou un champ de type Réel (Numérique), Entier et Entier long.
(3) BLOB est l'abréviation de Binary Large OBject. Pour plus d'informations sur les BLOBs, reportez-vous à la section Commandes du thème BLOB.
(4) Les tableaux peuvent être de tout type. Pour plus d'informations, reportez-vous à la section Présentation des tableaux.
(5) Les types Entier 64 bits et Float sont gérés uniquement via le SQL. Il est déconseillé de les manipuler via le langage 4D, car dans ce cas ils sont convertis en Réels, ce qui peut entraîner des pertes de précision.
(6) Les objets permettent de manipuler des données structurées via le langage. Ils sont gérés via les commandes du thème "Objets (Langage).
Chaîne est un terme générique utilisé pour :
Il n'y a aucune différence entre une variable alphanumérique et une variable texte.
Vous pouvez assigner un alpha à un texte et vice-versa, 4D effectue automatiquement la conversion, en tronquant les valeurs si nécessaire. Vous pouvez mélanger du texte et de l'alphanumérique dans les expressions.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Alpha et Texte dans les descriptions des commandes sont indifféremment appelés Chaîne, sauf spécification explicite.
Numérique est un terme générique utilisé pour :
Les nombres de type Réel sont compris dans l'intervalle ±1.7e±308 (15 chiffres).
Les nombres de type Entier (2 octets) sont compris dans l'intervalle -32 768..32 767
Les nombres de type Entier long (4 octets) sont compris dans l'intervalle -2^31..(2^31)-1
Vous pouvez assigner tout nombre d'un type numérique à un nombre d'un autre type numérique, 4D effectue automatiquement la conversion, en tronquant ou en arrondissant les valeurs si nécessaire. Notez cependant que lorsqu'une valeur est située en-dehors de l'intervalle du type de destination, 4D ne pourra la convertir. Vous pouvez mélanger tous les types de numériques au sein d'une même expression.
Note : Dans ce manuel de référence du langage 4D, quel que soit le type précis des données, les paramètres de type Réel, Entier et Entier long dans les descriptions des commandes sont appelés Numériques, sauf spécification explicite.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Date dans les descriptions des commandes sont appelés Date, sauf spécification explicite.
Les dates en JavaScript étant des objets, elles sont envoyées à 4D sous forme de textes contenant leur forme JSON comme tout autre objet. Ce principe est mis en oeuvre notamment lors de l’utilisation des fonctionnalités 4D Mobile et Zone Web.
La forme JSON de l’objet Date JavaScript suit la norme ISO 8601, par exemple "2013-08-23T00:00:00Z".
Il est de votre ressort de convertir ce texte en date 4D (C_DATE). Deux solutions sont proposées :
C_TEXTE($1) // réception d'une date au format ISO
C_DATE($d)
$d:=JSON Parse("\""+$1+"\"";Est une date)
A noter une différence entre ces deux solutions : JSON Parse respecte le mode de conversion éventuellement défini avec la commande FIXER PARAMETRE BASE tandis que Date n’y est pas assujetti : la conversion avec Date s’effectue toujours en tenant compte du fuseau horaire courant.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Heure dans les descriptions des commandes sont appelés Heure, sauf spécification explicite.
Les variables, champs ou expressions de type Booléen peuvent être soit à VRAI soit à FAUX.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Booléen dans les descriptions des commandes sont appelés Booléen, sauf spécification explicite.
Les variables, champs ou expressions de type Image peuvent contenir des images Windows ou Macintosh. En général, ce type accepte toute image pouvant être collée dans le Presse-papiers ou bien lue depuis le disque à l'aide des commandes de 4D ou d'un plug-in.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Image dans les descriptions des commandes sont appelés Image, sauf spécification explicite.
Les variables ou expressions de type Pointeur sont des références à d'autres variables (y compris des tableaux et des éléments de tableaux), à des tables ou à des champs. Il n'existe pas de champs de type Pointeur.
Pour plus d'informations sur les pointeurs, reportez-vous à la section Pointeurs.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Pointeur dans les descriptions des commandes sont appelés Pointeur, sauf spécification explicite.
Les champs ou variables de type BLOB sont des séries d'octets (d'une longueur de 0 à 2 Go) que vous pouvez adresser individuellement ou à l'aide des Commandes du thème BLOB. Il n'existe pas d'expressions de type BLOB.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type BLOB dans les descriptions des commandes sont appelés BLOB.
La structure des objets "natifs" 4D est basée sur le principe classique des paires "propriété/valeur". La syntaxe de ces objets s’inspire de la notation JSON, mais ne la suit pas entièrement.
Les objets sont gérés par les commandes du thème Objets (Langage).
Indéfini n'est pas véritablement un type de données. Une variable dite "indéfinie" est une variable n'ayant pas encore été définie. Une fonction utilisateur (c'est-à-dire une méthode projet qui retourne une valeur) peut retourner une valeur indéfinie si, à l'intérieur de la méthode, le résultat de la fonction ($0) est assigné à une expression indéfinie (une expression issue d'un calcul effectué avec au moins une variable indéfinie). Un champ ne peut pas être indéfini.
Les tableaux ne sont pas véritablement un type de données. Sous cette appellation sont regroupés les différents types de tableaux (comme les tableaux entier, tableaux texte, etc.). Les tableaux sont des variables. Il n'existe pas de champs ni d'expressions de type Tableau. Pour plus d'informations sur les tableaux, reportez-vous à la section Présentation des tableaux.
Note : Dans ce manuel de référence du langage 4D, les paramètres de type Tableau dans les descriptions des commandes sont appelés Tableau, sauf spécification explicite (par exemple Tableau Alpha, Tableau Réel...).
Le langage de 4D comporte des fonctions et des opérateurs vous permettant de convertir des types de données en d’autres types, dans la mesure où de telles conversions ont un sens. 4D assure la vérification des types de données. Ainsi, vous ne pouvez pas écrire : "abc"+0.5+!25/12/96!-?00:30:45?, car cette opération génère une erreur de syntaxe.
Le tableau ci-dessous liste les types de données pouvant être convertis, le type dans lequel ils peuvent être convertis, ainsi que les fonctions 4D à utiliser.
Types à convertir | en Chaîne | en Numérique | en Date | en Heure |
Chaîne | Num | Date | Heure | |
Numérique (*) | Chaine | |||
Date | Chaine | |||
Heure | Chaine | |||
Booléen | Num |
(*) Les valeurs de type Heure peuvent être utilisées en tant que numériques.
Note : Ce tableau ne traite pas les conversions de données plus complexes obtenues à l'aide d'une combinaison d'opérateurs et d'autres commandes.
Produit : 4D
Thème : Présentation du langage
Nom intl. : Data Types
Chaînes de caractères
Conditions et boucles
Constantes
Méthodes
Nommer les objets du langage 4D
Opérateurs
Pointeurs
Présentation des tableaux
Symboles d'indice de chaîne
Type
Variables
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14.3)
Hérité de :
Types de données ( 4D v12.4)
Parent de :
Types de données ( 4D v14 R3)