sLit (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Divers
Transmission entre deux postes utilisant des formats de chaînes de caractères différents (UNICODE et ANSI)
Utilisation d'une librairie externe : RXTX

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

sLit (Fonction)

En anglais : sRead

Lit une chaîne de caractères dans le buffer d'entrée du port série spécifié. Le port doit être préalablement ouvert (fonction sOuvre).

Lit un buffer dans le buffer d'entrée du port série ou du port infrarouge spécifié. Le port doit être préalablement ouvert (fonction sOuvre).

Remarques :

Cette fonction ne peut pas être utilisée avec un port parallèle.
Cette fonction concerne le poste serveur.
Versions 16 et supérieures
La gestion des ports infrarouges n'est pas disponible.
Nouveauté 16
La gestion des ports infrarouges n'est pas disponible.
La gestion des ports infrarouges n'est pas disponible.
Versions 25 et supérieures
Seuls les ports série sont gérés.
Nouveauté 25
Seuls les ports série sont gérés.
Seuls les ports série sont gérés.

Versions 16 et supérieures

Cette fonction est désormais disponible pour les applications Java.

Nouveauté 16

Cette fonction est désormais disponible pour les applications Java.

Versions 25 et supérieures

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible pour les applications WINDEV sous Linux.

Nouveauté 25

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible pour les applications WINDEV sous Linux.

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible pour les applications WINDEV sous Linux.

Exemple

// Lecture dans la variable Message de 20 caractères dans
// le buffer d'entrée de COM1
Mess est une chaîne
Mess = sLit(1, 20)

// Lecture dans la variable Message de 20 octets dans le buffer d'entrée de COM1
Mess est un Buffer
Mess = sLit(1, 20)

Syntaxe

Lire un nombre d'octets et récupérer une chaîne Masquer les détails

<Résultat> = sLit(<Numéro de port> , <Nombre d'octets à lire>)

<Résultat> : Chaîne de caractères

Chaîne de caractères lue dans le buffer d'entrée,
0 si la lecture n'a pas été effectuée.

<Numéro de port> : Entier

Numéro du port série concerné : 1, 2, 3, ... 32 pour COM1, COM2, COM3, ... COM32.
Identifiant du port série renvoyé par la fonction sOuvre (si cette fonction a été appelée avec un nom de port série).
Versions 25 et supérieures
Seul ce type de paramètre est disponible.
Nouveauté 25
Seul ce type de paramètre est disponible.
Seul ce type de paramètre est disponible.

<Nombre d'octets à lire> : Entier

Nombre d'octets à lire dans le buffer d'entrée du port série. Le nombre d'octets à lire peut être obtenu avec la fonction sDansFileEntrée.

Lire un nombre d'octets et récupérer un buffer Masquer les détails

<Résultat> = sLit(<Numéro de port> , <Taille à lire>)

<Résultat> : Buffer

Buffer lu dans le buffer d'entrée,
0 si la lecture n'a pas été effectuée.

<Numéro de port> : Entier

Numéro de port concerné :
Numéro du port série : 1, 2, 3, ... 32 pour COM1, COM2, COM3, ... COM32.
Numéro du port infrarouge : 1, 2, 3, ... 32 pour IR1, IR2, IR3, ... IR32.
Numéro de port renvoyé par la fonction sOuvre (si cette fonction a été appelée avec un nom de port).

<Taille à lire> : Entier

Nombre d'octets à lire dans le buffer d'entrée du port série. Le nombre d'octets à lire peut être obtenu avec la fonction sDansFileEntrée.
Rappel : En UNICODE, chaque caractère occupe deux octets de mémoire.

Remarques

Divers

Si le port n'a pas été ouvert par la fonction sOuvre, la fonction sLit n'a aucune action.
La fonction sLit vide la file d'entrée du nombre d'octets réellement lus.
Une application 32 bits est bloquée pendant la durée du transfert. Pour éviter ce blocage, il faut préciser le temps d'attente entre deux lectures dans la fonction sOuvre. Lorsque le temps d'attente est terminé et si la lecture n'a pas pu être réalisée, sLit renvoie 0.
Le WLangage ne permet pas de gérer les signaux de contrôle.

Transmission entre deux postes utilisant des formats de chaînes de caractères différents (UNICODE et ANSI)

Lors de la transmission de messages entre deux postes utilisant un format de chaînes de caractères différent (par exemple Windows (ANSI) et Windows Mobile (UNICODE)), certaines conversions sont nécessaires :


Format des chaînes de caractères sur le poste en cours	Ecriture (fonction sEcrit)	Lecture (fonction sLit)
Format des chaînes de caractères sur le poste en cours	Ecriture (fonction sEcrit)	Buffer contenant une chaîne au format ANSI	Buffer contenant une chaîne au format UNICODE
ANSI (PC sous Windows XP par exemple)	La chaîne de caractères sera au format ANSI	Aucune conversion nécessaire	Conversion nécessaire (fonction UnicodeVersAnsi)
UNICODE (Pocket PC sous Windows CE par exemple)	La chaîne de caractères sera au format UNICODE	Conversion nécessaire (fonction AnsiVersUnicode)	Aucune conversion nécessaire

Versions 16 et supérieures

Utilisation d'une librairie externe : RXTX

En Java, l'utilisation des fonctions de manipulation des ports séries et parallèles (fonctions sOuvre, sEcrit, sLit, ...) nécessite la présence d'une librairie externe : RXTX.

Cette librairie est composée d'une archive Jar et d'une ou plusieurs librairies natives dépendantes du système d'exploitation sur lequel s'exécute l'application. Pour utiliser ces fonctions :

l'archive jar (RXTXComm.jar) doit :
- soit se trouver dans le même répertoire que l'application Java générée par WINDEV,
- soit se trouver dans le classpath d'exécution de l'application,
- soit être directement intégrée dans l'application générée (depuis l'assistant de génération Java).
la ou ou les librairies natives correspondant au système d'exploitation sur lequel s'exécute l'application doivent se trouver:
- soit dans le même répertoire que l'application Java générée par WINDEV,
- soit dans le chemin des librairies de l'application (librarypath).

Il est possible de télécharger la librairie RXTX et sa documentation grâce au lien suivant : http://users.frii.com/jarvi/rxtx/index.html (lien valide lors de l'écriture de cette documentation).

Attention : La gestion des ports infrarouges n'est pas disponible en Java.

Nouveauté 16

Utilisation d'une librairie externe : RXTX

En Java, l'utilisation des fonctions de manipulation des ports séries et parallèles (fonctions sOuvre, sEcrit, sLit, ...) nécessite la présence d'une librairie externe : RXTX.

Cette librairie est composée d'une archive Jar et d'une ou plusieurs librairies natives dépendantes du système d'exploitation sur lequel s'exécute l'application. Pour utiliser ces fonctions :

l'archive jar (RXTXComm.jar) doit :
- soit se trouver dans le même répertoire que l'application Java générée par WINDEV,
- soit se trouver dans le classpath d'exécution de l'application,
- soit être directement intégrée dans l'application générée (depuis l'assistant de génération Java).
la ou ou les librairies natives correspondant au système d'exploitation sur lequel s'exécute l'application doivent se trouver:
- soit dans le même répertoire que l'application Java générée par WINDEV,
- soit dans le chemin des librairies de l'application (librarypath).

Il est possible de télécharger la librairie RXTX et sa documentation grâce au lien suivant : http://users.frii.com/jarvi/rxtx/index.html (lien valide lors de l'écriture de cette documentation).

Attention : La gestion des ports infrarouges n'est pas disponible en Java.

Utilisation d'une librairie externe : RXTX

En Java, l'utilisation des fonctions de manipulation des ports séries et parallèles (fonctions sOuvre, sEcrit, sLit, ...) nécessite la présence d'une librairie externe : RXTX.

Cette librairie est composée d'une archive Jar et d'une ou plusieurs librairies natives dépendantes du système d'exploitation sur lequel s'exécute l'application. Pour utiliser ces fonctions :

l'archive jar (RXTXComm.jar) doit :
- soit se trouver dans le même répertoire que l'application Java générée par WINDEV,
- soit se trouver dans le classpath d'exécution de l'application,
- soit être directement intégrée dans l'application générée (depuis l'assistant de génération Java).
la ou ou les librairies natives correspondant au système d'exploitation sur lequel s'exécute l'application doivent se trouver:
- soit dans le même répertoire que l'application Java générée par WINDEV,
- soit dans le chemin des librairies de l'application (librarypath).

Il est possible de télécharger la librairie RXTX et sa documentation grâce au lien suivant : http://users.frii.com/jarvi/rxtx/index.html (lien valide lors de l'écriture de cette documentation).

Attention : La gestion des ports infrarouges n'est pas disponible en Java.

Classification Métier / UI : Code métier

Composante : wd260com.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 10/11/2020

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