Main Page Cookbook/Overview ImageMeister the jcprops file Licensing Binary Installation & Configuration [ Win · Mac · Nix · OSX ] Changes Public API Source Code Main Page Java [ Common · Win · Mac · Nix ] Native Code [ Common · Win · Mac · Nix ] Manifest Native Code Overviews [ Common · Win · Mac · Nix · Strings ] Macros [ General · Native Macros ] Walkthroughs [ Java only · Java and native ] Building [ Win · Mac · Nix · OSX ] Distribution Issues

# CStringVector

  Holds a vector of CStr's.

[ Common | Source | Keywords | Summary | Ancestors | All Members | Descendants ]

## Quick Index

  DESCRIPTION
  MACROS

## Class Summary

class CStringVector
{
public:

  CStringVector( long max );
  CStringVector( JNIEnv *pEnv, long numStrs, JOBJECTARRAY pStrs );
  CStringVector( JNIEnv *pEnv, JOBJECTARRAY pStrs );
  void slamInto( JNIEnv *pEnv, JOBJECTARRAY pStrs );
  CStringVector( long numStrs, JOBJECTARRAY pStrs );
  CStringVector( JOBJECTARRAY pStrs );
  void slamInto( JOBJECTARRAY pStrs );
  ~CStringVector();
  long getNumStrings();
  void appendPackedString( const CStr *ps );
  CStr *getString( long i );
  void setString( CStr *cs, long i );
  void appendString( CStr *cs );
  void removeString( CStr *cs );
  BOOL contains( const CStr *cs );
  BOOL containsIgnoreCase( const CStr *cs );
  void dumpInfo();

protected:

}; // CStringVector

Back to the top of CStringVector

### DESCRIPTION

Holds a vector of CStr's. Can be created from an array of Java Strings, and the slamInto() method puts the strings in the vector into an array of Java Strings. A set of macros are provided to make it easier to work with this class.

Back to the top of CStringVector

### MACROS

    DECLARESTRINGVECTOR(a)
    	Allocates space for a CStringVector*, and sets it to null

    DELETESTRINGVECTOR(a)
    	If 'a' isn't null, calls 'delete' on it.

    MAKESTRINGVECTOR(a,b,c)
    	Constructs a CStringVector from an array of Java strings (a JOBJECTARRAY)
    	'a' is the number of strings to take from the array
    	'b' is the JOBJECTARRAY from which the strings will be retrieved
    	'c' is a CStringVector*

    SLAMSTRINGVECTOR(a,b)
    	Creates Java strings from the strings in the array, and puts each into a JOBJECTARRAY
    	'a' is a CStringVector*
    	'b' is the JOBJECTARRAY to which the strings will be written

Back to the top of CStringVector

### CStringVector( long max );

Construct, starting with the given number of elements.

    	CStringVector( long max );

Back to the top of CStringVector

### CStringVector( JNIEnv *pEnv, long numStrs, JOBJECTARRAY pStrs );

Construct using an array of JNI Strings. Only the first 'numStrs' will be used. Only available in JNI builds.

    	CStringVector( JNIEnv *pEnv, long numStrs, JOBJECTARRAY pStrs );

Back to the top of CStringVector

### CStringVector( JNIEnv *pEnv, JOBJECTARRAY pStrs );

Construct using an array of JNI Strings. Only available in JNI builds.

    	CStringVector( JNIEnv *pEnv, JOBJECTARRAY pStrs );

Back to the top of CStringVector

### void slamInto( JNIEnv *pEnv, JOBJECTARRAY pStrs );

Create JNI Strings from the CStr's in this object, and put them in the given JNI String array. Only available in JNI builds.

    	virtual	void	slamInto( JNIEnv *pEnv, JOBJECTARRAY pStrs );

Back to the top of CStringVector

### CStringVector( long numStrs, JOBJECTARRAY pStrs );

Construct using an array of RNI Strings. Only the first 'numStrs' will be used. Only available in RNI builds.

    	CStringVector( long numStrs, JOBJECTARRAY pStrs );

Back to the top of CStringVector

### CStringVector( JOBJECTARRAY pStrs );

Construct using an array of RNI Strings. Only available in RNI builds.

    	CStringVector( JOBJECTARRAY pStrs );

Back to the top of CStringVector

### void slamInto( JOBJECTARRAY pStrs );

Create RNI Strings from the CStr's in this object, and put them in the given RNI String array. Only available in RNI builds.

    	virtual	void	slamInto( JOBJECTARRAY pStrs );

Back to the top of CStringVector

### ~CStringVector();

Destructor

    	virtual	~CStringVector();

Back to the top of CStringVector

### long getNumStrings();

Return the number of strings in this array.

    	virtual	long	getNumStrings();

Back to the top of CStringVector

### void appendPackedString( const CStr *ps );

Append a series of strings from a packed string. See the CStrA getPackedString() method for the definition of a packed string.

    	virtual	void	appendPackedString( const CStr *ps );

Back to the top of CStringVector

### CStr *getString( long i );

Returns the i'th string. Returns NULL if there's no such index.

    	virtual	CStr	*getString( long i );

Back to the top of CStringVector

### void setString( CStr *cs, long i );

Set the i'th string.

    	virtual	void	setString( CStr *cs, long i );

Back to the top of CStringVector

### void appendString( CStr *cs );

Append the given string.

    	virtual	void	appendString( CStr *cs );

Back to the top of CStringVector

### void removeString( CStr *cs );

Remove the given string.

    	virtual	void	removeString( CStr *cs );

Back to the top of CStringVector

### BOOL contains( const CStr *cs );

Returns whether this object contains a string matching 'cs'. Uses CStr::isEqual().

    	virtual	BOOL contains( const CStr *cs );

Back to the top of CStringVector

### BOOL containsIgnoreCase( const CStr *cs );

Returns whether this object contains a string matching 'cs'. Uses CStr::isEqualIgnoreCase().

    	virtual	BOOL containsIgnoreCase( const CStr *cs );

Back to the top of CStringVector

### void dumpInfo();

Write info on the strings to Debugger::debug.

    	virtual	void	dumpInfo();

Back to the top of CStringVector

## All Members

public:
  void slamInto( JNIEnv *pEnv, JOBJECTARRAY pStrs );
  void slamInto( JOBJECTARRAY pStrs );
  long getNumStrings();
  void appendPackedString( const CStr *ps );
  CStr *getString( long i );
  void setString( CStr *cs, long i );
  void appendString( CStr *cs );
  void removeString( CStr *cs );
  BOOL contains( const CStr *cs );
  BOOL containsIgnoreCase( const CStr *cs );
  void dumpInfo();
protected:

Back to the top of CStringVector

## Ancestors

Class does not inherit from any other class.

Back to the top of CStringVector

## Descendants

Class is not inherited by any others.

Back to the top of CStringVector

Generated from source by the Cocoon utilities on Fri Aug 23 12:33:49 2002 .

Main Page · JConfig · ImageMeister · System Properties Repository · WordMeister · Free Samples · Java Freeware · Contact Us · FAQ · Links

Copyright (c) 1997-2002 Samizdat Productions. All Rights Reserved.
WarpMovie, TileMovie, JConfig, ImageMeister and MovieShredder are Trademarks of Samizdat Productions.