Classe C++ : CodeBuffer¶
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).