DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des files, piles, listes et tableaux / Fonctions Tableau
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
ChaîneVersTableau (Fonction)
En anglais : StringToArray
Remplit un tableau à 1 ou 2 dimensions du type spécifié avec la chaîne de caractères passée en paramètre. Le tableau est vidé avant d'être rempli.
Exemple
// Tableau à une dimension
sMesValeurs est une chaîne = "A" + RC + "B" + RC + "C" + RC + "D" + RC + "D"
// Tableau initial
MonTableau est un tableau de 3 chaînes
ChaîneVersTableau(sMesValeurs, MonTableau)
// Le tableau contient : "A" , "B" , "C" , "D" , "D"
// Tableau à une dimension
sChaîne est une chaîne = "A" + RC + "B" + ";" + "C" + RC + "D" + "," + E + RC + "F"
// Tableau initial
MonTableau est un tableau de 6 chaînes
ChaîneVersTableau(sChaîne, MonTableau, [RC, ";", ","])
// Le tableau contient : "A" , "B" , "C" , "D" , "E" , "F"
// Tableau à deux dimensions
sMesValeurs est une chaîne = "A" + TAB + "B" + RC + "C" +TAB + "D" + RC + "E" + TAB + "F"
// Tableau initial
MonTableau est un tableau de 2 par 3 chaînes
ChaîneVersTableau(sMesValeurs, MonTableau)
// Le tableau contient : "A;B" , "C;D" , "E;F"
// Tableau à deux dimensions
sChaîne est une chaîne = "A" + TAB + "B" + RC + "C" + "/" + "D" + "*" + E + "\" + "F"
// Tableau initial    
MonTableau est un tableau de 2 par 3 chaînes
ChaîneVersTableau(sChaîne, MonTableau, [RC, "*"], [TAB, "/", "\"])
// Le tableau contient : "A;B" , "C;D" , "E;F"
Syntaxe

Tableau à une dimension Masquer les détails

ChaîneVersTableau(<Chaîne> , <Nom du tableau> [, <Séparateur d'élément>])
<Chaîne> : Chaîne de caractères
Contient les différents éléments du tableau. La chaîne sera découpée selon le séparateur d'éléments spécifié.
Si ce paramètre correspond à une chaîne vide (""), la dimension du tableau est ramenée à une dimension et une seule ligne.
<Nom du tableau> : Variable de type Tableau
Nom du tableau à 1 dimension dans lequel les éléments contenus dans la chaîne doivent être ajoutés. Ce tableau doit être alloué dans un type simple ou un type structure.
<Séparateur d'élément> : Chaîne de caractères optionnelle ou Tableau optionnel
Séparateur utilisé dans la <Chaîne> pour séparer les valeurs des différents éléments du tableau. Ce séparateur peut correspondre à :
  • une chaîne de caractères (par exemple : ";").
  • un tableau de chaînes (par exemple : [RC,";"]).
    WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Non disponible.
Par défaut, le séparateur d'élément utilisé est RC (Retour Chariot).

Tableau à 2 dimensions Masquer les détails

ChaîneVersTableau(<Chaîne> , <Nom du tableau> [, <Séparateur de ligne> [, <Séparateur de colonne>]])
<Chaîne> : Chaîne de caractères
Contient les différents éléments du tableau.
La chaîne sera découpée selon le séparateur de ligne spécifié, puis suivant le séparateur de colonnes. Les éléments seront ajoutés ligne par ligne.
  • Il y aura autant de lignes que de <Séparateur de ligne> trouvés.
  • Des colonnes seront ajoutées si le nombre maximal de <Séparateur de colonne> trouvé dépasse le nombre de colonnes du tableau.
  • A chaque colonne doit correspondre une valeur pour la ligne.
  • Le nombre de colonnes du tableau résultat est le nombre d'éléments de la première ligne.
  • Si une ligne contient plus d'éléments que la première ligne, les éléments en trop sont concaténés dans le dernier élément.
  • Si une ligne contient moins d'éléments que la première ligne, les cases du tableau non affectées conservent la valeur par défaut.
  • Si ce paramètre correspond à une chaîne vide (""), la dimension du tableau est ramenée à une dimension et une seule ligne.
<Nom du tableau> : Variable de type Tableau
Nom du tableau à 2 dimensions dans lequel les éléments contenus dans la chaîne doivent être ajoutés. Ce tableau doit être alloué dans un type simple ou un type structure.
<Séparateur de ligne> : Chaîne de caractères optionnelle ou Tableau optionnel
Séparateur utilisé dans la <Chaîne> pour séparer les valeurs des différentes lignes. Ce séparateur peut correspondre à :
  • une chaîne de caractères (par exemple : ";").
  • un tableau de chaînes (par exemple : [RC,"*"]).
    WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Non disponible.
Par défaut, le séparateur de lignes utilisé est RC (Retour Chariot).
<Séparateur de colonne> : Chaîne de caractères optionnelle ou Tableau optionnel
Séparateur utilisé dans la <Chaîne> pour séparer les valeurs des différentes colonnes. Ce séparateur peut correspondre à :
  • une chaîne de caractères (par exemple : "TAB").
  • un tableau de chaînes (par exemple : ["/", "\"]).
    WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Non disponible.
Par défaut, le séparateur de colonnes utilisé est TAB.
Remarques
  • La dimension du tableau sera modifiée si nécessaire : des lignes et des colonnes pourront être ajoutées selon les valeurs contenues dans la <Chaîne>.
  • Les tableaux de type structure gérés sont uniquement des tableaux à une dimension.
  • Les tableaux contenant des chaînes UNICODE ou des variants ne sont pas gérés.
  • Pour le type Durée, la valeur doit être fournie en millièmes de seconde. La valeur 0 n'est pas valide. Il faut utiliser "0000000000".
Classification Métier / UI : Code neutre
Composante : wd290vm.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Avec une chaine vide
La doc précise : Si ce paramètre correspond à une chaîne vide (""), la dimension du tableau est ramenée à une dimension et une seule ligne.

Ceci est totalement contre-intuitif et contre tout bon sens.
Par exemple le code suivant :

tabIds est tableau d'entiers
ChaineVersTableau("", tabIds, ",")

Produit un tableau avec un élément à 0 alors qu'il est juste logique d'attendre un tableau vide
Antoine
21 jan. 2022

Dernière modification : 25/05/2022

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