pig-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From billgra...@apache.org
Subject svn commit: r1380989 - in /pig/trunk: CHANGES.txt src/docs/src/documentation/content/xdocs/func.xml
Date Wed, 05 Sep 2012 04:54:36 GMT
Author: billgraham
Date: Wed Sep  5 04:54:35 2012
New Revision: 1380989

URL: http://svn.apache.org/viewvc?rev=1380989&view=rev
Log:
PIG-2905: Improve documentation around REPLACE (cheolsoo via billgraham)

Modified:
    pig/trunk/CHANGES.txt
    pig/trunk/src/docs/src/documentation/content/xdocs/func.xml

Modified: pig/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/pig/trunk/CHANGES.txt?rev=1380989&r1=1380988&r2=1380989&view=diff
==============================================================================
--- pig/trunk/CHANGES.txt (original)
+++ pig/trunk/CHANGES.txt Wed Sep  5 04:54:35 2012
@@ -24,6 +24,8 @@ INCOMPATIBLE CHANGES
 
 IMPROVEMENTS
 
+PIG-2905: Improve documentation around REPLACE (cheolsoo via billgraham)
+
 PIG-2882: Use Deque instead of Stack (mkhadikov via dvryaboy)
 
 PIG-2781: LOSort isEqual method (xalan via dvryaboy)

Modified: pig/trunk/src/docs/src/documentation/content/xdocs/func.xml
URL: http://svn.apache.org/viewvc/pig/trunk/src/docs/src/documentation/content/xdocs/func.xml?rev=1380989&r1=1380988&r2=1380989&view=diff
==============================================================================
--- pig/trunk/src/docs/src/documentation/content/xdocs/func.xml (original)
+++ pig/trunk/src/docs/src/documentation/content/xdocs/func.xml Wed Sep  5 04:54:35 2012
@@ -2896,7 +2896,7 @@ REGEX_EXTRACT_ALL('192.168.1.5:8020', '(
    <table>
        <tr>
             <td>
-               <p>REPLACE(string, 'oldChar', 'newChar');</p>
+               <p>REPLACE(string, 'regExp', 'newChar');</p>
             </td>
          </tr>  
    </table>
@@ -2915,10 +2915,10 @@ REGEX_EXTRACT_ALL('192.168.1.5:8020', '(
          </tr> 
                 <tr>
             <td>
-               <p>'oldChar'</p>
+               <p>'regExp'</p>
             </td>
             <td>
-               <p>The existing characters being replaced, in quotes. </p>
+               <p>The regular expression to which the string is to be matched, in quotes.</p>
             </td>
          </tr> 
                 <tr>
@@ -2941,6 +2941,16 @@ Use the REPLACE function to replace exis
 For example, to change "open source software" to "open source wiki" use this statement: 
 REPLACE(string,'software','wiki');
      </p>
+     <p>
+Note that the REPLACE function is internally implemented using
+<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html#replaceAll(java.lang.String,
java.lang.String)">
+java.string.replaceAll(String regex, String replacement)</a>
+where 'regExp' and 'newChar' are passed as the 1st and 2nd argument respectively.
+If you want to replace 
+<a href="http://docs.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html#bs">
+special characters</a> such as '[' in the string literal, it is necessary to escape
them in 'regExp'
+by prefixing them with double backslashes (e.g. '\\[').
+    </p>
 </section>
 </section> 
 



Mime
View raw message