Subversion Repositories wimsdev

$lst_tit text $lst_titend$type_both

tit:text

  $(lst_syntax)text $emph operation $emphend $emph parameter $emphend</span>

type:$type_both

  $lst_mean This is intended to be a very powerful text manipulation tool,

syntax:!text `operation' `parameter'

  allowing very sophisticated processing of long text strings with high speed. <br/>

mean:This is intended to be a very powerful text manipulation tool,\

  Many of the $emph operations$emphend accept masks. A mask is a string

  allowing very sophisticated processing of long text strings with high speed. <br/>\

  composed of '0's and '1's. For operations

  Many of the `operations' accept masks. A mask is a string composed of `0's and `1's. \

  which accept a mask, only characters at positions whose corresponding

  For operations which accept a mask, only characters at positions whose corresponding\

  character in the mask is not a '0' are processed. (In this sense positions

  character in the mask is not a `0' are processed. (In this sense positions\

  corresponding to '0's are $emph masked$emphend.) Empty mask is considered

  corresponding to `0's are `masked'.) Empty mask is considered\

  as of being entirely composed of '1's. <br/>

  as of being entirely composed of `1's. <br/>\

  A mask which is too short repeats itself, unless it terminates with a '+',

  A mask which is too short repeats itself, unless it terminates with a `+',\

  in which case it fills the rest with '1's, or with a '-', in which case

  in which case it fills the rest with `1's, or with a `-', in which case\

  it fills the rest with '0's. <br/>

  it fills the rest with `0's. <br/>\

  For the time being, implemented $emph operations $emphend are as follows.

  For the time being, implemented `operations' are as follows.\

  <ul>

  <ul>\

   <li><span class="tt">!text common $emph text1$emphend and $emph text2$emphend

   <li><span class="tt">!text common `text1' and `text2' [mask `maskstring']</span> <br/>\

    [mask $emph maskstring$emphend]</span> <br/>

    Extracts characters in `text1' one by one, for those identical\

    Extracts characters in $emph text1$emphend one by one, for those identical

    to the corresponding characters in `text2' and whose\

    to the corresponding characters in $emph text2$emphend and whose

    positions are not masked by `maskstring'.\

    positions are not masked by $emph maskstring$emphend.

   </li><li><span class="tt">!text compare `text1' and `text2'\

   <li><span class="tt">!text compare $emph text1$emphend and $emph text2$emphend

    </span> <br/>\

    </span> <br/>

    Compares the strings `text1' and `text2' character by character, \

    Compares the strings $emph text1 $emphend and $emph text2

    and returns a mask string with `0's onpositions where the corresponding characters in `text1'\

    $emphend character by character, and returns a mask string with '0's on

    and `text2' are equal, and `1's otherwise.\

    positions where the corresponding characters in $emph text1 $emphend

   </li><li><span class="tt">!text copy `text' [mask `maskstring']</span> <br/>\

    and $emph text2$emphend are equal, and '1's otherwise.

    Returns non-masked characters in `text'.\

   <li><span class="tt">!text copy $emph text$emphend

   </li><li><span class="tt">!text count `charlist' in `text' [mask `maskstring']</span> <br/>\

    [mask $emph maskstring$emphend]</span> <br/>

    Returns the number of characters in `text' whose positions\

    Returns non-masked characters in $emph text$emphend.

    are not masked by `maskstring', and who appear in `charlist'.\

   <li><span class="tt">!text count $emph charlist$emphend in $emph text$emphend

   </li><li><span class="tt">!text diff `text1' from `text2' [mask `maskstring']</span> <br/>\

    [mask $emph maskstring$emphend]</span> <br/>

    Extracts characters in `text1' one by one, for those different to the corresponding \

    Returns the number of characters in $emph text$emphend whose positions

    characters in `text2' and whose positions are not masked by `maskstring'. <br/>\

    are not masked by $emph maskstring$emphend, and who appear in $emph

    (Synonyme of diff: differ).\

    charlist$emphend.

   </li><li><span class="tt">!text expand `text' using `maskstring'\

   <li><span class="tt">!text diff $emph text1$emphend from $emph text2$emphend

    </span> <br/>\

    [mask $emph maskstring$emphend]</span> <br/>

    Produces a string, where positions corresponding to `0's in\

    Extracts characters in $emph text1$emphend one by one, for those different

    `maskstring' are filled by ` ' (the space character),\

    to the corresponding characters in $emph text2$emphend and whose

    and where positions corresponding to `1's in `maskstring' are filled by characters of \

    positions are not masked by $emph maskstring$emphend. <br/>

    `text'. The characters in `text' are used one by one, and the\

    (Synonyme of diff: differ).

    resulting string stops when all the characters in `text' are exhausted \

   <li><span class="tt">!text expand $emph text$emphend using $emph maskstring$emphend

    (or when the string reaches the length limit).\

    </span> <br/>

   </li><li><span class="tt">!text insert `text1' into `text2' [mask `maskstring']</span> <br/>\

    Produces a string, where positions corresponding to '0's in

    Returns `text2' with non-masked characters replaced by characters `text1'. \

    $emph maskstring$emphend are filled by ' ' (the space character),

    Characters in `text1' are used one by one (without taking into account the masking), and\

    and where positions corresponding to '1's in $emph maskstring

    the replacement stops when there is no character left in `text1'.\

    $emphend are filled by characters of $emph text$emphend. The

   </li><li><span class="tt">!text interact `text1' and `text2' table `itab' [mask `maskstring']</span> <br/>\

    characters in $emph text$emphend are used one by one, and the

    Returns a new text which is result of interactions of characters\

    resulting string stops when all the characters in $emph text

    in corresponding positions in `text1' and `text2'. The rule of the interaction is defined in\

    $emphend are exhausted (or when the string reaches the length limit).

    `itab'. <br/> `itab' contains n+1 lines, each of n characters.\

   <li><span class="tt">!text insert $emph text1$emphend into $emph text2$emphend

    The first line defines the characters corresponding to each position\

    [mask $emph maskstring$emphend]</span> <br/>

    in the following n lines which defines the multiplication table.\

    Returns $emph text2$emphend with non-masked characters replaced by

    <br/>\

    characters $emph text1$emphend. Characters in $emph text1 $emphend

    The multiplication table needs not to be symmetric. In this case, the rows correspond \

    are used one by one (without taking into account the masking), and

    to characters in `text1', and the columns correspond to characters in `text2'.\

    the replacement stops when there is no character left in

    <br/>\

    $emph text1$emphend.

    If `text1' or `text2' contains a character not in the first line of `itab', \

   <li><span class="tt">!text interact $emph text1$emphend and $emph text2$emphend

    the interaction at the corresponding position is considered as empty. Also, masked\

    table $emph itab$emphend [mask $emph maskstring$emphend]</span> <br/>

    positions are ignored.<br/>\

    Returns a new text which is result of interactions of characters

    If `text1' and `text2' have different lengths, the longer is cut to fit the shorter.\

    in corresponding positions in $emph text1$emphend and

   </li><li><span class="tt">!text mark `charlist' in `text'</span> <br/>\

    $emph text2$emphend. The rule of the interaction is defined in

    Returns a mask string with `1's on positions where the corresponding character in `text' \

    $emph itab$emphend. <br/>

    appears in `charlist', and with `0's on other positions.\

    $emph itab$emphend contains n+1 lines, each of n characters.

   </li><li><span class="tt">!text max `text1' and `text2' [mask `maskstring']</span> <br/>\

    The first line defines the characters corresponding to each position

    Returns a string which at each position is the character with highest\

    in the following n lines which defines the multiplication table.

    ASCII code between corresponding characters in `text1' and `text2'. \

    <br/>

    The length of the result is that of the longest of the two. Masked positions are skipped.\

    The multiplication table needs not to be symmetric. In this case, the

   </li><li><span class="tt">!text min `text1' and `text2' [mask `maskstring']</span> <br/>\

    rows correspond to characters in $emph text1$emphend, and the columns

    Returns a string which at each position is the character with lowest\

    correspond to characters in $emph text2$emphend.

    ASCII code between corresponding characters in `text1' and `text2'. \

    <br/>

    The length of the result is that of the\

    If $emph text1$emphend or $emph text2$emphend contains a character

    shortest of the two. Masked positions are skipped.\

    not in the first line of $emph itab$emphend, the interaction at

   </li><li><span class="tt">!text occur `charlist' in `text' [mask `maskstring']</span> <br/>\

    the corresponding position is considered as empty. Also, masked

    Returns characters in `charlist' which occur in unmasked positions in `text'. <br/>\

    positions are ignored.

    (Synonymes of occur: appear, occurrence).\

    <br/>

   </li><li><span class="tt">!text remove `charlist' in `text' [mask `maskstring']</span> <br/>\

    If $emph text1$emphend and $emph text2$emphend have different

    Returns `text' in which masked characters and characters\

    lengths, the longer is cut to fit the shorter.

    appearing in `charlist' are removed. <br/>(Synonymes of remove: drop, delete).\

   <li><span class="tt">!text mark $emph charlist$emphend in $emph text$emphend

   </li><li><span class="tt">!text reorder `text' by `orderlist'</span> <br/>\

    </span> <br/>

    Returns a reordered `text' using the order list `orderlist'. Reordering is cyclic \

    Returns a mask string with '1's on positions where the

    if `orderlist' is shorter than `text'. <br/>\

    corresponding character in $emph text$emphend appears in

    `orderlist' must be a list of n positive integers, which\

    $emph charlist$emphend, and with '0's on other positions.

    is a permutation of the set {1,...,n}. If `orderlist' contains\

   <li><span class="tt">!text max $emph text1$emphend and $emph text2$emphend

    items other than integers within the bound, empty string is returned.\

    [mask $emph maskstring$emphend]</span> <br/>

    However, unicity check is not performed on items of `orderlist'.\

    Returns a string which at each position is the character with highest

   </li><li><span class="tt">!text repeat `text' to `len'</span> <br/>\

    ASCII code between corresponding characters in $emph text1$emphend

    Repeat the string `text' cyclicly, up to length `len'.\

    and $emph text2$emphend. The length of the result is that of the

   </li><li><span class="tt">!text reverse `text'</span> <br/>\

    longest of the two. Masked positions are skipped.

    Reverse the order of `text', with the last character coming first, etc.\

   <li><span class="tt">!text min $emph text1$emphend and $emph text2$emphend

   </li><li><span class="tt">!text select `charlist' in `text' [mask `maskstring']</span> <br/>\

    [mask $emph maskstring$emphend]</span> <br/>

    Returns `text' in which masked characters and characters not appearing in \

    Returns a string which at each position is the character with lowest

    `charlist' are removed. <br/> (Synonymes of select: pick, pickup).\

    ASCII code between corresponding characters in $emph text1$emphend

  </li></ul>