DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des numériques / Fonctions Matrice
  • Existence de la matrice
  • Gestion des erreurs
  • Taille de
  • Extraction d'une valeur d'un élément de
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Lit la valeur de tous les éléments d'une colonne d'une matrice.
// Lecture des éléments de la colonne 5
ResLectureColonne = MatLitColonne("MaMatrice", 5)
Syntaxe
<Résultat> = MatLitColonne(<Matrice> , <Colonne à lire> [, <Taille totale d'un élément> [, <Nombre de décimales> [, <Format d'un élément>]]])
<Résultat> : Chaîne de caractères
Valeur de tous les éléments de la colonne spécifiée, sous la forme :
<Valeur Elément 1> + TAB + <Valeur Elément 2> + TAB + ...
+ TAB + <Valeur Elément N>
<Matrice> : Chaîne de caractères
Nom de la matrice à lire, défini avec la fonction MatCrée.
<Colonne à lire> : Entier
Numéro de la colonne à lire.
<Taille totale d'un élément> : Entier optionnel
Taille totale d'un élément à lire. Cette taille comprend le signe, le séparateur des milliers, le point décimal, l'exposant, les parties entières et décimales de la valeur de l'élément.
  • Si l'élément a plus de <Taille totale d'un élément> chiffres, la <Taille totale d'un élément> est augmentée.
  • Si l'élément a moins de <Taille totale élément> chiffres, la chaîne de caractères <Résultat> est complétée par des espaces.
  • Si la <Taille totale d'un élément> n'est pas précisée, la valeur de l'élément lu aura la taille de sa partie significative.
  • La <Taille totale d'un élément> ne doit pas dépasser 100.
  • Si la <Taille totale d'un élément> vaut 0, la valeur de l'élément aura la taille de sa partie significative.
<Nombre de décimales> : Entier optionnel
Nombre de décimales à lire. Ce paramètre commence toujours par un point ("."). La dernière décimale sera arrondie. Ce paramètre n'a d'effet que pour les notations flottantes ("f") et exponentielles ("e" et "E"). Si le <Nombre de décimales> est plus grand que la <Taille totale d'un élément>, le paramètre <Taille totale d'un élément> n'est pas pris en compte.
<Nombre de décimales>Type "d" (entier)Type "e" ou "E" (notation exponentielle) et type "f" (notation flottante)
.0-0
.N-N (si N est supérieur aux nombres de décimales, la partie décimale sera complétée par des zéros)
(pas précisé)-6
<Format d'un élément> : Caractère optionnel
Format de présentation d'un élément :
  • d : la valeur de l'élément est sous la forme d'un entier signé. Les chiffres après la virgule sont tronqués et le paramètre <Nombre de décimales> n'est pas pris en compte.
  • e ou E : la valeur de l'élément est sous la forme d'une notation exponentielle avec 1 chiffre avant le point décimal, <Nombre de décimales> chiffres après le point décimal et au moins 2 chiffres dans l'exposant.
Remarques

Existence de la matrice

L'existence de la matrice n'est pas vérifiée. Pour vérifier l'existence d'une matrice, utilisez la fonction MatExiste.

Gestion des erreurs

Attention : La fonction MatLitColonne ne retourne pas de code d'erreur. Pour savoir si des erreurs ont été générées par la lecture des éléments d'une colonne, utilisez la fonction MatErreur. Le libellé de l'erreur peut être connu grâce à la fonction ErreurInfo avec la constante errMessage.

Taille de <Résultat>

Attention : La taille de la chaîne de caractères obtenue dans <Résultat> est limitée à 260 caractères. Si la colonne de la matrice contient plus de caractères, la chaîne contenue dans <Résultat> ne contiendra que les 260 premiers caractères.

Extraction d'une valeur d'un élément de <Résultat>

Pour extraire une ou plusieurs valeurs d'éléments de la chaîne de caractères <Résultat>, utilisez la fonction ExtraitChaîne.
Classification Métier / UI : Code neutre
Composante : wd300mat.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale