Skip to content

Classe C++ : CodeBuffer

Index · English

Description

Tampon multiligne UTF-8 avec curseur, état modifié et annulation.

Nom complet : gaspardos::desktop::CodeBuffer.

En-tête : bindings/cpp/code_buffer.hpp. C++98.

Dans quel cas l’utiliser

Éditer le texte de GaspardEdit en préservant BOM et fins de ligne.

Exemple de programme simple

#include "code_buffer.hpp"
#include <cstdio>
#include <cstring>

int main()
{
    gaspardos::desktop::CodeBuffer buffer;
    std::string                    error;
    if (!buffer.load("hello\r\n", error))
        return 1;
    buffer.place(0, 5);
    if (!buffer.key('!'))
        return 1;
    std::printf("%s", buffer.serialize().c_str());
    return buffer.dirty() && buffer.undo() && !buffer.dirty() ? 0 : 1;
}

Compilation depuis Windows

Enregistrer le programme ci-dessus dans build/api-examples/CodeBuffer.cpp, depuis la racine du dépôt. Créer le dossier si nécessaire.

PowerShell — depuis la racine du dépôt :

New-Item -ItemType Directory -Force build/api-examples | Out-Null
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/CodeBuffer.cpp bindings/cpp/file_explorer.cpp bindings/cpp/code_buffer.cpp -o build/api-examples/CodeBuffer-x64.elf
if ($LASTEXITCODE -ne 0) { throw "C++ compilation/link failed" }

Le binaire ELF s’exécute sous GaspardOS, pas sous Windows. Le pilote fournit CRT et bibliothèques. Préparer les volumes/services requis ; les exemples bornent leurs attentes et peuvent sortir sur saturation au lieu de réessayer. Une compilation réussie ne valide pas l’exécution noyau.

Les fichiers nécessaires à cet exemple sont disponibles dans la section Source files (en anglais).

Méthodes de la classe

CodeBuffer()

Crée un tampon vide à une ligne.

bool load(const std::string& raw, std::string& error)

Charge UTF-8/ASCII sans NUL, ≤1 Mio et ≤20000 lignes ; false et message sur refus.

void clear()

Vide texte, historique et paramètres de sérialisation.

bool dirty() const

Compare le texte courant à la dernière version saved.

std::string serialize() const

Octets à écrire ; restaure BOM/CRLF ; original exact si non modifié.

const std::string& original() const

Octets du dernier chargement ou saved ; référence interne.

void saved()

Marque l’état courant enregistré ; appeler seulement après écriture réussie.

std::size_t lineCount() const

Nombre de lignes (au moins une).

std::string line(std::size_t number) const

Ligne d’index zéro, sans fin de ligne ; chaîne vide si hors limites.

std::size_t row() const

Ligne du curseur, base zéro.

std::size_t column() const

Colonne en caractères UTF-8, base zéro.

void place(std::size_t row, std::size_t column)

Positionne le curseur avec bornage ligne/colonne.

bool key(uint32_t key)

Applique une touche Unicode/native ; false si insertion refusée ; Tab insère quatre espaces.

bool undo()

Restaure un instantané ; false si historique vide (64 états / 2 Mio).