Dilib, module Buffer, opérations

De Wicri Outils
LogoDilib.gif
Panneau travaux.png
Bibliothèque Dilib (ressources numériques)
Module Buffer

Introduction

Cette page introduit les opérations de manipulation de chaînes dans un Buffer ou dans son environnement.

 

Opérations sur les caractères

BufferCharCat

BufferStrcat ajoute un caractère à la fin d'un Buffer.

Synopsis
char *BufferStrcat(Buffer *b1, char c1)
Paramètres
b1 un Buffer,
c1 le caractère à concaténer.
Voir aussi

Importation de chaînes de caractères

Le contenu d'un Buffer se construit généralement à l'aide de chaînes de caractères. Pour cela l'interface Buffer offre un ensemble d'adaptations de la bibliothèque string.h.

BufferStrcat

BufferStrcat ajoute une chaîne de caractères à la fin du Buffer.

Synopsis
char *BufferStrcat(Buffer *b, char *str)
Paramètres
b un Buffer,
str la chaîne à concaténer.

BufferStrncat

  • BufferStrncat ajoute les n premiers caractères de la chaîne donnée à la fin du Buffer.

BufferStrcpy

  • BufferStrcpy copie une chaîne dans un Buffer.
Synopsis
char *BufferStrcpy(Buffer *b, char *str)
Paramètres
b un Buffer,
str la chaîne à copier.

BufferStrncpy

  • BufferStrncpy copie les n premiers caractères d'une chaîne dans un Buffer.

Concaténation de texte avec nettoyage

A partir de la version V0.6.06

BufferTextCleanCat

char *BufferTextCleanCat(Buffer *b, int mode, char *str);

mode :

  • s : string : les séquences de séparateurs sont remplacés par un seul espace ;
  • p : preserved : les séparateurs sont transcodés en entités numériques.

Manipulations internes à un Buffer

BufferStrRepl

La fonction BufferStrRepl remplace toutes les occurrences d'une chaîne donnée par une autre dans un Buffer.

Synopsis
char *BufferStrRepl(Buffer *b, char *s1, char *s2);
Paramètres
b un Buffer,
s1 la chaîne à remplacer.
s1 la chaîne remplaçante.
Exemple
 BufferStrRepl(bufXml, "\n", "");

 ...

BufferTailCut

La fonction BufferTailCut supprime un nombre donné de caractère en queue d'un Buffer.

Synopsis
char *BufferTailCut(Buffer *b, int n);
Paramètres
b un Buffer,
n le nombre de caractères à supprimer.
Exemple
 ...
 Buffer *bufSample;
 ...
 bufSample=BufferFromString ("France FR");
 BufferTailCut(bufSample, 3);
 printf("%s\n", BufferString(bufSample)); /* imprime France */
 ...

BufferTailCmp

BufferTailCmp applique la fonction strcmp à la fin du Buffer et à une chaîne de caractères.

Synopsis
char *BufferTailCmp(b,str)
            Buffer *b;
            char *str;
Paramètres
b un Buffer,
str la chaîne à comparer.
Exemple
  if ((BufferTailCmp(bufFileName, ".hfd")==0) ...

BufferTailReplace

BufferTailCmp remplace la fin du Buffer par une chaîne de caractères donnée en paramètre.

Synopsis
char *BufferTailReplace(b,str)
            Buffer *b;
            char *str;
Paramètres
b un Buffer,
str la chaîne remplaçante. Elle se substitue à la chaîne de même taille en fin de Buffer.
Exemple
  if ((BufferTailReplace(bufFileName, ".hcs")==0) ...