JSONObject.html 91 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!-- NewPage -->
  3. <html lang="en">
  4. <head>
  5. <!-- Generated by javadoc (1.8.0_161) on Thu Aug 16 18:54:13 JST 2018 -->
  6. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <title>JSONObject (twitter4j-core 4.0.7 API)</title>
  8. <meta name="date" content="2018-08-16">
  9. <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
  10. <script type="text/javascript" src="../script.js"></script>
  11. </head>
  12. <body>
  13. <script type="text/javascript"><!--
  14. try {
  15. if (location.href.indexOf('is-external=true') == -1) {
  16. parent.document.title="JSONObject (twitter4j-core 4.0.7 API)";
  17. }
  18. }
  19. catch(err) {
  20. }
  21. //-->
  22. var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":9,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":9,"i37":10,"i38":10,"i39":10,"i40":10,"i41":9};
  23. var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
  24. var altColor = "altColor";
  25. var rowColor = "rowColor";
  26. var tableTab = "tableTab";
  27. var activeTableTab = "activeTableTab";
  28. </script>
  29. <noscript>
  30. <div>JavaScript is disabled on your browser.</div>
  31. </noscript>
  32. <!-- ========= START OF TOP NAVBAR ======= -->
  33. <div class="topNav"><a name="navbar.top">
  34. <!-- -->
  35. </a>
  36. <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
  37. <a name="navbar.top.firstrow">
  38. <!-- -->
  39. </a>
  40. <ul class="navList" title="Navigation">
  41. <li><a href="../overview-summary.html">Overview</a></li>
  42. <li><a href="package-summary.html">Package</a></li>
  43. <li class="navBarCell1Rev">Class</li>
  44. <li><a href="class-use/JSONObject.html">Use</a></li>
  45. <li><a href="package-tree.html">Tree</a></li>
  46. <li><a href="../deprecated-list.html">Deprecated</a></li>
  47. <li><a href="../index-all.html">Index</a></li>
  48. <li><a href="../help-doc.html">Help</a></li>
  49. </ul>
  50. </div>
  51. <div class="subNav">
  52. <ul class="navList">
  53. <li><a href="../twitter4j/JSONException.html" title="class in twitter4j"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  54. <li><a href="../twitter4j/JSONObjectType.html" title="class in twitter4j"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  55. </ul>
  56. <ul class="navList">
  57. <li><a href="../index.html?twitter4j/JSONObject.html" target="_top">Frames</a></li>
  58. <li><a href="JSONObject.html" target="_top">No&nbsp;Frames</a></li>
  59. </ul>
  60. <ul class="navList" id="allclasses_navbar_top">
  61. <li><a href="../allclasses-noframe.html">All&nbsp;Classes</a></li>
  62. </ul>
  63. <div>
  64. <script type="text/javascript"><!--
  65. allClassesLink = document.getElementById("allclasses_navbar_top");
  66. if(window==top) {
  67. allClassesLink.style.display = "block";
  68. }
  69. else {
  70. allClassesLink.style.display = "none";
  71. }
  72. //-->
  73. </script>
  74. </div>
  75. <div>
  76. <ul class="subNavList">
  77. <li>Summary:&nbsp;</li>
  78. <li>Nested&nbsp;|&nbsp;</li>
  79. <li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
  80. <li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
  81. <li><a href="#method.summary">Method</a></li>
  82. </ul>
  83. <ul class="subNavList">
  84. <li>Detail:&nbsp;</li>
  85. <li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
  86. <li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
  87. <li><a href="#method.detail">Method</a></li>
  88. </ul>
  89. </div>
  90. <a name="skip.navbar.top">
  91. <!-- -->
  92. </a></div>
  93. <!-- ========= END OF TOP NAVBAR ========= -->
  94. <!-- ======== START OF CLASS DATA ======== -->
  95. <div class="header">
  96. <div class="subTitle">twitter4j</div>
  97. <h2 title="Class JSONObject" class="title">Class JSONObject</h2>
  98. </div>
  99. <div class="contentContainer">
  100. <ul class="inheritance">
  101. <li><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
  102. <li>
  103. <ul class="inheritance">
  104. <li>twitter4j.JSONObject</li>
  105. </ul>
  106. </li>
  107. </ul>
  108. <div class="description">
  109. <ul class="blockList">
  110. <li class="blockList">
  111. <hr>
  112. <br>
  113. <pre>public class <span class="typeNameLabel">JSONObject</span>
  114. extends <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
  115. <div class="block">A modifiable set of name/value mappings. Names are unique, non-null strings.
  116. Values may be any mix of <a href="../twitter4j/JSONObject.html" title="class in twitter4j"><code>JSONObjects</code></a>, <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArrays</code></a>, Strings, Booleans, Integers, Longs, Doubles or <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>.
  117. Values may not be <code>null</code>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isNaN--" title="class or interface in java.lang"><code>NaNs</code></a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isInfinite--" title="class or interface in java.lang"><code>infinities</code></a>, or of any type not listed here.
  118. <p>This class can coerce values to another type when requested.
  119. <ul>
  120. <li>When the requested type is a boolean, strings will be coerced using a
  121. case-insensitive comparison to "true" and "false".
  122. <li>When the requested type is a double, other <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> types will
  123. be coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true#doubleValue--" title="class or interface in java.lang"><code>doubleValue</code></a>. Strings
  124. that can be coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#valueOf-java.lang.String-" title="class or interface in java.lang"><code>Double.valueOf(String)</code></a> will be.
  125. <li>When the requested type is an int, other <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> types will
  126. be coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true#intValue--" title="class or interface in java.lang"><code>intValue</code></a>. Strings
  127. that can be coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#valueOf-java.lang.String-" title="class or interface in java.lang"><code>Double.valueOf(String)</code></a> will be,
  128. and then cast to int.
  129. <li><a name="lossy">When the requested type is a long, other <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang"><code>Number</code></a> types will
  130. be coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true#longValue--" title="class or interface in java.lang"><code>longValue</code></a>. Strings
  131. that can be coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#valueOf-java.lang.String-" title="class or interface in java.lang"><code>Double.valueOf(String)</code></a> will be,
  132. and then cast to long. This two-step conversion is lossy for very
  133. large values. For example, the string "9223372036854775806" yields the
  134. long 9223372036854775807.</a>
  135. <li>When the requested type is a String, other non-null values will be
  136. coerced using <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true#valueOf-java.lang.Object-" title="class or interface in java.lang"><code>String.valueOf(Object)</code></a>. Although null cannot be
  137. coerced, the sentinel value <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a> is coerced to the
  138. string "null".
  139. </ul>
  140. <p>This class can look up both mandatory and optional values:
  141. <ul>
  142. <li>Use <code>get<i>Type</i>()</code> to retrieve a mandatory value. This
  143. fails with a <code>JSONException</code> if the requested name has no value
  144. or if the value cannot be coerced to the requested type.
  145. <li>Use <code>opt<i>Type</i>()</code> to retrieve an optional value. This
  146. returns a system- or user-supplied default if the requested name has no
  147. value or if the value cannot be coerced to the requested type.
  148. </ul>
  149. <p><strong>Warning:</strong> this class represents null in two incompatible
  150. ways: the standard Java <code>null</code> reference, and the sentinel value <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>. In particular, calling <code>put(name, null)</code> removes the
  151. named entry from the object but <code>put(name, JSONObject.NULL)</code> stores an
  152. entry whose value is <code>JSONObject.NULL</code>.
  153. <p>Instances of this class are not thread safe. Although this class is
  154. nonfinal, it was not designed for inheritance and should not be subclassed.
  155. In particular, self-use by overrideable methods is not specified. See
  156. <i>Effective Java</i> Item 17, "Design and Document or inheritance or else
  157. prohibit it" for further information.</div>
  158. </li>
  159. </ul>
  160. </div>
  161. <div class="summary">
  162. <ul class="blockList">
  163. <li class="blockList">
  164. <!-- =========== FIELD SUMMARY =========== -->
  165. <ul class="blockList">
  166. <li class="blockList"><a name="field.summary">
  167. <!-- -->
  168. </a>
  169. <h3>Field Summary</h3>
  170. <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
  171. <caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
  172. <tr>
  173. <th class="colFirst" scope="col">Modifier and Type</th>
  174. <th class="colLast" scope="col">Field and Description</th>
  175. </tr>
  176. <tr class="altColor">
  177. <td class="colFirst"><code>static <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
  178. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#NULL">NULL</a></span></code>
  179. <div class="block">A sentinel value used to explicitly define a name with no value.</div>
  180. </td>
  181. </tr>
  182. </table>
  183. </li>
  184. </ul>
  185. <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  186. <ul class="blockList">
  187. <li class="blockList"><a name="constructor.summary">
  188. <!-- -->
  189. </a>
  190. <h3>Constructor Summary</h3>
  191. <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
  192. <caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
  193. <tr>
  194. <th class="colOne" scope="col">Constructor and Description</th>
  195. </tr>
  196. <tr class="altColor">
  197. <td class="colOne"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#JSONObject--">JSONObject</a></span>()</code>
  198. <div class="block">Creates a <code>JSONObject</code> with no name/value mappings.</div>
  199. </td>
  200. </tr>
  201. <tr class="rowColor">
  202. <td class="colOne"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#JSONObject-twitter4j.JSONObject-java.lang.String:A-">JSONObject</a></span>(<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;copyFrom,
  203. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]&nbsp;names)</code>
  204. <div class="block">Creates a new <code>JSONObject</code> by copying mappings for the listed names
  205. from the given object.</div>
  206. </td>
  207. </tr>
  208. <tr class="altColor">
  209. <td class="colOne"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#JSONObject-twitter4j.JSONTokener-">JSONObject</a></span>(<a href="../twitter4j/JSONTokener.html" title="class in twitter4j">JSONTokener</a>&nbsp;readFrom)</code>
  210. <div class="block">Creates a new <code>JSONObject</code> with name/value mappings from the next
  211. object in the tokener.</div>
  212. </td>
  213. </tr>
  214. <tr class="rowColor">
  215. <td class="colOne"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#JSONObject-java.util.Map-">JSONObject</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&nbsp;copyFrom)</code>
  216. <div class="block">Creates a new <code>JSONObject</code> by copying all name/value mappings from
  217. the given map.</div>
  218. </td>
  219. </tr>
  220. <tr class="altColor">
  221. <td class="colOne"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#JSONObject-java.lang.String-">JSONObject</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;json)</code>
  222. <div class="block">Creates a new <code>JSONObject</code> with name/value mappings from the JSON
  223. string.</div>
  224. </td>
  225. </tr>
  226. </table>
  227. </li>
  228. </ul>
  229. <!-- ========== METHOD SUMMARY =========== -->
  230. <ul class="blockList">
  231. <li class="blockList"><a name="method.summary">
  232. <!-- -->
  233. </a>
  234. <h3>Method Summary</h3>
  235. <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
  236. <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
  237. <tr>
  238. <th class="colFirst" scope="col">Modifier and Type</th>
  239. <th class="colLast" scope="col">Method and Description</th>
  240. </tr>
  241. <tr id="i0" class="altColor">
  242. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  243. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#accumulate-java.lang.String-java.lang.Object-">accumulate</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  244. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</code>
  245. <div class="block">Appends <code>value</code> to the array already mapped to <code>name</code>.</div>
  246. </td>
  247. </tr>
  248. <tr id="i1" class="rowColor">
  249. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  250. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#append-java.lang.String-java.lang.Object-">append</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  251. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</code>
  252. <div class="block">Appends values to the array mapped to <code>name</code>.</div>
  253. </td>
  254. </tr>
  255. <tr id="i2" class="altColor">
  256. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
  257. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#get-java.lang.String-">get</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  258. <div class="block">Returns the value mapped by <code>name</code>, or throws if no such mapping exists.</div>
  259. </td>
  260. </tr>
  261. <tr id="i3" class="rowColor">
  262. <td class="colFirst"><code>boolean</code></td>
  263. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getBoolean-java.lang.String-">getBoolean</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  264. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a boolean or
  265. can be coerced to a boolean, or throws otherwise.</div>
  266. </td>
  267. </tr>
  268. <tr id="i4" class="altColor">
  269. <td class="colFirst"><code>double</code></td>
  270. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getDouble-java.lang.String-">getDouble</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  271. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a double or
  272. can be coerced to a double, or throws otherwise.</div>
  273. </td>
  274. </tr>
  275. <tr id="i5" class="rowColor">
  276. <td class="colFirst"><code>int</code></td>
  277. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getInt-java.lang.String-">getInt</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  278. <div class="block">Returns the value mapped by <code>name</code> if it exists and is an int or
  279. can be coerced to an int, or throws otherwise.</div>
  280. </td>
  281. </tr>
  282. <tr id="i6" class="altColor">
  283. <td class="colFirst"><code><a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a></code></td>
  284. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getJSONArray-java.lang.String-">getJSONArray</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  285. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONArray</code>, or throws otherwise.</div>
  286. </td>
  287. </tr>
  288. <tr id="i7" class="rowColor">
  289. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  290. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getJSONObject-java.lang.String-">getJSONObject</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  291. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONObject</code>, or throws otherwise.</div>
  292. </td>
  293. </tr>
  294. <tr id="i8" class="altColor">
  295. <td class="colFirst"><code>long</code></td>
  296. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getLong-java.lang.String-">getLong</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  297. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a long or
  298. can be coerced to a long, or throws otherwise.</div>
  299. </td>
  300. </tr>
  301. <tr id="i9" class="rowColor">
  302. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  303. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#getString-java.lang.String-">getString</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  304. <div class="block">Returns the value mapped by <code>name</code> if it exists, coercing it if
  305. necessary, or throws if no such mapping exists.</div>
  306. </td>
  307. </tr>
  308. <tr id="i10" class="altColor">
  309. <td class="colFirst"><code>boolean</code></td>
  310. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#has-java.lang.String-">has</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  311. <div class="block">Returns true if this object has a mapping for <code>name</code>.</div>
  312. </td>
  313. </tr>
  314. <tr id="i11" class="rowColor">
  315. <td class="colFirst"><code>boolean</code></td>
  316. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#isNull-java.lang.String-">isNull</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  317. <div class="block">Returns true if this object has no mapping for <code>name</code> or if it has
  318. a mapping whose value is <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>.</div>
  319. </td>
  320. </tr>
  321. <tr id="i12" class="altColor">
  322. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;</code></td>
  323. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#keys--">keys</a></span>()</code>
  324. <div class="block">Returns an iterator of the <code>String</code> names in this object.</div>
  325. </td>
  326. </tr>
  327. <tr id="i13" class="rowColor">
  328. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;</code></td>
  329. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#keySet--">keySet</a></span>()</code>
  330. <div class="block">Returns the set of <code>String</code> names in this object.</div>
  331. </td>
  332. </tr>
  333. <tr id="i14" class="altColor">
  334. <td class="colFirst"><code>int</code></td>
  335. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#length--">length</a></span>()</code>
  336. <div class="block">Returns the number of name/value mappings in this object.</div>
  337. </td>
  338. </tr>
  339. <tr id="i15" class="rowColor">
  340. <td class="colFirst"><code><a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a></code></td>
  341. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#names--">names</a></span>()</code>
  342. <div class="block">Returns an array containing the string names in this object.</div>
  343. </td>
  344. </tr>
  345. <tr id="i16" class="altColor">
  346. <td class="colFirst"><code>static <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  347. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#numberToString-java.lang.Number-">numberToString</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a>&nbsp;number)</code>
  348. <div class="block">Encodes the number as a JSON string.</div>
  349. </td>
  350. </tr>
  351. <tr id="i17" class="rowColor">
  352. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
  353. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#opt-java.lang.String-">opt</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  354. <div class="block">Returns the value mapped by <code>name</code>, or null if no such mapping
  355. exists.</div>
  356. </td>
  357. </tr>
  358. <tr id="i18" class="altColor">
  359. <td class="colFirst"><code>boolean</code></td>
  360. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optBoolean-java.lang.String-">optBoolean</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  361. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a boolean or
  362. can be coerced to a boolean, or false otherwise.</div>
  363. </td>
  364. </tr>
  365. <tr id="i19" class="rowColor">
  366. <td class="colFirst"><code>boolean</code></td>
  367. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optBoolean-java.lang.String-boolean-">optBoolean</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  368. boolean&nbsp;fallback)</code>
  369. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a boolean or
  370. can be coerced to a boolean, or <code>fallback</code> otherwise.</div>
  371. </td>
  372. </tr>
  373. <tr id="i20" class="altColor">
  374. <td class="colFirst"><code>double</code></td>
  375. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optDouble-java.lang.String-">optDouble</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  376. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a double or
  377. can be coerced to a double, or <code>NaN</code> otherwise.</div>
  378. </td>
  379. </tr>
  380. <tr id="i21" class="rowColor">
  381. <td class="colFirst"><code>double</code></td>
  382. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optDouble-java.lang.String-double-">optDouble</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  383. double&nbsp;fallback)</code>
  384. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a double or
  385. can be coerced to a double, or <code>fallback</code> otherwise.</div>
  386. </td>
  387. </tr>
  388. <tr id="i22" class="altColor">
  389. <td class="colFirst"><code>int</code></td>
  390. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optInt-java.lang.String-">optInt</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  391. <div class="block">Returns the value mapped by <code>name</code> if it exists and is an int or
  392. can be coerced to an int, or 0 otherwise.</div>
  393. </td>
  394. </tr>
  395. <tr id="i23" class="rowColor">
  396. <td class="colFirst"><code>int</code></td>
  397. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optInt-java.lang.String-int-">optInt</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  398. int&nbsp;fallback)</code>
  399. <div class="block">Returns the value mapped by <code>name</code> if it exists and is an int or
  400. can be coerced to an int, or <code>fallback</code> otherwise.</div>
  401. </td>
  402. </tr>
  403. <tr id="i24" class="altColor">
  404. <td class="colFirst"><code><a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a></code></td>
  405. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optJSONArray-java.lang.String-">optJSONArray</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  406. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONArray</code>, or null otherwise.</div>
  407. </td>
  408. </tr>
  409. <tr id="i25" class="rowColor">
  410. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  411. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optJSONObject-java.lang.String-">optJSONObject</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  412. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONObject</code>, or null otherwise.</div>
  413. </td>
  414. </tr>
  415. <tr id="i26" class="altColor">
  416. <td class="colFirst"><code>long</code></td>
  417. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optLong-java.lang.String-">optLong</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  418. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a long or
  419. can be coerced to a long, or 0 otherwise.</div>
  420. </td>
  421. </tr>
  422. <tr id="i27" class="rowColor">
  423. <td class="colFirst"><code>long</code></td>
  424. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optLong-java.lang.String-long-">optLong</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  425. long&nbsp;fallback)</code>
  426. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a long or
  427. can be coerced to a long, or <code>fallback</code> otherwise.</div>
  428. </td>
  429. </tr>
  430. <tr id="i28" class="altColor">
  431. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  432. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optString-java.lang.String-">optString</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  433. <div class="block">Returns the value mapped by <code>name</code> if it exists, coercing it if
  434. necessary, or the empty string if no such mapping exists.</div>
  435. </td>
  436. </tr>
  437. <tr id="i29" class="rowColor">
  438. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  439. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#optString-java.lang.String-java.lang.String-">optString</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  440. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;fallback)</code>
  441. <div class="block">Returns the value mapped by <code>name</code> if it exists, coercing it if
  442. necessary, or <code>fallback</code> if no such mapping exists.</div>
  443. </td>
  444. </tr>
  445. <tr id="i30" class="altColor">
  446. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  447. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#put-java.lang.String-boolean-">put</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  448. boolean&nbsp;value)</code>
  449. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  450. mapping with the same name.</div>
  451. </td>
  452. </tr>
  453. <tr id="i31" class="rowColor">
  454. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  455. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#put-java.lang.String-double-">put</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  456. double&nbsp;value)</code>
  457. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  458. mapping with the same name.</div>
  459. </td>
  460. </tr>
  461. <tr id="i32" class="altColor">
  462. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  463. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#put-java.lang.String-int-">put</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  464. int&nbsp;value)</code>
  465. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  466. mapping with the same name.</div>
  467. </td>
  468. </tr>
  469. <tr id="i33" class="rowColor">
  470. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  471. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#put-java.lang.String-long-">put</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  472. long&nbsp;value)</code>
  473. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  474. mapping with the same name.</div>
  475. </td>
  476. </tr>
  477. <tr id="i34" class="altColor">
  478. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  479. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#put-java.lang.String-java.lang.Object-">put</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  480. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</code>
  481. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  482. mapping with the same name.</div>
  483. </td>
  484. </tr>
  485. <tr id="i35" class="rowColor">
  486. <td class="colFirst"><code><a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a></code></td>
  487. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#putOpt-java.lang.String-java.lang.Object-">putOpt</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  488. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</code>
  489. <div class="block">Equivalent to <code>put(name, value)</code> when both parameters are non-null;
  490. does nothing otherwise.</div>
  491. </td>
  492. </tr>
  493. <tr id="i36" class="altColor">
  494. <td class="colFirst"><code>static <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  495. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#quote-java.lang.String-">quote</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;data)</code>
  496. <div class="block">Encodes <code>data</code> as a JSON string.</div>
  497. </td>
  498. </tr>
  499. <tr id="i37" class="rowColor">
  500. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
  501. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#remove-java.lang.String-">remove</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
  502. <div class="block">Removes the named mapping if it exists; does nothing otherwise.</div>
  503. </td>
  504. </tr>
  505. <tr id="i38" class="altColor">
  506. <td class="colFirst"><code><a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a></code></td>
  507. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#toJSONArray-twitter4j.JSONArray-">toJSONArray</a></span>(<a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a>&nbsp;names)</code>
  508. <div class="block">Returns an array with the values corresponding to <code>names</code>.</div>
  509. </td>
  510. </tr>
  511. <tr id="i39" class="rowColor">
  512. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  513. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#toString--">toString</a></span>()</code>
  514. <div class="block">Encodes this object as a compact JSON string, such as:</div>
  515. </td>
  516. </tr>
  517. <tr id="i40" class="altColor">
  518. <td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
  519. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#toString-int-">toString</a></span>(int&nbsp;indentSpaces)</code>
  520. <div class="block">Encodes this object as a human readable JSON string for debugging, such
  521. as:</div>
  522. </td>
  523. </tr>
  524. <tr id="i41" class="rowColor">
  525. <td class="colFirst"><code>static <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
  526. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/JSONObject.html#wrap-java.lang.Object-">wrap</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;o)</code>
  527. <div class="block">Wraps the given object if necessary.</div>
  528. </td>
  529. </tr>
  530. </table>
  531. <ul class="blockList">
  532. <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
  533. <!-- -->
  534. </a>
  535. <h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
  536. <code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
  537. </ul>
  538. </li>
  539. </ul>
  540. </li>
  541. </ul>
  542. </div>
  543. <div class="details">
  544. <ul class="blockList">
  545. <li class="blockList">
  546. <!-- ============ FIELD DETAIL =========== -->
  547. <ul class="blockList">
  548. <li class="blockList"><a name="field.detail">
  549. <!-- -->
  550. </a>
  551. <h3>Field Detail</h3>
  552. <a name="NULL">
  553. <!-- -->
  554. </a>
  555. <ul class="blockListLast">
  556. <li class="blockList">
  557. <h4>NULL</h4>
  558. <pre>public static final&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> NULL</pre>
  559. <div class="block">A sentinel value used to explicitly define a name with no value. Unlike
  560. <code>null</code>, names with this value:
  561. <ul>
  562. <li>show up in the <a href="../twitter4j/JSONObject.html#names--"><code>names()</code></a> array
  563. <li>show up in the <a href="../twitter4j/JSONObject.html#keys--"><code>keys()</code></a> iterator
  564. <li>return <code>true</code> for <a href="../twitter4j/JSONObject.html#has-java.lang.String-"><code>has(String)</code></a>
  565. <li>do not throw on <a href="../twitter4j/JSONObject.html#get-java.lang.String-"><code>get(String)</code></a>
  566. <li>are included in the encoded JSON string.
  567. </ul>
  568. <p>This value violates the general contract of <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang"><code>Object.equals(java.lang.Object)</code></a> by
  569. returning true when compared to <code>null</code>. Its <a href="../twitter4j/JSONObject.html#toString--"><code>toString()</code></a>
  570. method returns "null".</div>
  571. </li>
  572. </ul>
  573. </li>
  574. </ul>
  575. <!-- ========= CONSTRUCTOR DETAIL ======== -->
  576. <ul class="blockList">
  577. <li class="blockList"><a name="constructor.detail">
  578. <!-- -->
  579. </a>
  580. <h3>Constructor Detail</h3>
  581. <a name="JSONObject--">
  582. <!-- -->
  583. </a>
  584. <ul class="blockList">
  585. <li class="blockList">
  586. <h4>JSONObject</h4>
  587. <pre>public&nbsp;JSONObject()</pre>
  588. <div class="block">Creates a <code>JSONObject</code> with no name/value mappings.</div>
  589. </li>
  590. </ul>
  591. <a name="JSONObject-java.util.Map-">
  592. <!-- -->
  593. </a>
  594. <ul class="blockList">
  595. <li class="blockList">
  596. <h4>JSONObject</h4>
  597. <pre>public&nbsp;JSONObject(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&nbsp;copyFrom)</pre>
  598. <div class="block">Creates a new <code>JSONObject</code> by copying all name/value mappings from
  599. the given map.</div>
  600. <dl>
  601. <dt><span class="paramLabel">Parameters:</span></dt>
  602. <dd><code>copyFrom</code> - a map whose keys are of type <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang"><code>String</code></a> and whose
  603. values are of supported types.</dd>
  604. <dt><span class="throwsLabel">Throws:</span></dt>
  605. <dd><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if any of the map's keys are null.</dd>
  606. </dl>
  607. </li>
  608. </ul>
  609. <a name="JSONObject-twitter4j.JSONTokener-">
  610. <!-- -->
  611. </a>
  612. <ul class="blockList">
  613. <li class="blockList">
  614. <h4>JSONObject</h4>
  615. <pre>public&nbsp;JSONObject(<a href="../twitter4j/JSONTokener.html" title="class in twitter4j">JSONTokener</a>&nbsp;readFrom)
  616. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  617. <div class="block">Creates a new <code>JSONObject</code> with name/value mappings from the next
  618. object in the tokener.</div>
  619. <dl>
  620. <dt><span class="paramLabel">Parameters:</span></dt>
  621. <dd><code>readFrom</code> - a tokener whose nextValue() method will yield a
  622. <code>JSONObject</code>.</dd>
  623. <dt><span class="throwsLabel">Throws:</span></dt>
  624. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the parse fails or doesn't yield a
  625. <code>JSONObject</code>.</dd>
  626. </dl>
  627. </li>
  628. </ul>
  629. <a name="JSONObject-java.lang.String-">
  630. <!-- -->
  631. </a>
  632. <ul class="blockList">
  633. <li class="blockList">
  634. <h4>JSONObject</h4>
  635. <pre>public&nbsp;JSONObject(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;json)
  636. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  637. <div class="block">Creates a new <code>JSONObject</code> with name/value mappings from the JSON
  638. string.</div>
  639. <dl>
  640. <dt><span class="paramLabel">Parameters:</span></dt>
  641. <dd><code>json</code> - a JSON-encoded string containing an object.</dd>
  642. <dt><span class="throwsLabel">Throws:</span></dt>
  643. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the parse fails or doesn't yield a <code>JSONObject</code>.</dd>
  644. </dl>
  645. </li>
  646. </ul>
  647. <a name="JSONObject-twitter4j.JSONObject-java.lang.String:A-">
  648. <!-- -->
  649. </a>
  650. <ul class="blockListLast">
  651. <li class="blockList">
  652. <h4>JSONObject</h4>
  653. <pre>public&nbsp;JSONObject(<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;copyFrom,
  654. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]&nbsp;names)
  655. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  656. <div class="block">Creates a new <code>JSONObject</code> by copying mappings for the listed names
  657. from the given object. Names that aren't present in <code>copyFrom</code> will
  658. be skipped.</div>
  659. <dl>
  660. <dt><span class="paramLabel">Parameters:</span></dt>
  661. <dd><code>copyFrom</code> - The source object.</dd>
  662. <dd><code>names</code> - The names of the fields to copy.</dd>
  663. <dt><span class="throwsLabel">Throws:</span></dt>
  664. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - On internal errors. Shouldn't happen.</dd>
  665. </dl>
  666. </li>
  667. </ul>
  668. </li>
  669. </ul>
  670. <!-- ============ METHOD DETAIL ========== -->
  671. <ul class="blockList">
  672. <li class="blockList"><a name="method.detail">
  673. <!-- -->
  674. </a>
  675. <h3>Method Detail</h3>
  676. <a name="length--">
  677. <!-- -->
  678. </a>
  679. <ul class="blockList">
  680. <li class="blockList">
  681. <h4>length</h4>
  682. <pre>public&nbsp;int&nbsp;length()</pre>
  683. <div class="block">Returns the number of name/value mappings in this object.</div>
  684. <dl>
  685. <dt><span class="returnLabel">Returns:</span></dt>
  686. <dd>the length of this.</dd>
  687. </dl>
  688. </li>
  689. </ul>
  690. <a name="put-java.lang.String-boolean-">
  691. <!-- -->
  692. </a>
  693. <ul class="blockList">
  694. <li class="blockList">
  695. <h4>put</h4>
  696. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;put(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  697. boolean&nbsp;value)
  698. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  699. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  700. mapping with the same name.</div>
  701. <dl>
  702. <dt><span class="paramLabel">Parameters:</span></dt>
  703. <dd><code>name</code> - The name of the value to insert.</dd>
  704. <dd><code>value</code> - The value to insert.</dd>
  705. <dt><span class="returnLabel">Returns:</span></dt>
  706. <dd>this object.</dd>
  707. <dt><span class="throwsLabel">Throws:</span></dt>
  708. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - Should not be possible.</dd>
  709. </dl>
  710. </li>
  711. </ul>
  712. <a name="put-java.lang.String-double-">
  713. <!-- -->
  714. </a>
  715. <ul class="blockList">
  716. <li class="blockList">
  717. <h4>put</h4>
  718. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;put(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  719. double&nbsp;value)
  720. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  721. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  722. mapping with the same name.</div>
  723. <dl>
  724. <dt><span class="paramLabel">Parameters:</span></dt>
  725. <dd><code>name</code> - The name for the new value.</dd>
  726. <dd><code>value</code> - a finite value. May not be <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isNaN--" title="class or interface in java.lang"><code>NaNs</code></a> or
  727. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isInfinite--" title="class or interface in java.lang"><code>infinities</code></a>.</dd>
  728. <dt><span class="returnLabel">Returns:</span></dt>
  729. <dd>this object.</dd>
  730. <dt><span class="throwsLabel">Throws:</span></dt>
  731. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if value is NaN or infinite.</dd>
  732. </dl>
  733. </li>
  734. </ul>
  735. <a name="put-java.lang.String-int-">
  736. <!-- -->
  737. </a>
  738. <ul class="blockList">
  739. <li class="blockList">
  740. <h4>put</h4>
  741. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;put(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  742. int&nbsp;value)
  743. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  744. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  745. mapping with the same name.</div>
  746. <dl>
  747. <dt><span class="paramLabel">Parameters:</span></dt>
  748. <dd><code>name</code> - The name for the new value.</dd>
  749. <dd><code>value</code> - The new value.</dd>
  750. <dt><span class="returnLabel">Returns:</span></dt>
  751. <dd>this object.</dd>
  752. <dt><span class="throwsLabel">Throws:</span></dt>
  753. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - Should not be possible.</dd>
  754. </dl>
  755. </li>
  756. </ul>
  757. <a name="put-java.lang.String-long-">
  758. <!-- -->
  759. </a>
  760. <ul class="blockList">
  761. <li class="blockList">
  762. <h4>put</h4>
  763. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;put(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  764. long&nbsp;value)
  765. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  766. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  767. mapping with the same name.</div>
  768. <dl>
  769. <dt><span class="paramLabel">Parameters:</span></dt>
  770. <dd><code>name</code> - The name of the new value.</dd>
  771. <dd><code>value</code> - The new value to insert.</dd>
  772. <dt><span class="returnLabel">Returns:</span></dt>
  773. <dd>this object.</dd>
  774. <dt><span class="throwsLabel">Throws:</span></dt>
  775. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - Should not be possible.</dd>
  776. </dl>
  777. </li>
  778. </ul>
  779. <a name="put-java.lang.String-java.lang.Object-">
  780. <!-- -->
  781. </a>
  782. <ul class="blockList">
  783. <li class="blockList">
  784. <h4>put</h4>
  785. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;put(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  786. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)
  787. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  788. <div class="block">Maps <code>name</code> to <code>value</code>, clobbering any existing name/value
  789. mapping with the same name. If the value is <code>null</code>, any existing
  790. mapping for <code>name</code> is removed.</div>
  791. <dl>
  792. <dt><span class="paramLabel">Parameters:</span></dt>
  793. <dd><code>name</code> - The name of the new value.</dd>
  794. <dd><code>value</code> - a <a href="../twitter4j/JSONObject.html" title="class in twitter4j"><code>JSONObject</code></a>, <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a>, String, Boolean,
  795. Integer, Long, Double, <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>, or <code>null</code>. May not be
  796. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isNaN--" title="class or interface in java.lang"><code>NaNs</code></a> or <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isInfinite--" title="class or interface in java.lang"><code>infinities</code></a>.</dd>
  797. <dt><span class="returnLabel">Returns:</span></dt>
  798. <dd>this object.</dd>
  799. <dt><span class="throwsLabel">Throws:</span></dt>
  800. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the value is an invalid double (infinite or NaN).</dd>
  801. </dl>
  802. </li>
  803. </ul>
  804. <a name="putOpt-java.lang.String-java.lang.Object-">
  805. <!-- -->
  806. </a>
  807. <ul class="blockList">
  808. <li class="blockList">
  809. <h4>putOpt</h4>
  810. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;putOpt(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  811. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)
  812. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  813. <div class="block">Equivalent to <code>put(name, value)</code> when both parameters are non-null;
  814. does nothing otherwise.</div>
  815. <dl>
  816. <dt><span class="paramLabel">Parameters:</span></dt>
  817. <dd><code>name</code> - The name of the value to insert.</dd>
  818. <dd><code>value</code> - The value to insert.</dd>
  819. <dt><span class="returnLabel">Returns:</span></dt>
  820. <dd>this object.</dd>
  821. <dt><span class="throwsLabel">Throws:</span></dt>
  822. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the value is an invalid double (infinite or NaN).</dd>
  823. </dl>
  824. </li>
  825. </ul>
  826. <a name="accumulate-java.lang.String-java.lang.Object-">
  827. <!-- -->
  828. </a>
  829. <ul class="blockList">
  830. <li class="blockList">
  831. <h4>accumulate</h4>
  832. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;accumulate(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  833. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)
  834. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  835. <div class="block">Appends <code>value</code> to the array already mapped to <code>name</code>. If
  836. this object has no mapping for <code>name</code>, this inserts a new mapping.
  837. If the mapping exists but its value is not an array, the existing
  838. and new values are inserted in order into a new array which is itself
  839. mapped to <code>name</code>. In aggregate, this allows values to be added to a
  840. mapping one at a time.
  841. Note that <code>append(String, Object)</code> provides better semantics.
  842. In particular, the mapping for <code>name</code> will <b>always</b> be a
  843. <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a>. Using <code>accumulate</code> will result in either a
  844. <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a> or a mapping whose type is the type of <code>value</code>
  845. depending on the number of calls to it.</div>
  846. <dl>
  847. <dt><span class="paramLabel">Parameters:</span></dt>
  848. <dd><code>name</code> - The name of the field to change.</dd>
  849. <dd><code>value</code> - a <a href="../twitter4j/JSONObject.html" title="class in twitter4j"><code>JSONObject</code></a>, <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a>, String, Boolean,
  850. Integer, Long, Double, <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a> or null. May not be <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isNaN--" title="class or interface in java.lang"><code>NaNs</code></a> or <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isInfinite--" title="class or interface in java.lang"><code>infinities</code></a>.</dd>
  851. <dt><span class="returnLabel">Returns:</span></dt>
  852. <dd>this object after mutation.</dd>
  853. <dt><span class="throwsLabel">Throws:</span></dt>
  854. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - If the object being added is an invalid number.</dd>
  855. </dl>
  856. </li>
  857. </ul>
  858. <a name="append-java.lang.String-java.lang.Object-">
  859. <!-- -->
  860. </a>
  861. <ul class="blockList">
  862. <li class="blockList">
  863. <h4>append</h4>
  864. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;append(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  865. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)
  866. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  867. <div class="block">Appends values to the array mapped to <code>name</code>. A new <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a>
  868. mapping for <code>name</code> will be inserted if no mapping exists. If the existing
  869. mapping for <code>name</code> is not a <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a>, a <a href="../twitter4j/JSONException.html" title="class in twitter4j"><code>JSONException</code></a>
  870. will be thrown.</div>
  871. <dl>
  872. <dt><span class="paramLabel">Parameters:</span></dt>
  873. <dd><code>name</code> - The name of the array to which the value should be appended.</dd>
  874. <dd><code>value</code> - The value to append.</dd>
  875. <dt><span class="returnLabel">Returns:</span></dt>
  876. <dd>this object.</dd>
  877. <dt><span class="throwsLabel">Throws:</span></dt>
  878. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if <code>name</code> is <code>null</code> or if the mapping for
  879. <code>name</code> is non-null and is not a <a href="../twitter4j/JSONArray.html" title="class in twitter4j"><code>JSONArray</code></a>.</dd>
  880. </dl>
  881. </li>
  882. </ul>
  883. <a name="remove-java.lang.String-">
  884. <!-- -->
  885. </a>
  886. <ul class="blockList">
  887. <li class="blockList">
  888. <h4>remove</h4>
  889. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;remove(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  890. <div class="block">Removes the named mapping if it exists; does nothing otherwise.</div>
  891. <dl>
  892. <dt><span class="paramLabel">Parameters:</span></dt>
  893. <dd><code>name</code> - The name of the mapping to remove.</dd>
  894. <dt><span class="returnLabel">Returns:</span></dt>
  895. <dd>the value previously mapped by <code>name</code>, or null if there was
  896. no such mapping.</dd>
  897. </dl>
  898. </li>
  899. </ul>
  900. <a name="isNull-java.lang.String-">
  901. <!-- -->
  902. </a>
  903. <ul class="blockList">
  904. <li class="blockList">
  905. <h4>isNull</h4>
  906. <pre>public&nbsp;boolean&nbsp;isNull(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  907. <div class="block">Returns true if this object has no mapping for <code>name</code> or if it has
  908. a mapping whose value is <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>.</div>
  909. <dl>
  910. <dt><span class="paramLabel">Parameters:</span></dt>
  911. <dd><code>name</code> - The name of the value to check on.</dd>
  912. <dt><span class="returnLabel">Returns:</span></dt>
  913. <dd>true if the field doesn't exist or is null.</dd>
  914. </dl>
  915. </li>
  916. </ul>
  917. <a name="has-java.lang.String-">
  918. <!-- -->
  919. </a>
  920. <ul class="blockList">
  921. <li class="blockList">
  922. <h4>has</h4>
  923. <pre>public&nbsp;boolean&nbsp;has(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  924. <div class="block">Returns true if this object has a mapping for <code>name</code>. The mapping
  925. may be <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>.</div>
  926. <dl>
  927. <dt><span class="paramLabel">Parameters:</span></dt>
  928. <dd><code>name</code> - The name of the value to check on.</dd>
  929. <dt><span class="returnLabel">Returns:</span></dt>
  930. <dd>true if this object has a field named <code>name</code></dd>
  931. </dl>
  932. </li>
  933. </ul>
  934. <a name="get-java.lang.String-">
  935. <!-- -->
  936. </a>
  937. <ul class="blockList">
  938. <li class="blockList">
  939. <h4>get</h4>
  940. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;get(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  941. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  942. <div class="block">Returns the value mapped by <code>name</code>, or throws if no such mapping exists.</div>
  943. <dl>
  944. <dt><span class="paramLabel">Parameters:</span></dt>
  945. <dd><code>name</code> - The name of the value to get.</dd>
  946. <dt><span class="returnLabel">Returns:</span></dt>
  947. <dd>The value.</dd>
  948. <dt><span class="throwsLabel">Throws:</span></dt>
  949. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if no such mapping exists.</dd>
  950. </dl>
  951. </li>
  952. </ul>
  953. <a name="opt-java.lang.String-">
  954. <!-- -->
  955. </a>
  956. <ul class="blockList">
  957. <li class="blockList">
  958. <h4>opt</h4>
  959. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;opt(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  960. <div class="block">Returns the value mapped by <code>name</code>, or null if no such mapping
  961. exists.</div>
  962. <dl>
  963. <dt><span class="paramLabel">Parameters:</span></dt>
  964. <dd><code>name</code> - The name of the value to get.</dd>
  965. <dt><span class="returnLabel">Returns:</span></dt>
  966. <dd>The value.</dd>
  967. </dl>
  968. </li>
  969. </ul>
  970. <a name="getBoolean-java.lang.String-">
  971. <!-- -->
  972. </a>
  973. <ul class="blockList">
  974. <li class="blockList">
  975. <h4>getBoolean</h4>
  976. <pre>public&nbsp;boolean&nbsp;getBoolean(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  977. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  978. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a boolean or
  979. can be coerced to a boolean, or throws otherwise.</div>
  980. <dl>
  981. <dt><span class="paramLabel">Parameters:</span></dt>
  982. <dd><code>name</code> - The name of the field we want.</dd>
  983. <dt><span class="returnLabel">Returns:</span></dt>
  984. <dd>The selected value if it exists.</dd>
  985. <dt><span class="throwsLabel">Throws:</span></dt>
  986. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the mapping doesn't exist or cannot be coerced
  987. to a boolean.</dd>
  988. </dl>
  989. </li>
  990. </ul>
  991. <a name="optBoolean-java.lang.String-">
  992. <!-- -->
  993. </a>
  994. <ul class="blockList">
  995. <li class="blockList">
  996. <h4>optBoolean</h4>
  997. <pre>public&nbsp;boolean&nbsp;optBoolean(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  998. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a boolean or
  999. can be coerced to a boolean, or false otherwise.</div>
  1000. <dl>
  1001. <dt><span class="paramLabel">Parameters:</span></dt>
  1002. <dd><code>name</code> - The name of the field we want.</dd>
  1003. <dt><span class="returnLabel">Returns:</span></dt>
  1004. <dd>The selected value if it exists.</dd>
  1005. </dl>
  1006. </li>
  1007. </ul>
  1008. <a name="optBoolean-java.lang.String-boolean-">
  1009. <!-- -->
  1010. </a>
  1011. <ul class="blockList">
  1012. <li class="blockList">
  1013. <h4>optBoolean</h4>
  1014. <pre>public&nbsp;boolean&nbsp;optBoolean(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  1015. boolean&nbsp;fallback)</pre>
  1016. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a boolean or
  1017. can be coerced to a boolean, or <code>fallback</code> otherwise.</div>
  1018. <dl>
  1019. <dt><span class="paramLabel">Parameters:</span></dt>
  1020. <dd><code>name</code> - The name of the field we want.</dd>
  1021. <dd><code>fallback</code> - The value to return if the field isn't there.</dd>
  1022. <dt><span class="returnLabel">Returns:</span></dt>
  1023. <dd>The selected value or the fallback.</dd>
  1024. </dl>
  1025. </li>
  1026. </ul>
  1027. <a name="getDouble-java.lang.String-">
  1028. <!-- -->
  1029. </a>
  1030. <ul class="blockList">
  1031. <li class="blockList">
  1032. <h4>getDouble</h4>
  1033. <pre>public&nbsp;double&nbsp;getDouble(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  1034. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1035. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a double or
  1036. can be coerced to a double, or throws otherwise.</div>
  1037. <dl>
  1038. <dt><span class="paramLabel">Parameters:</span></dt>
  1039. <dd><code>name</code> - The name of the field we want.</dd>
  1040. <dt><span class="returnLabel">Returns:</span></dt>
  1041. <dd>The selected value if it exists.</dd>
  1042. <dt><span class="throwsLabel">Throws:</span></dt>
  1043. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the mapping doesn't exist or cannot be coerced
  1044. to a double.</dd>
  1045. </dl>
  1046. </li>
  1047. </ul>
  1048. <a name="optDouble-java.lang.String-">
  1049. <!-- -->
  1050. </a>
  1051. <ul class="blockList">
  1052. <li class="blockList">
  1053. <h4>optDouble</h4>
  1054. <pre>public&nbsp;double&nbsp;optDouble(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  1055. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a double or
  1056. can be coerced to a double, or <code>NaN</code> otherwise.</div>
  1057. <dl>
  1058. <dt><span class="paramLabel">Parameters:</span></dt>
  1059. <dd><code>name</code> - The name of the field we want.</dd>
  1060. <dt><span class="returnLabel">Returns:</span></dt>
  1061. <dd>The selected value if it exists.</dd>
  1062. </dl>
  1063. </li>
  1064. </ul>
  1065. <a name="optDouble-java.lang.String-double-">
  1066. <!-- -->
  1067. </a>
  1068. <ul class="blockList">
  1069. <li class="blockList">
  1070. <h4>optDouble</h4>
  1071. <pre>public&nbsp;double&nbsp;optDouble(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  1072. double&nbsp;fallback)</pre>
  1073. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a double or
  1074. can be coerced to a double, or <code>fallback</code> otherwise.</div>
  1075. <dl>
  1076. <dt><span class="paramLabel">Parameters:</span></dt>
  1077. <dd><code>name</code> - The name of the field we want.</dd>
  1078. <dd><code>fallback</code> - The value to return if the field isn't there.</dd>
  1079. <dt><span class="returnLabel">Returns:</span></dt>
  1080. <dd>The selected value or the fallback.</dd>
  1081. </dl>
  1082. </li>
  1083. </ul>
  1084. <a name="getInt-java.lang.String-">
  1085. <!-- -->
  1086. </a>
  1087. <ul class="blockList">
  1088. <li class="blockList">
  1089. <h4>getInt</h4>
  1090. <pre>public&nbsp;int&nbsp;getInt(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  1091. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1092. <div class="block">Returns the value mapped by <code>name</code> if it exists and is an int or
  1093. can be coerced to an int, or throws otherwise.</div>
  1094. <dl>
  1095. <dt><span class="paramLabel">Parameters:</span></dt>
  1096. <dd><code>name</code> - The name of the field we want.</dd>
  1097. <dt><span class="returnLabel">Returns:</span></dt>
  1098. <dd>The selected value if it exists.</dd>
  1099. <dt><span class="throwsLabel">Throws:</span></dt>
  1100. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the mapping doesn't exist or cannot be coerced
  1101. to an int.</dd>
  1102. </dl>
  1103. </li>
  1104. </ul>
  1105. <a name="optInt-java.lang.String-">
  1106. <!-- -->
  1107. </a>
  1108. <ul class="blockList">
  1109. <li class="blockList">
  1110. <h4>optInt</h4>
  1111. <pre>public&nbsp;int&nbsp;optInt(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  1112. <div class="block">Returns the value mapped by <code>name</code> if it exists and is an int or
  1113. can be coerced to an int, or 0 otherwise.</div>
  1114. <dl>
  1115. <dt><span class="paramLabel">Parameters:</span></dt>
  1116. <dd><code>name</code> - The name of the field we want.</dd>
  1117. <dt><span class="returnLabel">Returns:</span></dt>
  1118. <dd>The selected value if it exists.</dd>
  1119. </dl>
  1120. </li>
  1121. </ul>
  1122. <a name="optInt-java.lang.String-int-">
  1123. <!-- -->
  1124. </a>
  1125. <ul class="blockList">
  1126. <li class="blockList">
  1127. <h4>optInt</h4>
  1128. <pre>public&nbsp;int&nbsp;optInt(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  1129. int&nbsp;fallback)</pre>
  1130. <div class="block">Returns the value mapped by <code>name</code> if it exists and is an int or
  1131. can be coerced to an int, or <code>fallback</code> otherwise.</div>
  1132. <dl>
  1133. <dt><span class="paramLabel">Parameters:</span></dt>
  1134. <dd><code>name</code> - The name of the field we want.</dd>
  1135. <dd><code>fallback</code> - The value to return if the field isn't there.</dd>
  1136. <dt><span class="returnLabel">Returns:</span></dt>
  1137. <dd>The selected value or the fallback.</dd>
  1138. </dl>
  1139. </li>
  1140. </ul>
  1141. <a name="getLong-java.lang.String-">
  1142. <!-- -->
  1143. </a>
  1144. <ul class="blockList">
  1145. <li class="blockList">
  1146. <h4>getLong</h4>
  1147. <pre>public&nbsp;long&nbsp;getLong(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  1148. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1149. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a long or
  1150. can be coerced to a long, or throws otherwise.
  1151. Note that JSON represents numbers as doubles,
  1152. so this is <a href="#lossy">lossy</a>; use strings to transfer numbers
  1153. via JSON without loss.</div>
  1154. <dl>
  1155. <dt><span class="paramLabel">Parameters:</span></dt>
  1156. <dd><code>name</code> - The name of the field that we want.</dd>
  1157. <dt><span class="returnLabel">Returns:</span></dt>
  1158. <dd>The value of the field.</dd>
  1159. <dt><span class="throwsLabel">Throws:</span></dt>
  1160. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the mapping doesn't exist or cannot be coerced
  1161. to a long.</dd>
  1162. </dl>
  1163. </li>
  1164. </ul>
  1165. <a name="optLong-java.lang.String-">
  1166. <!-- -->
  1167. </a>
  1168. <ul class="blockList">
  1169. <li class="blockList">
  1170. <h4>optLong</h4>
  1171. <pre>public&nbsp;long&nbsp;optLong(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  1172. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a long or
  1173. can be coerced to a long, or 0 otherwise. Note that JSON represents numbers as doubles,
  1174. so this is <a href="#lossy">lossy</a>; use strings to transfer numbers via JSON.</div>
  1175. <dl>
  1176. <dt><span class="paramLabel">Parameters:</span></dt>
  1177. <dd><code>name</code> - The name of the field we want.</dd>
  1178. <dt><span class="returnLabel">Returns:</span></dt>
  1179. <dd>The selected value.</dd>
  1180. </dl>
  1181. </li>
  1182. </ul>
  1183. <a name="optLong-java.lang.String-long-">
  1184. <!-- -->
  1185. </a>
  1186. <ul class="blockList">
  1187. <li class="blockList">
  1188. <h4>optLong</h4>
  1189. <pre>public&nbsp;long&nbsp;optLong(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  1190. long&nbsp;fallback)</pre>
  1191. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a long or
  1192. can be coerced to a long, or <code>fallback</code> otherwise. Note that JSON represents
  1193. numbers as doubles, so this is <a href="#lossy">lossy</a>; use strings to transfer
  1194. numbers via JSON.</div>
  1195. <dl>
  1196. <dt><span class="paramLabel">Parameters:</span></dt>
  1197. <dd><code>name</code> - The name of the field we want.</dd>
  1198. <dd><code>fallback</code> - The value to return if the field isn't there.</dd>
  1199. <dt><span class="returnLabel">Returns:</span></dt>
  1200. <dd>The selected value or the fallback.</dd>
  1201. </dl>
  1202. </li>
  1203. </ul>
  1204. <a name="getString-java.lang.String-">
  1205. <!-- -->
  1206. </a>
  1207. <ul class="blockList">
  1208. <li class="blockList">
  1209. <h4>getString</h4>
  1210. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;getString(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  1211. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1212. <div class="block">Returns the value mapped by <code>name</code> if it exists, coercing it if
  1213. necessary, or throws if no such mapping exists.</div>
  1214. <dl>
  1215. <dt><span class="paramLabel">Parameters:</span></dt>
  1216. <dd><code>name</code> - The name of the field we want.</dd>
  1217. <dt><span class="returnLabel">Returns:</span></dt>
  1218. <dd>The value of the field.</dd>
  1219. <dt><span class="throwsLabel">Throws:</span></dt>
  1220. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if no such mapping exists.</dd>
  1221. </dl>
  1222. </li>
  1223. </ul>
  1224. <a name="optString-java.lang.String-">
  1225. <!-- -->
  1226. </a>
  1227. <ul class="blockList">
  1228. <li class="blockList">
  1229. <h4>optString</h4>
  1230. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;optString(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  1231. <div class="block">Returns the value mapped by <code>name</code> if it exists, coercing it if
  1232. necessary, or the empty string if no such mapping exists.</div>
  1233. <dl>
  1234. <dt><span class="paramLabel">Parameters:</span></dt>
  1235. <dd><code>name</code> - The name of the field we want.</dd>
  1236. <dt><span class="returnLabel">Returns:</span></dt>
  1237. <dd>The value of the field.</dd>
  1238. </dl>
  1239. </li>
  1240. </ul>
  1241. <a name="optString-java.lang.String-java.lang.String-">
  1242. <!-- -->
  1243. </a>
  1244. <ul class="blockList">
  1245. <li class="blockList">
  1246. <h4>optString</h4>
  1247. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;optString(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name,
  1248. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;fallback)</pre>
  1249. <div class="block">Returns the value mapped by <code>name</code> if it exists, coercing it if
  1250. necessary, or <code>fallback</code> if no such mapping exists.</div>
  1251. <dl>
  1252. <dt><span class="paramLabel">Parameters:</span></dt>
  1253. <dd><code>name</code> - The name of the field that we want.</dd>
  1254. <dd><code>fallback</code> - The value to return if the field doesn't exist.</dd>
  1255. <dt><span class="returnLabel">Returns:</span></dt>
  1256. <dd>The value of the field or fallback.</dd>
  1257. </dl>
  1258. </li>
  1259. </ul>
  1260. <a name="getJSONArray-java.lang.String-">
  1261. <!-- -->
  1262. </a>
  1263. <ul class="blockList">
  1264. <li class="blockList">
  1265. <h4>getJSONArray</h4>
  1266. <pre>public&nbsp;<a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a>&nbsp;getJSONArray(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  1267. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1268. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONArray</code>, or throws otherwise.</div>
  1269. <dl>
  1270. <dt><span class="paramLabel">Parameters:</span></dt>
  1271. <dd><code>name</code> - The field we want to get.</dd>
  1272. <dt><span class="returnLabel">Returns:</span></dt>
  1273. <dd>The value of the field (if it is a JSONArray.</dd>
  1274. <dt><span class="throwsLabel">Throws:</span></dt>
  1275. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the mapping doesn't exist or is not a <code>JSONArray</code>.</dd>
  1276. </dl>
  1277. </li>
  1278. </ul>
  1279. <a name="optJSONArray-java.lang.String-">
  1280. <!-- -->
  1281. </a>
  1282. <ul class="blockList">
  1283. <li class="blockList">
  1284. <h4>optJSONArray</h4>
  1285. <pre>public&nbsp;<a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a>&nbsp;optJSONArray(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  1286. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONArray</code>, or null otherwise.</div>
  1287. <dl>
  1288. <dt><span class="paramLabel">Parameters:</span></dt>
  1289. <dd><code>name</code> - The name of the field we want.</dd>
  1290. <dt><span class="returnLabel">Returns:</span></dt>
  1291. <dd>The value of the specified field (assuming it is a JSNOArray</dd>
  1292. </dl>
  1293. </li>
  1294. </ul>
  1295. <a name="getJSONObject-java.lang.String-">
  1296. <!-- -->
  1297. </a>
  1298. <ul class="blockList">
  1299. <li class="blockList">
  1300. <h4>getJSONObject</h4>
  1301. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;getJSONObject(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)
  1302. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1303. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONObject</code>, or throws otherwise.</div>
  1304. <dl>
  1305. <dt><span class="paramLabel">Parameters:</span></dt>
  1306. <dd><code>name</code> - The name of the field that we want.</dd>
  1307. <dt><span class="returnLabel">Returns:</span></dt>
  1308. <dd>a specified field value (if it is a JSONObject)</dd>
  1309. <dt><span class="throwsLabel">Throws:</span></dt>
  1310. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - if the mapping doesn't exist or is not a <code>JSONObject</code>.</dd>
  1311. </dl>
  1312. </li>
  1313. </ul>
  1314. <a name="optJSONObject-java.lang.String-">
  1315. <!-- -->
  1316. </a>
  1317. <ul class="blockList">
  1318. <li class="blockList">
  1319. <h4>optJSONObject</h4>
  1320. <pre>public&nbsp;<a href="../twitter4j/JSONObject.html" title="class in twitter4j">JSONObject</a>&nbsp;optJSONObject(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
  1321. <div class="block">Returns the value mapped by <code>name</code> if it exists and is a <code>JSONObject</code>, or null otherwise.</div>
  1322. <dl>
  1323. <dt><span class="paramLabel">Parameters:</span></dt>
  1324. <dd><code>name</code> - The name of the value we want.</dd>
  1325. <dt><span class="returnLabel">Returns:</span></dt>
  1326. <dd>The specified value.</dd>
  1327. </dl>
  1328. </li>
  1329. </ul>
  1330. <a name="toJSONArray-twitter4j.JSONArray-">
  1331. <!-- -->
  1332. </a>
  1333. <ul class="blockList">
  1334. <li class="blockList">
  1335. <h4>toJSONArray</h4>
  1336. <pre>public&nbsp;<a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a>&nbsp;toJSONArray(<a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a>&nbsp;names)
  1337. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1338. <div class="block">Returns an array with the values corresponding to <code>names</code>. The
  1339. array contains null for names that aren't mapped. This method returns
  1340. null if <code>names</code> is either null or empty.</div>
  1341. <dl>
  1342. <dt><span class="paramLabel">Parameters:</span></dt>
  1343. <dd><code>names</code> - The names of the fields that we want the values for.</dd>
  1344. <dt><span class="returnLabel">Returns:</span></dt>
  1345. <dd>The selected values.</dd>
  1346. <dt><span class="throwsLabel">Throws:</span></dt>
  1347. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - On internal errors. Shouldn't happen.</dd>
  1348. </dl>
  1349. </li>
  1350. </ul>
  1351. <a name="keys--">
  1352. <!-- -->
  1353. </a>
  1354. <ul class="blockList">
  1355. <li class="blockList">
  1356. <h4>keys</h4>
  1357. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;keys()</pre>
  1358. <div class="block">Returns an iterator of the <code>String</code> names in this object. The
  1359. returned iterator supports <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html?is-external=true#remove--" title="class or interface in java.util"><code>remove</code></a>, which will
  1360. remove the corresponding mapping from this object. If this object is
  1361. modified after the iterator is returned, the iterator's behavior is
  1362. undefined. The order of the keys is undefined.</div>
  1363. <dl>
  1364. <dt><span class="returnLabel">Returns:</span></dt>
  1365. <dd>an iterator over the keys.</dd>
  1366. </dl>
  1367. </li>
  1368. </ul>
  1369. <a name="keySet--">
  1370. <!-- -->
  1371. </a>
  1372. <ul class="blockList">
  1373. <li class="blockList">
  1374. <h4>keySet</h4>
  1375. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;keySet()</pre>
  1376. <div class="block">Returns the set of <code>String</code> names in this object. The returned set
  1377. is a view of the keys in this object. <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true#remove-java.lang.Object-" title="class or interface in java.util"><code>Set.remove(Object)</code></a> will remove
  1378. the corresponding mapping from this object and set iterator behaviour
  1379. is undefined if this object is modified after it is returned.
  1380. See <a href="../twitter4j/JSONObject.html#keys--"><code>keys()</code></a>.</div>
  1381. <dl>
  1382. <dt><span class="returnLabel">Returns:</span></dt>
  1383. <dd>The names in this object.</dd>
  1384. </dl>
  1385. </li>
  1386. </ul>
  1387. <a name="names--">
  1388. <!-- -->
  1389. </a>
  1390. <ul class="blockList">
  1391. <li class="blockList">
  1392. <h4>names</h4>
  1393. <pre>public&nbsp;<a href="../twitter4j/JSONArray.html" title="class in twitter4j">JSONArray</a>&nbsp;names()</pre>
  1394. <div class="block">Returns an array containing the string names in this object. This method
  1395. returns null if this object contains no mappings.</div>
  1396. <dl>
  1397. <dt><span class="returnLabel">Returns:</span></dt>
  1398. <dd>the names.</dd>
  1399. </dl>
  1400. </li>
  1401. </ul>
  1402. <a name="toString--">
  1403. <!-- -->
  1404. </a>
  1405. <ul class="blockList">
  1406. <li class="blockList">
  1407. <h4>toString</h4>
  1408. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;toString()</pre>
  1409. <div class="block">Encodes this object as a compact JSON string, such as:
  1410. <pre>{"query":"Pizza","locations":[94043,90210]}</pre></div>
  1411. <dl>
  1412. <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
  1413. <dd><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
  1414. </dl>
  1415. </li>
  1416. </ul>
  1417. <a name="toString-int-">
  1418. <!-- -->
  1419. </a>
  1420. <ul class="blockList">
  1421. <li class="blockList">
  1422. <h4>toString</h4>
  1423. <pre>public&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;toString(int&nbsp;indentSpaces)
  1424. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1425. <div class="block">Encodes this object as a human readable JSON string for debugging, such
  1426. as:
  1427. <pre>
  1428. {
  1429. "query": "Pizza",
  1430. "locations": [
  1431. 94043,
  1432. 90210
  1433. ]
  1434. }</pre></div>
  1435. <dl>
  1436. <dt><span class="paramLabel">Parameters:</span></dt>
  1437. <dd><code>indentSpaces</code> - the number of spaces to indent for each level of
  1438. nesting.</dd>
  1439. <dt><span class="returnLabel">Returns:</span></dt>
  1440. <dd>The string containing the pretty form of this.</dd>
  1441. <dt><span class="throwsLabel">Throws:</span></dt>
  1442. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - On internal errors. Shouldn't happen.</dd>
  1443. </dl>
  1444. </li>
  1445. </ul>
  1446. <a name="numberToString-java.lang.Number-">
  1447. <!-- -->
  1448. </a>
  1449. <ul class="blockList">
  1450. <li class="blockList">
  1451. <h4>numberToString</h4>
  1452. <pre>public static&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;numberToString(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a>&nbsp;number)
  1453. throws <a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></pre>
  1454. <div class="block">Encodes the number as a JSON string.</div>
  1455. <dl>
  1456. <dt><span class="paramLabel">Parameters:</span></dt>
  1457. <dd><code>number</code> - a finite value. May not be <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isNaN--" title="class or interface in java.lang"><code>NaNs</code></a> or
  1458. <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true#isInfinite--" title="class or interface in java.lang"><code>infinities</code></a>.</dd>
  1459. <dt><span class="returnLabel">Returns:</span></dt>
  1460. <dd>The encoded number in string form.</dd>
  1461. <dt><span class="throwsLabel">Throws:</span></dt>
  1462. <dd><code><a href="../twitter4j/JSONException.html" title="class in twitter4j">JSONException</a></code> - On internal errors. Shouldn't happen.</dd>
  1463. </dl>
  1464. </li>
  1465. </ul>
  1466. <a name="quote-java.lang.String-">
  1467. <!-- -->
  1468. </a>
  1469. <ul class="blockList">
  1470. <li class="blockList">
  1471. <h4>quote</h4>
  1472. <pre>public static&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;quote(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;data)</pre>
  1473. <div class="block">Encodes <code>data</code> as a JSON string. This applies quotes and any
  1474. necessary character escaping.</div>
  1475. <dl>
  1476. <dt><span class="paramLabel">Parameters:</span></dt>
  1477. <dd><code>data</code> - the string to encode. Null will be interpreted as an empty
  1478. string.</dd>
  1479. <dt><span class="returnLabel">Returns:</span></dt>
  1480. <dd>the quoted string.</dd>
  1481. </dl>
  1482. </li>
  1483. </ul>
  1484. <a name="wrap-java.lang.Object-">
  1485. <!-- -->
  1486. </a>
  1487. <ul class="blockListLast">
  1488. <li class="blockList">
  1489. <h4>wrap</h4>
  1490. <pre>public static&nbsp;<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;wrap(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;o)</pre>
  1491. <div class="block">Wraps the given object if necessary.
  1492. <p>If the object is null or , returns <a href="../twitter4j/JSONObject.html#NULL"><code>NULL</code></a>.
  1493. If the object is a <code>JSONArray</code> or <code>JSONObject</code>, no wrapping is necessary.
  1494. If the object is <code>NULL</code>, no wrapping is necessary.
  1495. If the object is an array or <code>Collection</code>, returns an equivalent <code>JSONArray</code>.
  1496. If the object is a <code>Map</code>, returns an equivalent <code>JSONObject</code>.
  1497. If the object is a primitive wrapper type or <code>String</code>, returns the object.
  1498. Otherwise if the object is from a <code>java</code> package, returns the result of <code>toString</code>.
  1499. If wrapping fails, returns null.</div>
  1500. <dl>
  1501. <dt><span class="paramLabel">Parameters:</span></dt>
  1502. <dd><code>o</code> - The object to wrap.</dd>
  1503. <dt><span class="returnLabel">Returns:</span></dt>
  1504. <dd>The wrapped (if necessary) form of the object {$code o}</dd>
  1505. </dl>
  1506. </li>
  1507. </ul>
  1508. </li>
  1509. </ul>
  1510. </li>
  1511. </ul>
  1512. </div>
  1513. </div>
  1514. <!-- ========= END OF CLASS DATA ========= -->
  1515. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  1516. <div class="bottomNav"><a name="navbar.bottom">
  1517. <!-- -->
  1518. </a>
  1519. <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
  1520. <a name="navbar.bottom.firstrow">
  1521. <!-- -->
  1522. </a>
  1523. <ul class="navList" title="Navigation">
  1524. <li><a href="../overview-summary.html">Overview</a></li>
  1525. <li><a href="package-summary.html">Package</a></li>
  1526. <li class="navBarCell1Rev">Class</li>
  1527. <li><a href="class-use/JSONObject.html">Use</a></li>
  1528. <li><a href="package-tree.html">Tree</a></li>
  1529. <li><a href="../deprecated-list.html">Deprecated</a></li>
  1530. <li><a href="../index-all.html">Index</a></li>
  1531. <li><a href="../help-doc.html">Help</a></li>
  1532. </ul>
  1533. </div>
  1534. <div class="subNav">
  1535. <ul class="navList">
  1536. <li><a href="../twitter4j/JSONException.html" title="class in twitter4j"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  1537. <li><a href="../twitter4j/JSONObjectType.html" title="class in twitter4j"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  1538. </ul>
  1539. <ul class="navList">
  1540. <li><a href="../index.html?twitter4j/JSONObject.html" target="_top">Frames</a></li>
  1541. <li><a href="JSONObject.html" target="_top">No&nbsp;Frames</a></li>
  1542. </ul>
  1543. <ul class="navList" id="allclasses_navbar_bottom">
  1544. <li><a href="../allclasses-noframe.html">All&nbsp;Classes</a></li>
  1545. </ul>
  1546. <div>
  1547. <script type="text/javascript"><!--
  1548. allClassesLink = document.getElementById("allclasses_navbar_bottom");
  1549. if(window==top) {
  1550. allClassesLink.style.display = "block";
  1551. }
  1552. else {
  1553. allClassesLink.style.display = "none";
  1554. }
  1555. //-->
  1556. </script>
  1557. </div>
  1558. <div>
  1559. <ul class="subNavList">
  1560. <li>Summary:&nbsp;</li>
  1561. <li>Nested&nbsp;|&nbsp;</li>
  1562. <li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
  1563. <li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
  1564. <li><a href="#method.summary">Method</a></li>
  1565. </ul>
  1566. <ul class="subNavList">
  1567. <li>Detail:&nbsp;</li>
  1568. <li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
  1569. <li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
  1570. <li><a href="#method.detail">Method</a></li>
  1571. </ul>
  1572. </div>
  1573. <a name="skip.navbar.bottom">
  1574. <!-- -->
  1575. </a></div>
  1576. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  1577. <p class="legalCopy"><small>Copyright &#169; 2018. All rights reserved.</small></p>
  1578. </body>
  1579. </html>