1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!--NewPage--> 3<HTML> 4<HEAD> 5<!-- Generated by javadoc (build 1.5.0) on Thu May 15 17:17:33 EDT 2008 --> 6<TITLE> 7UtfOps (Oracle - Berkeley DB Java API) 8</TITLE> 9 10<META NAME="keywords" CONTENT="com.sleepycat.util.UtfOps class"> 11 12<LINK REL ="stylesheet" TYPE="text/css" HREF="/style.css" TITLE="Style"> 13 14<SCRIPT type="text/javascript"> 15function windowTitle() 16{ 17 parent.document.title="UtfOps (Oracle - Berkeley DB Java API)"; 18} 19</SCRIPT> 20<NOSCRIPT> 21</NOSCRIPT> 22 23</HEAD> 24 25<BODY BGCOLOR="white" onload="windowTitle();"> 26 27 28<!-- ========= START OF TOP NAVBAR ======= --> 29<A NAME="navbar_top"><!-- --></A> 30<A HREF="#skip-navbar_top" title="Skip navigation links"></A> 31<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 32<TR> 33<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 34<A NAME="navbar_top_firstrow"><!-- --></A> 35<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 36 <TR ALIGN="center" VALIGN="top"> 37 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 39 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/UtfOps.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 42 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 45 </TR> 46</TABLE> 47</TD> 48<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 49<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 50</TD> 51</TR> 52 53<TR> 54<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 55 <A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util"><B>PREV CLASS</B></A> 56 NEXT CLASS</FONT></TD> 57<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 58 <A HREF="/index.html?com/sleepycat/util/UtfOps.html" target="_top"><B>FRAMES</B></A> 59 <A HREF="UtfOps.html" target="_top"><B>NO FRAMES</B></A> 60 <SCRIPT type="text/javascript"> 61 <!-- 62 if(window==top) { 63 document.writeln('<A HREF="/allclasses-noframe.html"><B>All Classes</B></A>'); 64 } 65 //--> 66</SCRIPT> 67<NOSCRIPT> 68 <A HREF="/allclasses-noframe.html"><B>All Classes</B></A> 69</NOSCRIPT> 70 71 72</FONT></TD> 73</TR> 74<TR> 75<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 76 SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 77<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 78DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 79</TR> 80</TABLE> 81<A NAME="skip-navbar_top"></A> 82<!-- ========= END OF TOP NAVBAR ========= --> 83 84<HR> 85<!-- ======== START OF CLASS DATA ======== --> 86<H2> 87<FONT SIZE="-1"> 88com.sleepycat.util</FONT> 89<BR> 90Class UtfOps</H2> 91<PRE> 92<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A> 93 <IMG SRC="/resources/inherit.gif" ALT="extended by "><B>com.sleepycat.util.UtfOps</B> 94</PRE> 95<HR> 96<DL> 97<DT><PRE>public class <B>UtfOps</B><DT>extends <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></DL> 98</PRE> 99 100<P> 101UTF operations with more flexibility than is provided by DataInput and 102 DataOutput. 103<P> 104 105<P> 106<HR> 107 108<P> 109 110<!-- ======== CONSTRUCTOR SUMMARY ======== --> 111 112<A NAME="constructor_summary"><!-- --></A> 113<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 114<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 115<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 116<B>Constructor Summary</B></FONT></TH> 117</TR> 118<TR BGCOLOR="white" CLASS="TableRowColor"> 119<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#UtfOps()">UtfOps</A></B>()</CODE> 120 121<BR> 122 </TD> 123</TR> 124</TABLE> 125 126<!-- ========== METHOD SUMMARY =========== --> 127 128<A NAME="method_summary"><!-- --></A> 129<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 130<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 131<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 132<B>Method Summary</B></FONT></TH> 133</TR> 134<TR BGCOLOR="white" CLASS="TableRowColor"> 135<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 136<CODE>static int</CODE></FONT></TD> 137<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#bytesToChars(byte[], int, char[], int, int, boolean)">bytesToChars</A></B>(byte[] bytes, 138 int byteOffset, 139 char[] chars, 140 int charOffset, 141 int len, 142 boolean isByteLen)</CODE> 143 144<BR> 145 Converts byte arrays into character arrays.</TD> 146</TR> 147<TR BGCOLOR="white" CLASS="TableRowColor"> 148<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 149<CODE>static <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD> 150<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#bytesToString(byte[], int, int)">bytesToString</A></B>(byte[] bytes, 151 int offset, 152 int length)</CODE> 153 154<BR> 155 Converts byte arrays into strings.</TD> 156</TR> 157<TR BGCOLOR="white" CLASS="TableRowColor"> 158<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 159<CODE>static void</CODE></FONT></TD> 160<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#charsToBytes(char[], int, byte[], int, int)">charsToBytes</A></B>(char[] chars, 161 int charOffset, 162 byte[] bytes, 163 int byteOffset, 164 int charLength)</CODE> 165 166<BR> 167 Converts character arrays into byte arrays.</TD> 168</TR> 169<TR BGCOLOR="white" CLASS="TableRowColor"> 170<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 171<CODE>static int</CODE></FONT></TD> 172<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#getByteLength(char[])">getByteLength</A></B>(char[] chars)</CODE> 173 174<BR> 175 Returns the byte length of the UTF string that would be created by 176 converting the given characters to UTF.</TD> 177</TR> 178<TR BGCOLOR="white" CLASS="TableRowColor"> 179<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 180<CODE>static int</CODE></FONT></TD> 181<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#getByteLength(char[], int, int)">getByteLength</A></B>(char[] chars, 182 int offset, 183 int length)</CODE> 184 185<BR> 186 Returns the byte length of the UTF string that would be created by 187 converting the given characters to UTF.</TD> 188</TR> 189<TR BGCOLOR="white" CLASS="TableRowColor"> 190<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 191<CODE>static int</CODE></FONT></TD> 192<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#getCharLength(byte[])">getCharLength</A></B>(byte[] bytes)</CODE> 193 194<BR> 195 Returns the number of characters represented by the given UTF string.</TD> 196</TR> 197<TR BGCOLOR="white" CLASS="TableRowColor"> 198<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 199<CODE>static int</CODE></FONT></TD> 200<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#getCharLength(byte[], int, int)">getCharLength</A></B>(byte[] bytes, 201 int offset, 202 int length)</CODE> 203 204<BR> 205 Returns the number of characters represented by the given UTF string.</TD> 206</TR> 207<TR BGCOLOR="white" CLASS="TableRowColor"> 208<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 209<CODE>static int</CODE></FONT></TD> 210<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#getZeroTerminatedByteLength(byte[], int)">getZeroTerminatedByteLength</A></B>(byte[] bytes, 211 int offset)</CODE> 212 213<BR> 214 Returns the byte length of a null terminated UTF string, not including 215 the terminator.</TD> 216</TR> 217<TR BGCOLOR="white" CLASS="TableRowColor"> 218<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 219<CODE>static byte[]</CODE></FONT></TD> 220<TD><CODE><B><A HREF="/com/sleepycat/util/UtfOps.html#stringToBytes(java.lang.String)">stringToBytes</A></B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> string)</CODE> 221 222<BR> 223 Converts strings to byte arrays.</TD> 224</TR> 225</TABLE> 226 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> 227<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 228<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 229<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH> 230</TR> 231<TR BGCOLOR="white" CLASS="TableRowColor"> 232<TD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> 233</TR> 234</TABLE> 235 236<P> 237 238<!-- ========= CONSTRUCTOR DETAIL ======== --> 239 240<A NAME="constructor_detail"><!-- --></A> 241<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 242<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 243<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 244<B>Constructor Detail</B></FONT></TH> 245</TR> 246</TABLE> 247 248<A NAME="UtfOps()"><!-- --></A><H3> 249UtfOps</H3> 250<PRE> 251public <B>UtfOps</B>()</PRE> 252<DL> 253</DL> 254 255<!-- ============ METHOD DETAIL ========== --> 256 257<A NAME="method_detail"><!-- --></A> 258<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 259<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 260<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 261<B>Method Detail</B></FONT></TH> 262</TR> 263</TABLE> 264 265<A NAME="getZeroTerminatedByteLength(byte[], int)"><!-- --></A><H3> 266getZeroTerminatedByteLength</H3> 267<PRE> 268public static int <B>getZeroTerminatedByteLength</B>(byte[] bytes, 269 int offset) 270 throws <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE> 271<DL> 272<DD>Returns the byte length of a null terminated UTF string, not including 273 the terminator. 274<P> 275<DD><DL> 276<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - the data containing the UTF string.<DD><CODE>offset</CODE> - the beginning of the string the measure. 277<DT><B>Returns:</B><DD>the number of bytes. 278<DT><B>Throws:</B> 279<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if no zero terminator is found.</DL> 280</DD> 281</DL> 282<HR> 283 284<A NAME="getByteLength(char[])"><!-- --></A><H3> 285getByteLength</H3> 286<PRE> 287public static int <B>getByteLength</B>(char[] chars)</PRE> 288<DL> 289<DD>Returns the byte length of the UTF string that would be created by 290 converting the given characters to UTF. 291<P> 292<DD><DL> 293<DT><B>Parameters:</B><DD><CODE>chars</CODE> - the characters that would be converted. 294<DT><B>Returns:</B><DD>the byte length of the equivalent UTF data.</DL> 295</DD> 296</DL> 297<HR> 298 299<A NAME="getByteLength(char[], int, int)"><!-- --></A><H3> 300getByteLength</H3> 301<PRE> 302public static int <B>getByteLength</B>(char[] chars, 303 int offset, 304 int length)</PRE> 305<DL> 306<DD>Returns the byte length of the UTF string that would be created by 307 converting the given characters to UTF. 308<P> 309<DD><DL> 310<DT><B>Parameters:</B><DD><CODE>chars</CODE> - the characters that would be converted.<DD><CODE>offset</CODE> - the first character to be converted.<DD><CODE>length</CODE> - the number of characters to be converted. 311<DT><B>Returns:</B><DD>the byte length of the equivalent UTF data.</DL> 312</DD> 313</DL> 314<HR> 315 316<A NAME="getCharLength(byte[])"><!-- --></A><H3> 317getCharLength</H3> 318<PRE> 319public static int <B>getCharLength</B>(byte[] bytes) 320 throws <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>, 321 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE> 322<DL> 323<DD>Returns the number of characters represented by the given UTF string. 324<P> 325<DD><DL> 326<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - the UTF string. 327<DT><B>Returns:</B><DD>the number of characters. 328<DT><B>Throws:</B> 329<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if a UTF character sequence at the end 330 of the data is not complete. 331<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an illegal UTF sequence is 332 encountered.</DL> 333</DD> 334</DL> 335<HR> 336 337<A NAME="getCharLength(byte[], int, int)"><!-- --></A><H3> 338getCharLength</H3> 339<PRE> 340public static int <B>getCharLength</B>(byte[] bytes, 341 int offset, 342 int length) 343 throws <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>, 344 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE> 345<DL> 346<DD>Returns the number of characters represented by the given UTF string. 347<P> 348<DD><DL> 349<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - the data containing the UTF string.<DD><CODE>offset</CODE> - the first byte to be converted.<DD><CODE>length</CODE> - the number of byte to be converted. 350<DT><B>Throws:</B> 351<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if a UTF character sequence at the end 352 of the data is not complete. 353<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an illegal UTF sequence is 354 encountered.</DL> 355</DD> 356</DL> 357<HR> 358 359<A NAME="bytesToChars(byte[], int, char[], int, int, boolean)"><!-- --></A><H3> 360bytesToChars</H3> 361<PRE> 362public static int <B>bytesToChars</B>(byte[] bytes, 363 int byteOffset, 364 char[] chars, 365 int charOffset, 366 int len, 367 boolean isByteLen) 368 throws <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>, 369 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE> 370<DL> 371<DD>Converts byte arrays into character arrays. 372<P> 373<DD><DL> 374<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - the source byte data to convert<DD><CODE>byteOffset</CODE> - the offset into the byte array at which 375 to start the conversion<DD><CODE>chars</CODE> - the destination array<DD><CODE>charOffset</CODE> - the offset into chars at which to begin the copy<DD><CODE>len</CODE> - the amount of information to copy into chars<DD><CODE>isByteLen</CODE> - if true then len is a measure of bytes, otherwise 376 len is a measure of characters 377<DT><B>Throws:</B> 378<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if a UTF character sequence at the end 379 of the data is not complete. 380<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an illegal UTF sequence is 381 encountered.</DL> 382</DD> 383</DL> 384<HR> 385 386<A NAME="charsToBytes(char[], int, byte[], int, int)"><!-- --></A><H3> 387charsToBytes</H3> 388<PRE> 389public static void <B>charsToBytes</B>(char[] chars, 390 int charOffset, 391 byte[] bytes, 392 int byteOffset, 393 int charLength)</PRE> 394<DL> 395<DD>Converts character arrays into byte arrays. 396<P> 397<DD><DL> 398<DT><B>Parameters:</B><DD><CODE>chars</CODE> - the source character data to convert<DD><CODE>charOffset</CODE> - the offset into the character array at which 399 to start the conversion<DD><CODE>bytes</CODE> - the destination array<DD><CODE>byteOffset</CODE> - the offset into bytes at which to begin the copy<DD><CODE>charLength</CODE> - the length of characters to copy into bytes</DL> 400</DD> 401</DL> 402<HR> 403 404<A NAME="bytesToString(byte[], int, int)"><!-- --></A><H3> 405bytesToString</H3> 406<PRE> 407public static <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>bytesToString</B>(byte[] bytes, 408 int offset, 409 int length) 410 throws <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>, 411 <A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE> 412<DL> 413<DD>Converts byte arrays into strings. 414<P> 415<DD><DL> 416<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - the source byte data to convert<DD><CODE>offset</CODE> - the offset into the byte array at which 417 to start the conversion<DD><CODE>length</CODE> - the number of bytes to be converted. 418<DT><B>Returns:</B><DD>the string. 419<DT><B>Throws:</B> 420<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if a UTF character sequence at the end 421 of the data is not complete. 422<DD><CODE><A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if an illegal UTF sequence is 423 encountered.</DL> 424</DD> 425</DL> 426<HR> 427 428<A NAME="stringToBytes(java.lang.String)"><!-- --></A><H3> 429stringToBytes</H3> 430<PRE> 431public static byte[] <B>stringToBytes</B>(<A HREF="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> string)</PRE> 432<DL> 433<DD>Converts strings to byte arrays. 434<P> 435<DD><DL> 436<DT><B>Parameters:</B><DD><CODE>string</CODE> - the string to convert. 437<DT><B>Returns:</B><DD>the UTF byte array.</DL> 438</DD> 439</DL> 440<!-- ========= END OF CLASS DATA ========= --> 441<HR> 442 443 444<!-- ======= START OF BOTTOM NAVBAR ====== --> 445<A NAME="navbar_bottom"><!-- --></A> 446<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 447<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 448<TR> 449<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 450<A NAME="navbar_bottom_firstrow"><!-- --></A> 451<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 452 <TR ALIGN="center" VALIGN="top"> 453 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 454 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 455 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 456 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/UtfOps.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 457 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 458 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 459 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 460 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="/help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 461 </TR> 462</TABLE> 463</TD> 464<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 465<b>Berkeley DB</b><br><font size="-1"> version 4.7.25</font></EM> 466</TD> 467</TR> 468 469<TR> 470<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 471 <A HREF="/com/sleepycat/util/RuntimeExceptionWrapper.html" title="class in com.sleepycat.util"><B>PREV CLASS</B></A> 472 NEXT CLASS</FONT></TD> 473<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 474 <A HREF="/index.html?com/sleepycat/util/UtfOps.html" target="_top"><B>FRAMES</B></A> 475 <A HREF="UtfOps.html" target="_top"><B>NO FRAMES</B></A> 476 <SCRIPT type="text/javascript"> 477 <!-- 478 if(window==top) { 479 document.writeln('<A HREF="/allclasses-noframe.html"><B>All Classes</B></A>'); 480 } 481 //--> 482</SCRIPT> 483<NOSCRIPT> 484 <A HREF="/allclasses-noframe.html"><B>All Classes</B></A> 485</NOSCRIPT> 486 487 488</FONT></TD> 489</TR> 490<TR> 491<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 492 SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 493<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 494DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 495</TR> 496</TABLE> 497<A NAME="skip-navbar_bottom"></A> 498<!-- ======== END OF BOTTOM NAVBAR ======= --> 499 500<HR> 501<font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 502</BODY> 503</HTML> 504