4D v16.3

ST Lire texte brut

Accueil

 
4D v16.3
ST Lire texte brut

ST Lire texte brut 


 

ST Lire texte brut ( {* ;} objet {; modeRéf} ) -> Résultat 
Paramètre Type   Description
Opérateur in Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable ou un champ
objet  Objet de formulaire in Nom d'objet (si * est spécifié) ou Variable ou champ (si * est omis)
modeRéf  Entier long in Mode de prise en charge des références présentes dans le texte
Résultat  Texte in Texte sans balises

La commande ST Lire texte brut supprime toute balise de style du champ ou de la variable texte désigné(e) par les paramètres * et objet, et retourne le texte brut. 

 

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). A l'exécution, si l'objet a le focus, la commande retourne les informations de l'objet en cours d'édition ; si l'objet n'a pas le focus, la commande retourne les informations de la source de données de l'objet (variable ou champ).
Si vous omettez le paramètre *, vous indiquez que le paramètre objet est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de variable. A l'exécution, la commande retourne les informations de la variable ou du champ.

 

Le paramètre optionnel modeRéf permet d’indiquer la manière dont les références présentes dans objet doivent être retournées. Passez dans modeRéf une des constantes suivantes, placées dans le thème "Texte multistyle" (vous pouvez passer une constante ou une combinaison de constantes) :

Constante Type Valeur Comment
ST Balises comme code xml Entier long 128 Le code XML de la balise est retourné en texte brut. Par exemple pour la balise '<img src="test.jpg" alt="image">mon image</img>', le texte brut est '<img src="test.jpg" alt="image">mon image</img>'
ST Balises comme texte brut Entier long 64 Le libellé de la balise est retourné en texte brut. Par exemple pour la balise '<img src="test.jpg" alt="image">mon image</img>', le texte brut est "mon image" (fonctionnement par défaut dans les formulaires)
ST Expressions 4D comme sources Entier long 2 La chaîne d’origine des références d’expressions 4D est retournée
ST Expressions 4D comme valeurs Entier long 1 Les références d’expressions 4D sont retournées sous leur forme évaluée (fonctionnement par défaut dans les formulaires)
ST Liens utilisateur comme libellés Entier long 16 Le libellé visible du lien utilisateur est retourné (fonctionnement par défaut dans les formulaires)
ST Liens utilisateur comme liens Entier long 32 Le contenu du lien utilisateur est retourné
ST Références comme espaces Entier long 0 Chaque référence est retournée sous forme d’un caractère espace insécable (fonctionnement par défaut, utilisé par les autres commandes)
ST Texte visible avec Expressions 4D comme sources Entier long 86 Retourne le texte tel qu’il est visible dans les formulaires avec la chaîne d’origine des expressions 4D.
Correspond à la combinaison prédéfinie des constantes 2+4+16+64.
ST Texte visible avec Expressions 4D comme valeurs Entier long 85 Retourne le texte tel qu’il est visible dans les formulaires avec les expressions 4D sous leur forme évaluée.
Correspond à la combinaison prédéfinie de constantes 1+4+16+64.
ST URL comme libellés Entier long 4 Le libellé visible des URLs est retourné, par exemple "Visitez notre site Web" (fonctionnement par défaut dans les formulaires)
ST URL comme liens Entier long 8 Le lien est retourné, par exemple "http://www.4d.com" 

Note : Le paramètre optionnel modeRéf n’est donc utile que si le texte contient des références, sinon le texte brut est identique quelle que soit la valeur du paramètre modeRéf.

Vous cherchez le texte "très beau" parmi les valeurs d’un champ texte multistyle. La valeur a été stockée sous la forme "Il fait très beau aujourd’hui".

 CHERCHER PAR FORMULE([Commentaires];ST Lire texte brut([Commentaires]Meteo)="@très beau@")

Note : Dans ce contexte, l’instruction suivante ne donnera pas le résultat escompté car le texte est enregistré avec des balises de style :

 CHERCHER([Commentaires];[Commentaires]Meteo="@très beau@")

Soit le texte suivant placé dans la zone multistyle "mazone" :

<span>Il est actuellement <span style="-d4-ref:'Heure courante:C178'"> </span><a href="http://www.4d.com"> Aller sur le site de 4D</a> ou <span style="-d4-ref-user:'openW'">Ouvrir une fenêtre</span></span></a></span>

Ce texte est affiché :

Si vous exécutez le code suivant :

 $txt :=ST Lire texte brut(*;"mazone";ST Références comme espaces)
     //$txt = "Il est actuellement    ou " (espaces)
 $txt :=ST Lire texte brut(*;"mazone";ST Expressions 4D comme valeurs)
     //$txt = "Il est actuellement 18:29:55  ou  "
 $txt :=ST Lire texte brut(*;"mazone";ST Expressions 4D comme sources)
     //$txt = "Il est actuellement Heure courante  ou  "
 $txt :=ST Lire texte brut(*;"mazone";ST URL comme liens)
     //$txt = "Il est actuellement  http://www.4d.com ou  "
 $txt :=ST Lire texte brut(*;"mazone";ST Texte visible avec Expressions 4D comme valeurs)
     //$txt = "Il est actuellement 17:54:30 Aller sur le site de 4D ou Ouvrir une fenêtre"
 $txt :=ST Lire texte brut(*;"mazone";ST Texte visible avec Expressions 4D comme sources)
     //$txt = "Il est actuellement Heure courante Aller sur le site de 4D ou Ouvrir une fenêtre"
 $txt :=ST Lire texte brut(*;"mazone";ST Liens utilisateur comme libellés)
     //$txt = "Il est actuellement    ou Ouvrir une fenêtre"
 $txt :=ST Lire texte brut(*;"mazone";ST Liens utilisateur comme liens)
     //$txt = "Il est actuellement    ou openW"

A l’issue de l’exécution de cette commande, la variable OK prend la valeur 1 si aucune erreur n’a été rencontrée et 0 dans le cas contraire. C’est le cas notamment lorsque l’évaluation des balises de style échoue (balise incorrecte ou manquante). 

A noter qu’en cas d’erreur, la variable n’est pas modifiée. Lorsqu’une erreur se produit sur une variable lors de l’évaluation du texte, 4D transforme le texte en texte brut ; par conséquent, les caractères <, > et & seront convertis en entités HTML.



Voir aussi  

ST FIXER TEXTE
ST FIXER TEXTE BRUT
ST Lire texte
TEXTE VERS TABLEAU

 
PROPRIÉTÉS 

Produit : 4D
Thème : Texte multistyle
Numéro : 1092
Nom intl. : ST Get plain text

Cette commande modifie la variable système OK

 
HISTORIQUE 

Créé : 4D v12
Modifié : 4D v12.1
Modifié : 4D v14
Renommé : 4D v14

 
MOTS-CLÉS 

multi-style, multistyle, multi style

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)