✎ sed [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{tag>console}}
----
====== Sed ======

**sed** (**s**tream **ed**itor) permet de modifier ou de supprimer une partie d’une chaîne de caractères, par exemple pour remplacer un caractère par un
autre dans un fichier, ou encore supprimer des chaînes de caractères inutiles. C'est un outil très puissant.

<note>Les possibilités de cette commande en terme de syntaxe étant tellement vastes que nous n'aborderons que la partie émergée de l'iceberg (cette page étant bien évidemment perfectible dans le temps)</note>

===== Utilisation =====

Pour utiliser **sed**, vous devez lui fournir une chaîne à traiter. Cette chaîne peut provenir :

* d'un fichier
  * d'une variable

En règle générale la syntaxe est de la forme \\
"s/[//occurrence_cherchée//]/[//occurrence_de_substitution//]/[//comportement//]"\\
Un exemple simple de substitution dans une liste de fichiers :
<code bash>sed 's/occurrence_cherchée/occurrence_de_substitution/g' -i mes_fichiers*</code>

==== sed et les fichiers ====

Pour pouvoir traiter un fichier, il est nécessaire de lier le fichier à **sed.** Nous utiliserons la commande **grep** sous la forme : \\
  grep occurrence /fichier/a/parcourir | sed ... \\
  grep occurrence /fichier/a/parcourir | cut ... \\
ou encore même conjointement \\
  grep occurrence /fichier/a/parcourir | cut ... | sed ...

==== sed - cut et les variables ====

Pour nos exemples nous allons définir une variable à l'aide de la commande **export**
<code>export chaine="ceci est une chaine de caractères"</code>

Ainsi nous définissons la valeur de la variable $chaine. Nous pouvons à présent appeler cette variable au besoin.
<code bash>
echo $chaine | sed -e "s/ /_/g" 
# Donnera en réponse
ceci_est_une_chaine_de_caractères
</code>

<note>Remplacer les espaces par des caractères est une des étapes importantes visant à substituer les caractères pouvant être mal interprétés par la suite.
  * ''mplayer mon fichier.avi'' ne fonctionne pas tandis que ''mplayer mon**_**fichier.avi'' fonctionnera
  * Le **g** positionné après l'occurrence de substitution ("s/ /_/**g**") indique à **sed** de se comporter de façon globale ("récursive")
</note>

===== Exemple : =====

Nous voulons récupérer l'//uid// ainsi que le //gid// d'un utilisateur en cours.
Sous linux, l'utilisateur courant est défini dans la variable **$USER** \\
La preuve en est :
  echo $USER
// retourne l'utilisateur en cours // \\
l'//uid// et //gid// de l'utilisateur est stocké dans le fichier /etc/passwd.\\
Dans un premier temps récupérons la ligne concernant notre utilisateur (ici Florent).\\
<code>grep $USER /etc/passwd</code>
//parcourir le fichier **/etc/passwd** et retourner la ligne concernant le nom de l'utilisateur en cours//\\
Donnera en réponse
<code bash>florent:x:1000:1000::/home/florent:/bin/bash</code>

Vous me direz : parfait ! Et bien nous avons notre //uid// et //gid//. Certes mais le résultat est difficilement exploitable vous en conviendrez. Nous allons donc séparer de façon distincte les deux valeurs. Il nous faut pour cela analyser le résultat de la commande précédente pour définir des règles de traitement :
  - //uid// et //gid// sont sous la forme de chiffres
  - les informations sont séparées par **:**
  - la liste des paths est introduite par **::**

ces différentes remarques vont nous permettre de fixer des délimiteurs,
isolons donc la chaîne précédant les **::** du reste de la chaîne
<code bash>grep $USER /etc/passwd | sed "s/::/%/" |cut -d'%' -f1</code>
// Parcourir le fichier **/etc/passwd** et retourner la ligne concernant le nom de l'utilisateur en cours  **|** remplacer **(s)** les **::** par **%** dans le résultat **|** séparer le résultat au niveau du(des) délimiteur(s) **'%'** (-d) et afficher la première partie de cette séparation (-f1)// \\
donnera
<code bash>florent:x:1000:1000</code>

Le principe est donc maintenant posé. Effectuons une dernière action afin de mettre en forme le résultat :
 <code bash>grep $USER /etc/passwd | sed "s/::/%/g" |cut -d'%' -f1 |cut -d'x' -f2 |sed -e "s/:$[0-9][0-9]*$/UID=\1\n/"  -e "s/:$[0-9][0-9]*$/GID=\1/"
# Donnera
UID=1000
GID=1000
</code>

Décortiquons les différentes étapes du traitement :

|              ^ Commande                  ^ Sortie          ^
^ origine      | grep $USER /etc/passwd    | **florent**:x:1000:1000::/home/**florent**:/bin/bash |
^ Étape 1      | sed "s/::/%/"            | florent:x:1000:1000**%**/home/florent:/bin/bash  |
^ Étape 2      | cut -d'%' -f1             | florent:x:1000:1000                |
^ Étape 3      | cut -d'x' -f2             | :1000:1000    |
^ Étape 4      | sed -e "s/:$[0-9][0-9][0-9][0-9]$/UID=\1\n/"  -e "s/:$[0-9][0-9][0-9][0-9]$/GID=\1/" | UID=1000 \\ GID=1000 |

plus simple :
<code bash>
sed -n -e "/`echo $USER`/s/[^:]*:[^:]*:$[^:]*$:$[^:]*$:.*/UID=\1\nGID=\2/p" /etc/passwd
</code>

Voila les étapes du traitement d'une chaîne de caractères avec quelques détails à ne pas oublier.
<note warning>
  * L'ordre de traitement est crucial
  * Le délimiteur utilisé par **cut** ne peut excéder 1 caractère d'où l'étape 1 visant à remplacer deux caractères consécutifs par un caractère unique remarquable utilisé dans l'étape 2
  * L'étape 4 introduit quelques syntaxes intéressantes :
     - sed -e "[règle 1]" -e "[règle 2]" 
     - sed "s/$occurrence$/%\1%/" qui retourne %occurrence%
     - sed "s/$occurrence$/\1\n/" qui insère un retour à la ligne à la fin de l'occurrence
</note>

===== Astuces en Vrac =====

Une syntaxe intéressante peut s'avérer parfois très utile notamment pour des occurrences de type chemin de dossier **/chemin/de/fichier**. En effet la présence de caractères **/** peut poser certains problèmes. Afin de pallier cela il est possible d'utiliser une syntaxe différente que voici :
<code bash>sed -e "s|/chemin/vers/un/fichier|/chemin/vers/un autre|"</code>
ainsi les **/** seront correctement interprétés.

<note tip>Échappement ((https://stackoverflow.com/a/5980937/6614155)) : il est possible d'échapper certains caractères spéciaux, ainsi la modification ci-dessus peut aussi s'écrire 
<code bash>sed -e "s/\/chemin\/vers\/un\/fichier/\/chemin\/vers\/un autre/</code>
autres caractères à échapper : " [ ] . / ? , mais pas les () qui doivent être échappées au contraire, seulement pour définir un groupe à mémoriser</note>

Si vous désirez modifier des occurrences dans un fichier vous pouvez préférer l'option -i qui permet d'éditer un  fichier.
Ainsi :
<code bash>sed -i "s/une occurrence/une autre/g" /un/fichier.txt</code>
Va remplacer toutes les occurrences **une occurrence** par **une autre** dans le fichier **/un/fichier.txt**

=== Fin de ligne ===

sed traite les lignes individuellement (l'une après l'autre), il semble donc, au premier abord, incapable de joindre deux lignes séparées par un motif comportant le retour chariot (\n). Heureusement cette difficulté n'est qu'apparente : il suffit de lui indiquer de traiter les deux lignes.
Exemple : joindre à la ligne précédente chaque ligne commençant par un espace (soit substituer un espace simple aux deux caractères saut de ligne puis espace)
<code bash>sed 'N;s/\n / /g;P;D;' fichier</code>
Dans cet exemple "N" indique à sed de lire également la ligne suivante, "P" d'afficher le résultat et "D" d'effacer la ligne suivante (puisqu'elle a déjà été lue). Les différentes commandes sont séparées par des points-virgules.

Le texte suivant :
<file>
Aujourd'hui Ubuntu
 est incontestablement un beau succès.
On ne peut que s'en réjouir.
L'avenir appartient
 aux heureux utilisateurs de cette distribution.
</file>
deviens :
<file>
Aujourd'hui Ubuntu est incontestablement un beau succès.
On ne peut que s'en réjouir.
L'avenir appartient aux heureux utilisateurs de cette distribution.
</file>

Et pour finir la commande à saisir pour transformer les fins de lignes DOS (\r\n] en fins de ligne UNIX (\n) :
<code bash>
sed 's/^M$//' fichier
</code>
Où "^M" représente \r.
<note tip>en mode console l'affichage de ^M peut s'obtenir en saisissant CTRL+V puis CTRL+M</note>

=== Astuces rapides =====
||**Comment faire ?**|**Commandes**||
||Remplacer la chaîne ancienneChaine par la chaîne NouvelleChaine dans le fichier toto.txt | sed -i 's/ancienneChaine/NouvelleChaine/' /toto.txt||
||Remplacer la ligne complète qui commence par la chaîne ancienneChaine par la chaîne NouvelleChaine dans le fichier toto.txt | sed -i 's/ancienneChaine.*/NouvelleChaine/' /toto.txt||
||Remplacer la ligne complète qui contient la chaîne ancienneChaine par la chaîne NouvelleChaine dans le fichier toto.txt | sed -i 's/.*ancienneChaine.*/NouvelleChaine/' /toto.txt||
||Remplacer dans chaque ligne contenant 'foo' la chaîne ancienneChaine par la chaîne NouvelleChaine dans le fichier toto.txt |sed -i '/foo/s/./ancienneChaine/NouvelleChaine/g' toto.txt||

=== Pour conclure =====

Vous l'aurez bien compris avec ces deux commandes en poche vous pouvez foncièrement faire tout ce que vous souhaitez. Je ne peux que vous encourager à lire la documentation concernant l'usage et la syntaxe de ces deux commandes que vous trouverez en tapant respectivement **man sed** et **man cut** \\

Il ne vous reste plus qu'à intégrer ces connaissances à vos [[:tutoriel:script_shell|scripts shell]]

===== Liens =====
  * [[http://www.panix.com/~elflord/unix/sed.html|Tutorial SED]] (en) : tutoriel qui explique entres autres comment faire de la recherche multiligne
  * [[https://www.commentcamarche.net/faq/9536-sed-introduction-a-sed-part-i|Explications completes]] (fr) : très bon tutoriel sur l'utilisation de sed ainsi que de tres bonnes explications du fonctionnement
  * [[http://www.shellunix.com/sed.html | Tutorial SED]] (fr) : petit tutoriel simple en français
  * [[http://www.scotchlinux.tuxfamily.org/doc/sed.php|Man de SED illustrée]](fr): Ce qu' on apprend  à partir de la page de manuel de sed.
  * [[http://man2linux.blogspot.com/2010/11/sed.html|SED explications]] (fr) : Exemples sur l'utilisation de la commande SED
  * [[http://www.neoflow.fr/tutoriels.item.237/Trier-les-lignes-d-un-fichier-selon-un-mot.html|Trier les lignes d'un fichier selon un mot avec SED]]
  * [[http://www.neoflow.fr/tutoriels.item.236/Enlever-les-commentaires-d%27un-fichier.html|Enlever les commentaires d'un fichier avec SED]] FIXME (lien mort le 3/5/2023)
  * [[https://fr.wikipedia.org/wiki/Stream_Editor|page Wikipedia]]
  * [[https://forum.macbidouille.com/index.php?showtopic=128499|supprimer \n]]
  * [[https://www.commentcamarche.net/faq/5978-sed-conversion-retours-chariots-dos-crlf-unix-lf|retour chariot DOS]]

----
Contributeurs : [[utilisateurs/va-nu-pied|flo|va-nu-pied]], [[utilisateurs/bcag2]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain : O F E U X Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported