NativeString (JNA API)

Overview | Package | Class | Tree | Deprecated | Index | Help
| JNA API 3.3.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.sun.jna
Class NativeString

    java.lang.Object
      com.sun.jna.NativeString

All Implemented Interfaces:
  CharSequence, Comparable

     class NativeString

extends Object
implements CharSequence, Comparable

Provides a temporary allocation of an immutable C string (`const char*` or `const wchar_t*`) for use when converting a Java String into a native memory function argument.

Author:
  Todd Fast, todd.fast@sun.com, twall@users.sf.net

Constructor Summary
`NativeString(String string)` Create a native string (NUL-terminated array of `char`).
`NativeString(String string, boolean wide)` Create a native string as a NUL-terminated array of `wchar_t` (if `wide` is true) or `char`.

Method Summary
`char` | `charAt(int index)`
`int` | `compareTo(Object other)`
`boolean` | `equals(Object other)`
`Pointer` | `getPointer()`
`int` | `hashCode()`
`int` | `length()`
`CharSequence` | `subSequence(int start, int end)`
`String` | `toString()`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### NativeString

    public NativeString(String string)

  Create a native string (NUL-terminated array of `char`).

  If the system property `jna.encoding` is set, its value will be used to encode the native string. If not set or if the encoding is unavailable, the default platform encoding will be used.

### NativeString

    public NativeString(String string,
                        boolean wide)

  Create a native string as a NUL-terminated array of `wchar_t` (if `wide` is true) or `char`.

  If the system property `jna.encoding` is set, its value will be used to encode the native `char`string. If not set or if the encoding is unavailable, the default platform encoding will be used.

  Parameters:
    `string` - value to write to native memory
    `wide` - whether to store the String as `wchar_t`

Method Detail

### hashCode

    public int hashCode()

  Overrides:
    `hashCode` in class `Object`

### equals

    public boolean equals(Object other)

  Overrides:
    `equals` in class `Object`

### toString

    public String toString()

  Specified by:
    `toString` in interface `CharSequence`
  Overrides:
    `toString` in class `Object`

### getPointer

    public Pointer getPointer()

### charAt

    public char charAt(int index)

  Specified by:
    `charAt` in interface `CharSequence`

### length

    public int length()

  Specified by:
    `length` in interface `CharSequence`

### subSequence

    public CharSequence subSequence(int start,
                                    int end)

  Specified by:
    `subSequence` in interface `CharSequence`

### compareTo

    public int compareTo(Object other)

  Specified by:
    `compareTo` in interface `Comparable`

Overview | Package | Class | Tree | Deprecated | Index | Help
| JNA API 3.3.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2007-2010 Timothy Wall. All Rights Reserved.