Strumenti di testo e di uso quotidiano · Text Toolkit
Letterale o regex? Perché un punto nel termine di ricerca può modificare ogni risultato
· Perché è importante
trova e sostituisci espressioni regolari modifica del testo
Spiega quali caratteri hanno un significato nelle espressioni regolari, cosa va storto quando "a.b" o "v1.2 (beta)" viene trattato come un modello e perché una modalità letterale che sfugge a tutto dovrebbe essere quella predefinita.
Ricerca di "v1.2" e corrispondenza di "v102": come uno strumento regex-first trasforma silenziosamente la punteggiatura in caratteri jolly
Un agente dell'assistenza che modifica `v1.2` nelle note di rilascio può ragionevolmente aspettarsi che questi quattro caratteri identifichino un'etichetta di versione. Con Regex abilitato, tuttavia, il punto indica qualsiasi carattere tranne un'interruzione di riga. Il modello può quindi corrispondere a `v102`, `v1-2` o `v1x2` e Sostituisci tutto può modificare le voci che non hanno mai fatto parte della versione richiesta.
Questo errore è silenzioso perché il modello è valido. Non è presente alcun messaggio di errore per distinguere un carattere jolly intenzionale dalla punteggiatura copiata da un nome di file. Il primo avviso potrebbe essere un numero di sostituzioni inaspettatamente elevato. Quando il compito è sostituire esattamente il testo noto, la punteggiatura dovrebbe essere un dato e non un'istruzione per il motore di ricerca.
I metacaratteri: punto, parentesi, parentesi, più, stella, punto interrogativo, barra verticale, accento circonflesso, dollaro e barra rovesciata e cosa fa ciascuno
Nella modalità regex JavaScript, un punto è un carattere jolly; le parentesi quadre definiscono una classe di caratteri; le parentesi creano un gruppo; inoltre, stella e punto interrogativo controllano la ripetizione; e una pipa offre alternative. Un segno di accento circonflesso e di dollaro ancorano il modello all'inizio o alla fine dell'intero testo in questo strumento, perché la modalità multilinea non è abilitata.
Una barra rovesciata modifica il modo in cui viene letto il carattere successivo e le parentesi graffe possono esprimere il numero di ripetizioni. Questi simboli contano solo nelle posizioni in cui la grammatica regex li tratta in modo speciale, quindi memorizzare un elenco è meno affidabile che decidere quale modalità richiede il lavoro. Se stai cercando di abbinare un'etichetta, un frammento di percorso o un nome di file fornito, inizia letteralmente.
I metacaratteri che contano nella modalità regex JavaScript
La modalità letterale fa sì che la ricerca significhi ciò che è stato digitato. ToolAcre evita i metacaratteri dell'espressione regolare prima di compilare la ricerca, quindi `v1.2 (beta)` corrisponde ai punti, allo spazio e alle parentesi stesse. Non trasforma la frase in un carattere jolly seguito da un gruppo di acquisizione e trova comunque ogni occorrenza esatta nel testo.
Questa fuga avviene solo dal lato della ricerca. Il campo di sostituzione segue ancora le regole della stringa di sostituzione JavaScript, dove `$&` inserisce il testo corrispondente e `$$` produce un simbolo del dollaro. La ricerca letterale è quindi l'impostazione predefinita sicura per identificare il testo, ma una sostituzione contenente i simboli del dollaro merita comunque una revisione deliberata prima di selezionare Sostituisci tutto.
Modalità Regex: quando vuoi il potere e come sfuggire da solo ai singoli personaggi
La modalità Regex è utile quando più moduli devono corrispondere a una regola. Un modello può avere come target un intervallo di cifre, punteggiatura facoltativa o alternative senza elencare ogni ortografia di origine. Attiva Regex solo quando tale variabilità è intenzionale, quindi esegui l'escape di un carattere speciale con una barra rovesciata quando deve mantenere il suo significato ordinario, ad esempio `.` per un punto.
Lo strumento compila il modello con la sintassi regex JavaScript e lo applica sempre a livello globale. La cancellazione della distinzione tra maiuscole e minuscole aggiunge la corrispondenza senza distinzione tra maiuscole e minuscole, ma i flag multilinea, punto tutto, permanente e unicode non sono offerti. Viene segnalata la sintassi non valida senza modificare il testo. Viene ancora eseguito un modello valido ma eccessivamente ampio, quindi il successo della compilazione non è la prova di un set di corrispondenze sicuro.
Esempio funzionante: sostituzione di 'config.yml (vecchio)' nelle note di rilascio in modalità letterale, quindi tentativo di fare lo stesso in modalità regex per vedere la differenza
Considera le note sulla versione contenenti `Load config.yml (old)`, `Archive configXyml old` e `Keep config.yml (new)`. Con Regex disattivato, cerca `config.yml (old)` e sostituiscilo con `config.yml (legacy)`. Cambia esattamente la prima frase perché il punto e le parentesi vengono preceduti dall'escape prima che il modello venga compilato.
Attiva Regex e invia la stessa ricerca senza caratteri di escape. Il punto può consumare un altro carattere, mentre le parentesi raggruppano `old` invece di corrispondere alle parentesi letterali, quindi la riga desiderata non corrisponde più a come è scritta. Un equivalente regex necessita di `config.yml (old)`. La versione letterale è più breve, più chiara e meglio allineata con questo compito di testo esatto.
Errori comuni: aggiungere spazi finali nella casella di ricerca, confondere parola intera e letterale e dimenticare il controllo del conteggio delle sostituzioni
Gli spazi finali sono facili da trascurare perché il campo di ricerca dà loro poco peso visivo, ma la modalità letterale li preserva. Una ricerca per `beta ` non corrisponderà a `beta` alla fine di una riga. Controlla i confini del campo quando un termine chiaramente visibile riporta zero sostituzioni ed evita di aggiungere spazi semplicemente per separare il testo copiato dalla prosa circostante.
La parola intera non è un altro nome per letterale. Avvolge la ricerca compilata nei limiti delle parole, che qui sono basate su ASCII e possono fallire in caso di punteggiatura o termini accentati. Controlla anche il conteggio delle sostituzioni dopo ogni esecuzione e usa Annulla quando è sorprendente. Il conteggio è una prova della portata, non un messaggio decorativo di successo.
Errori comuni: spazi, confini di parole intere e sintassi sostitutiva
Questa pagina non tenta di fornire una guida completa ai flag delle espressioni regolari. ToolAcre utilizza la corrispondenza globale e, facoltativamente, la corrispondenza senza distinzione tra maiuscole e minuscole, mentre le ancore si riferiscono comunque al testo completo anziché a ciascuna riga. I modelli copiati da motori con flag in linea, classi POSIX o sintassi diversa potrebbero non riuscire a compilare o potrebbero significare qualcos'altro nel browser.
I gruppi di acquisizione sono supportati, quindi la struttura necessita di una correzione anziché dire che sono esterni allo strumento. In modalità Regex, è possibile fare riferimento ai gruppi con `$1`, `$2` e numeri successivi nella sostituzione. Questa capacità è separata dalla ricerca letterale e dai controlli limitati dei flag; utilizzarlo solo quando l'obiettivo effettivo è la ristrutturazione del testo corrispondente.
Qui i flag sono limitati, mentre i gruppi di acquisizione sono supportati nelle sostituzioni
La regola pratica è semplice: lasciare disattivato Regex quando si sostituisce una versione conosciuta, un nome di file, un'etichetta di prodotto o un frammento di frase. La modalità letterale evita automaticamente i caratteri speciali, preservando la punteggiatura che identifica la destinazione. Abilita Regex solo quando puoi indicare quale variazione il modello dovrebbe accettare e perché una ricerca esatta non è sufficiente.
Prima di confermare le note di rilascio modificate, confronta il conteggio riportato con il numero di modifiche previste e controlla il risultato. ToolAcre lascia intatti i pattern non validi e fornisce l'opzione Annulla per un pattern valido che arriva troppo lontano. Queste garanzie aiutano, ma la scelta della modalità letterale per il lavoro letterale impedisce la corrispondenza ampia prima che avvenga.