1 # match.cif

     2 # 

     3 # Copyright (c) 2010 Accenture. All rights reserved.

     4 # This component and the accompanying materials are made available

     5 # under the terms of the "Eclipse Public License v1.0"

     6 # which accompanies this distribution, and is available

     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 # 

     9 # Initial Contributors:

    10 # Accenture - Initial contribution

    11 #

    12 

    13 ==name match

    14 

    15 ==short-description

    16 

    17 Print to C<stdout> any lines of C<stdin> that match a particular pattern.

    18 

    19 ==long-description

    20 

    21 Note, does not support regular expressions, only Symbian's descriptor wild characters (aka C<TDesC::Match()>. Since these don't explicitly support anchoring (functionality provided by C<^> and C<$> in regular expressions) if you want to match an word within a line you need to put C<*> characters at either end of the pattern string. If you don't, then the match will be implicitly anchored to either end of the line.

    22 

    23 ==argument string pattern

    24 

    25 The pattern to be matched. Symbian descriptor wild characters supported.

    26 

    27 ==option bool i ignore-case

    28 

    29 Ignore case distinctions.

    30 

    31 ==option bool v invert-match

    32 

    33 Print lines that do B<not> match.

    34 

    35 ==option bool c count

    36 

    37 Don't print the lines that match, just count them and print the total at the end. If used with C<--invert-match>, counts the number of non-matching lines.

    38 

    39 ==copyright

    40 

    41 Copyright (c) 2006-2010 Accenture. All rights reserved.

    42 

    43 ==see-also

    44 

    45 L<grep|grep>