(Android™) Benefit of XML Methods Having Names Ending in "2"

The Chilkat XML methods having names ending with "2" update the internal reference rather than return a new XML object instance. See the example below..

Note: There are a few methods, such as LoadXml2, where the "2" simply indicates the method is the same but has an additional argument. (There are some programming environments where overloading methods is not allowed. Therefore, Chilkat will avoid providing methods having the same name but with different arguments.)

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    String x = "<test><abc><xyz>123</xyz></abc></test>";

    CkXml xml = new CkXml();

    boolean success = xml.LoadXml(x);

    // First demonstrate getting "123" in the simplest way:
    Log.i(TAG, xml.chilkatPath("abc|xyz|*"));

    // Now demonstrate navigating to the "xyz" node using non-"2" methods.
    // The following few lines of code create two object instances, which will need
    // to be deleted or garbage collected.
    CkXml xAbc = xml.FindChild("abc");
    CkXml xXyz = xAbc.FindChild("xyz");
    Log.i(TAG, xXyz.content());

    // Now demonstrate navigating to the "xyz" node using the "2" methods.
    // No object instances are created.
    success = xml.FindChild2("abc");
    success = xml.FindChild2("xyz");
    Log.i(TAG, xml.content());
    // Restore xml back to the root of the document.
    xml.GetRoot2();

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}