Retire les espaces d’une chaîne de caractères.

trim series

series - La série argument. (type: series! port!)

/head - Retire les espaces seulement depuis le début.

/tail - Retire les espaces seulement depuis la fin.

/auto - Indente automatiquement les lignes par rapport à la première ligne.

/lines - Retire tous les sauts de lignes et les espaces en trop.

/all - Retire tous les espaces.

/with -

str - Indentique à /all, mais retire “str” de la chaîne de caractères passée en arguments. (type: char! string!)

L’utilisation par défaut de TRIM est de retirer les espaces et les tabulations d’une chaîne de caractères depuis le début et la fin pour chaque ligne de la chaîne de caractères.

    str: "  string   "
    probe trim str
    "string"

Quand une chaîne de caractère inclu plusieur lignes, les caractères d’espacement et de tabulation de début et de fin serront retirer pour chaque ligne (mais pas a l’interrieur de la ligne).

    str: {
        Now is the winter
        of our discontent
        made glorious summer
        by this sun of York.
    }
    probe trim str
    {Now is the winter
    of our discontent
    made glorious summer
    by this sun of York.
    }

Le terminateur de ligne final est préservé.

Notez que TRIM modifie la chaine de caractères durant le traitement.

    str: "  string   "
    trim str
    probe str
    "string"

TRIM ne copie pas la chaîne de caractère. Si c’est ce que vous voulez faire, alors vous devez utilisez TRIM en conjonction avec COPY pour copier la chaîne de caractères avant d’y appliquer le traitement TRIM.

Plusieur raffinement de TRIM sont disponnibles. Pour ne retirer les caractères d’espacement juste du début et/ou de la fin de la chaîne de caractères vous pouvez utiliser les raffinements /HEAD ou /TAIL.

    probe trim/head "  string  "
    "string  "

    probe trim/tail "  string  "
    "  string"

    probe trim/head/tail "  string  "
    "string"

Quand vous utiliser /HEAD ou /TAIL, les lignes multiple ne sont pas affectés.

    probe trim/head {  line 1
        line 2
        line 3
    }
    {line 1
            line 2
            line 3
        }

Pour ne retirer que les caractères d’espacement qu’au début et qu’à la fin d’une chaîne de caractère à lignes multiples, mais sans touchées aux caractères d’espacement interne:

    str: {  line 1
        line 2
            line 3
                line 4
                    line 5  }
    probe trim/head/tail str
    {line 1
            line 2
                line 3
                    line 4
                        line 5}

Si vous utiliser TRIM/LINES alors toutes les lignes et les caractères d’espacement supplémentaires serront retirer du texte. C’est très util pour des applications en word wrap et en pages web.

    str: {
        Now   is
        the
        winter
    }
    probe trim/lines str
    "Now is the winter"

Vous pouvez aussi retirer /ALL caractères d’espacement/

    probe trim/all " Now is   the winter "
    "Nowisthewinter"

    str: {
        Now   is
        the
        winter
    }
    probe trim/all str
    "Nowisthewinter"

Un des raffinements les plus util de TRIM est le raffinement /AUTO lequel démarrera un trim “intelligent” de l’indentation des lignes du texte. Ce mode détecte l’indentation depuis la première ligne et préserve l’indentation pour les lignes qui suivent:

    probe trim/auto {
        line 1
            line 2
            line 3
                line 4
        line 5
    }
    {line 1
        line 2
        line 3
            line 4
    line 5
    }

C’est très util pour une section de text qui est intégrée à l’interrieur du code et indentée au niveau du code.

Pour retirer tous autes caractères, le raffinement /WITH est fourni. Il prend une chaîne de caractères qui spécifie quels caractères doivent être retirés.

    str: {This- is- a- line.}
    probe trim/with str "-"
    "This is a line."

    str: {This- is- a- line.}
    probe trim/with str "- ."
    "Thisisaline"

clear - Retire toutes les valeurs dans une série de l’index courrent à la fin de la série. Retourne la fin de la série.

parse - Analyse une série en accord avec les règles.

remove - Supprime des valeurs d’une série et retourne cette série après suppression.