# Het handboek van &kfilereplace;

## Inleiding

&kfilereplace; is een toepassing waarmee u een lijst van tekenreeksen in een bestandenboom kunt zoeken en vervangen. Dit kunnen letterlijke tekenreeksen zijn of &Qt;-achtige reguliere expressies. Verder zijn er een aantal opties waarmee u uw zoekopdracht kunt verfijnen.

## &kfilereplace; gebruiken

&kfilereplace; als alleenstaande toepassing &kfilereplace; als alleenstaande toepassing

### De werkbalk

De werkbalk van &kfilereplace; zou er als volgt uit moeten zien: De werkbalk van &kfilereplace; De werkbalk van &kfilereplace;

Op de werkbalk ziet u de knoppen van de belangrijkste functies.

### Werkbalkpictogrammen

Zoeken/vervangen-sessie aanpassen

- Deze knop toont een sessie-dialoogvenster, waarin u diverse basisopties kunt instellen; als &kfilereplace; als alleenstaande toepassing draait dient u dit als eerste te doen.

Zoeken

- Deze knop start een zoeklus.

Simuleren

- Deze knop start een gesimuleerde zoek&vervang-lus. Er wordt niets daadwerkelijk vervangen.

Vervangen

- Deze knop start een zoek&vervang-lus. Als een tekenreeks gevonden is, vervangt &kfilereplace; deze door een andere tekenreeks.

Stoppen

- Deze knop stopt een actie.

Tekenreeks toevoegen

- Met deze knop opent u het dialoogvenster Tekenreeksen toevoegen waarin u uw tekenreeksen kunt bewerken.

Tekenreeks verwijderen

- Met deze knop verwijdert u de geselecteerde tekenreeks (of de huidige, als er geen selectie is) uit de lijst.

Geselecteerde tekenreeks bewerken

- Met deze knop bewerkt u een geselecteerde tekenreeks.

Lijst met tekenreeksen leegmaken

- Deze knop verwijdert alle tekenreeksen uit de lijst.

Huidige tekenreeks omdraaien

- Deze knop verwisselt een zoek- en een vervang-tekenreeks met elkaar, zodat u de zoek/vervang-operatie kunt terugdraaien.

Tekenreeksenlijst uit bestand laden

- Deze knop laadt een lijst van tekenreeksen opgeslagen in een xml-bestand met een extensie `kfr`.

Inclusief submappen

- Met deze knop kunt u recursief in de submappen van uw basismap zoeken en vervangen.

Reserve kopieën maken

- Deze knop schakelt het maken van reservekopie-bestanden in.

Hoofdlettergevoelig

- Deze knop schakelt hoofdlettergevoelig zoeken in.

Commando's in vervangende tekenreeks inschakelen

- Deze opdracht schakelt de mogelijkheid tot het gebruiken van opdrachten in. Opdrachten zijn speciale tekenreeksen. Zie kfilereplace-commands.

Reguliere expressies activeren

- Deze knop schakelt &Qt;-achtige reguliere expressies in.

### De resultatenlijst

De resultatenweergave van &kfilereplace; De resultatenweergave van &kfilereplace;

De resultatenweergave toont de namen van de bestanden waarin de gevonden (en vervangen) tekenreeksen voorkomen, hun pad, hun grootte, het aantal gevonden tekenreeksen en de gebruikers-id van de bestanden. Deze weergave toont ook de precieze plaats van de gevonden tekenreeksen. U kunt ook een bestand openen door met de &RMB; op een lijst-item te klikken dat de regel en kolom bevat.

### De tekenreeksen-lijst

Dit is de tekenreeks-weergave: De tekenreeksweergave van &kfilereplace; De tekenreeksweergave van &kfilereplace;

De tekenreeks-weergave toont de lijst van woorden die u wilt zoeken/vervangen. Let op dat in zoekmodus de resultaten- en de tekenreeks-weergave een andere indeling hebben.

### De dialoog Zoeken & vervangen in bestanden

De dialoog Zoeken & vervangen in bestanden wordt gebruikt om de basisparameters in te stellen die &kfilereplace; nodig heeft om te werken. Het bestaat uit twee tabbladen, Algemeen en Geavanceerd.

#### Het tabblad Algemeen

Het tabblad "Algemeen" van &kfilereplace; Het tabblad "Algemeen" van &kfilereplace;

Als u een nieuwe sessie wilt beginnen is de eerste stap om op de knop Zoeken/vervangen aanpassen te klikken. Dan dient u het basispad in te voeren en een serie van shell-achtige jokertekens om als filter te gebruiken.

Dan kunt u wat nuttige opties instellen, zoals zoeken in alle submappen, een hoofdlettergevoelige zoekactie uitvoeren, opdrachten inschakelen en/of reguliere expressies

Let op dat reguliere expressies en opdrachten de snelheidsprestatie verslechteren.

, een reservekopie maken van elk bestand vóór vervangen.

Als u wilt beginnen met zoeken, kunt u een tekenreeks in het zoekveld invoeren en de knop Nu zoeken kiezen, anders laat u het zoekveld leeg en kiest u Later zoeken.

#### Het tabblad Geavanceerd

Het tabblad "Geavanceerd" van &kfilereplace; Het tabblad "Geavanceerd" van &kfilereplace;

Op het tabblad Geavanceerd kunt u een aantal nuttige opties instellen om het zoeken te beperken tot een kleiner deel van uw bestandsboom. Als u &kfilereplace; alleen op bestanden wilt laten werken die een grootte hebben van 10 KB - 100 KB, kunt u de grootte-opties gebruiken. Er is ook een datumoptie die de zoekactie beperkt tot een bepaalde periode, en een laatste optie waarmee u alleen in bestanden kunt zoeken die (niet) van een bepaalde gebruiker zijn (dit kan nuttiger zijn voor systeembeheerders).

### De dialoog Opties

Dit dialoogvenster bevat opties uit de werkbalk en extra opties die in sommige situaties handig kunnen zijn. U kunt het oproepen door Instellingen KFileReplace instellen... uit het hoofdmenu te kiezen.

#### Algemene opties

Deze opties zijn beschreven in de sectie Werkbalk. Het tabblad "Algemeen" van het venster "Opties" Het tabblad "Algemeen" van het venster "Opties"

#### Geavanceerde opties

Het tabblad "Geavanceerd" van het venster "Opties" Het tabblad "Geavanceerd" van het venster "Opties"

Bestanden niet tonen als er geen tekenreeksen zijn gevonden of vervangen Stop bij het zoeken bij de eerste vindplaats Symbolische koppelingen volgen Verborgen bestanden en mappen negeren
- toont alleen de bestanden die met sommige tekenreeksen overeenkomen. Dit versnelt het zoeken. &kfilereplace; stopt als het een overeenkomende tekenreeks vindt, en gaat door met zoeken voor andere tekenreeksen of gaat door met het volgende bestand als u naar slechts één tekenreeks zoekt. als een bestand een koppeling is naar een ander, zoek dan in het echte bestand. als verborgen bestanden of mappen gevonden worden, negeer deze.

### De dialoog Zoeken/vervangen van tekenreeksen invoegen

De dialoog Zoeken/vervangen van tekenreeksen invoegen van &kfilereplace; De dialoog Zoeken/vervangen van tekenreeksen invoegen van &kfilereplace;

Dit dialoogvenster wordt gebruikt om een lijst met tekenreeksen in te voegen en te bewerken. U hoeft slechts een lijst voor alleen zoeken of voor zoeken en vervangen in te voegen, en kunt dan met de twee mini-editors uw tekst invoeren. Met de pijlknoppen kunt u paren tekenreeksen toevoegen of verwijderen. Als u klaar bent, klikt u OK.

## Mogelijkheden van &kfilereplace;

Dit hoofdstuk biedt informatie over een aantal nuttige mogelijkheden van &kfilereplace;

### Uw tekenreekslijst opslaan

Als u een lijst met tekenreeksen wilt hergebruiken kunt u deze in een `xml`-bestand opslaan. Hiertoe kiest u uit de menubalk Zoeken/vervangen Tekenreeksen Tekenreeksen in bestand opslaan. Als u een lijst opslaat wordt een eenvoudig `xml`-bestand met de extensie `kfr` aangemaakt. Om een `kfr`-bestand te laden, kiest u uit de menubalk Zoeken/vervangen Tekenreeksen Tekenreeksen uit bestand laden. Het werkelijke bestand ziet er als volgt uit:

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_1]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_1]]
    ></newstring>
            </replacement>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_2]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_2]]
    ></newstring>
            </replacement>

            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_N]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_N]]
    ></newstring>
            </replacement>

    </kfr
    >

Als u een vorig formaat gebruikt, kunt u met de hand uw bestand bijwerken door het aan te passen aan het bovenstaande schema. U kunt ook het bestand dat in het oude formaat geschreven is inladen en het opnieuw met &kfilereplace; opslaan zoals hierboven uitgelegd.

### Hoe een eenvoudig rapport aan te maken

U kunt een rapport aanmaken door Zoeken/vervangen Resultaten Rapportbestand maken uit het hoofdmenu te kiezen. Een rapport is een map die een `xml`- en een `css`-bestand bevat. Rapporten kunnen nuttig zijn om een eenvoudig logboek van uw handelingen bij te houden. De rapportagemogelijkheid van &kfilereplace; De rapportagemogelijkheid van &kfilereplace;

### Hoe reguliere expressies te gebruiken

Als u elke tekenreeks wilt zoeken die begint met x, ht of u en eindigt met ml, kunt u een reguliere expressie schrijven als: `(x|ht|u)ml`. Voeg deze expressie in in de zoekeditor, klik OK en schakel reguliere expressies in door de knop Reguliere expressie in te schakelen. Let op dat het gebruik van reguliere expressies u erg gecompliceerde zoekacties biedt, maar dat dit een prestatievermindering kost. Reguliere expressies kunnen erg lastig zijn, en vaak geldt als u een probleem wilt oplossen met een reguliere expressie, heeft u twee problemen.

### Hoe originele bestanden te beschermen

Als u uw originele bestanden niet wilt verliezen, kunt u een kopie van ze maken voordat u de tekenreeksen vervangt. Nadat u uw tekenreeksen hebt ingevoerd, en voordat u het vervangingsproces start, schakelt u hiervoor de knop Reservekopie in. Als u de extensie van de reservekopiebestanden wilt aanpassen opent u het dialoogvenster Opties.

### Hoe een bestand te openen

Als u een bestand wilt openen dat een aantal gezochte tekenreeksen bevat, selecteert u een regel in de resultatenweergave en klikt u deze aan met de &RMB;. Er verschijnt een contextmenu waaruit u het bestand kunt openen.

### Commando's

Stel dat u de tekst Alice in Wonderland wilt vervangen door het gehele bestand waarin de tekst van Carrolls boek staat. Dat wilt u waarschijnlijk niet met de hand doen, wat u wilt is een opdracht die dit voor u doet. Kies dus de knop Toevoegen, kies Zoek- en vervangmodus en voer de volgende tekenreeksen in: als zoekterm `Alice in Wonderland` en als vervangtekenreeks `[$loadfile:`/het-pad-naar-mijn-map/mijn-map/mijn-bestand`$]`in de vervangings mini-editor. Kies OK, en als u teruggekeerd bent in het hoofdvenster van &kfilereplace; schakelt u de knop Opdrachtactie in die de opdrachten inschakelt, en start u de vervangactie. Er zijn meer opdrachten beschikbaar, zie available-commands voor een overzicht.

## Dankbetuiging en licentie

&kfilereplace;. Programma copyright 1999 door François Dupoux dupoux@dupoux.com 2003 Andras Mantia amantia@kde.org 2004 Emiliano Gulminiemi_barbarossa@yahoo.it

## Auteurs en onderhouders van &kfilereplace;:

François Dupoux dupoux@dupoux.com

- Oorspronkelijke auteur

Andras Mantia amantia@kde.org

- Shell-auteur, maker van KPart, mede-onderhouder

Emiliano Gulmini emi_barbarossa@yahoo.it

- Onderhoud, opschonen & herschrijven van de code

Documentatie copyright © 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

&meld.fouten;&vertaling.sander;&nagelezen.tom;

Nagelezen door Antoon Tolboom

&underFDL; &underGPL;

## Installatie en compilatie

&install.intro.documentation; &install.compile.documentation;

### Vereisten

Om de opdracht [$mathexp:`wiskundige_uitdrukking`$] te kunnen gebruiken heeft u het wiskundige gereedschap &bc; nodig (versie 1.06 of hoger) van Philip A. Nelson (philnelson@acm.org).

## Opdrachten van &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/mijn-pad/mijn-map/mijn-bestand`$] [$empty:$] [$random:`GEHEEL_GETAL`$] [$random:$] [$mathexp:`bc-uitdrukking`$]
- dit commando retourneert de huidige datum en tijd in &Qt; ISO-formaat. zoals boven maar in lokaal formaat. retourneer het UID van de huidige gebruiker. retourneer het GID van de huidige gebruiker. retourneer de aanmeldnaam van de huidige gebruiker. retourneer de volledige naam van de huidige gebruiker. retourneer de persoonlijke map van de huidige gebruiker. retourneer de shell van de huidige gebruiker. retourneer de inhoud van het bestand mijnbestand. retourneer de lege tekenreeks. retourneer een willekeurig getal met GEHEEL_GETAL als het eerste zaadgetal. als boven, maar zonder eerste zaadgetal. retourneer het resultaat van een wiskundige uitdrukking volgens &bc; v1.06

&documentation.index;