org.vishia.inspectorTarget

Class SearchElement

java.lang.Object

org.vishia.inspectorTarget.SearchElement

public class SearchElement
extends java.lang.Object

Functionality to search an element for reflection access.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SearchElement.SearchTrc Only for debugging: Element to store the trace while searching any element.

Field Summary

Fields

Modifier and Type	Field and Description
static SearchElement.SearchTrc[]	searchTrc Only for debugging: Stores the trace while searching any element.
(package private) static java.lang.String	version Version, history and license.

Constructor Summary

Constructors

Constructor and Description
SearchElement()

Method Summary

Modifier and Type	Method and Description
static MemSegmJc	searchObject(java.lang.String sPath, ClassJc startClazz, MemSegmJc startAddr, FieldJc[] retField, int[] retIdx) Searches a Field in a Object with given path.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

version

static final java.lang.String version

Version, history and license.

• 2019-03-01 Hartmut some chg adequate and similar to the translated C-routines (no re-translating Java2C yet done but similar changed): searchObject(String, ClassJc, MemSegmJc, FieldJc[], int[]) with separated class and instance reference.
• 2019-01-20 Hartmut searchObject searches in base classes too. Same as in C. It is used for Simulink especially but it is commonly proper.
• 2016-09-12 Hartmut bugfix: #searchObject(String, Object, FieldJc[], int[]): An index should be read with StringFunctions_C#parseIntRadix(CharSequence, int, int, int, int[]) instead Integer.parseInt(String, int) because the first one is exception-free. An exception is an problem on target system in C. It occurs if the path is faulty by access from Inspector.
• 2015-10-29 Bugfix: It was hanging by "path.." 2 dots one after another.
• 2011-02-00 Hartmut created, converted from the C implementation.
• 2006-00-00 Hartmut created for C/C++

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

searchTrc

public static final SearchElement.SearchTrc[] searchTrc

Only for debugging: Stores the trace while searching any element. It is use-able if the algorithm itself are debugged.

Constructor Detail

SearchElement

public SearchElement()

Method Detail

searchObject

public static MemSegmJc searchObject(java.lang.String sPath,
                                     ClassJc startClazz,
                                     MemSegmJc startAddr,
                                     FieldJc[] retField,
                                     int[] retIdx)

Searches a Field in a Object with given path. It is the core routine to access data with the inspector with the given path.

Parameters:

sPath - String given path to any Field in an Object.

startObj - The root Object for the path.

retField - The field of the found Object will stored at retField[0].

retIdx - If the sPath contains a index written like [12] at end, then the index is returned here. Elsewhere -1 is returned in retIdx[0].

Returns:

The address and segment of the Object, which contains the retField[0].