Subversion Repositories wimsdev

!! +exec+ +var+ +string+

tit:text

type:$type_both

syntax:!text ``operation'' ``parameter''

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

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

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

  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\

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

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

  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\

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

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

  <ul>\

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

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

    to the corresponding characters in ``text2'' and whose\

    positions are not masked by ``maskstring''.\

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

    </span> <br/>\

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

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

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

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

    Returns non-masked characters in ``text''.\

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

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

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

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

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

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

    (Synonyme of diff: differ).\

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

    </span> <br/>\

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    The first line defines the characters corresponding to each position\

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

    <br/>\

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

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

    <br/>\

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

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

    positions are ignored.<br/>\

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

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

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

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

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

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

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

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

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

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

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

    The length of the result is that of the\

    shortest of the two. Masked positions are skipped.\

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

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

    (Synonymes of occur: appear, occurrence).\

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  </li></ul>