PPL6-Icon Patrick's Programming Library Version 6.4.21 - Dokumentation
ppl6::CArray Klassenreferenz

Einfaches zweidimensionales Array mit Zahlen als Schlüssel.

Öffentliche Typen

enum  PPLDataType {
  UNKNOWN =0, CINT =2, CSTRING =4, CASSOCARRAY =5,
  CBINARY =6, CWSTRING =8, CARRAY =9, CBOOL =10,
  CDATETIME =11
}
 Enumeration der verschiedenen Datenobjekte, die in der Library verwendet werden. Mehr ...
 

Öffentliche Methoden

 CArray ()
 Konstruktor. Mehr ...
 
 CArray (const CArray &other)
 Copy-Konstruktor. Mehr ...
 
 CArray (const CString &str, const CString &delimiter=CString("\n"), size_t limit=0, bool skipemptylines=false)
 Konstruktor aus String. Mehr ...
 
 ~CArray ()
 
int Add (const char *value, int bytes=-1)
 
int Add (int value)
 
int Add (const CString &value, int bytes=-1)
 
int Add (const CWString &value, int chars=-1)
 
int Add (const CArray &a)
 
int Addf (const char *fmt,...)
 
void Clear ()
 
int Copy (const CArray &a)
 
int Copy (const CArray *a)
 
int Copy (const CAssocArray &a)
 
int Copy (const CAssocArray *a)
 
int DataType () const
 Liefert den Datentyp des Objekts zurück. Mehr ...
 
int Explode (const char *text, const char *trenn, int limit=0, bool skipemptylines=false)
 
int Explode (const CString &text, const char *trenn, int limit=0, bool skipemptylines=false)
 
int File2Array (CFileObject &ff, const char *trenn)
 
int File2Array (const char *filename, const char *trenn)
 
CArrayfromArgs (int argc, const char **argv)
 
CArrayfromArgs (const CString &args)
 
const char * Get (ppldd index) const
 
const char * GetFirst ()
 
const char * GetNext ()
 
int GetNumRows () const
 
const char * GetRandom () const
 
CString GetString (ppldd index) const
 
CString Implode (const CString &trenn=CString("\n")) const
 
int IsType (int type) const
 
void List () const
 
void MakeUnique ()
 
int Num () const
 Anzahl Elemente im Array. Mehr ...
 
CArrayoperator= (const CArray &a)
 
CArrayoperator= (const CArray *a)
 
CArrayoperator= (const CAssocArray &a)
 
CArrayoperator= (const CAssocArray *a)
 
const char * operator[] (ppldd index) const
 
const char * Pop ()
 
int Push (const char *value, int bytes=-1)
 
void Reserve (ppldd size)
 Platz reservieren. Mehr ...
 
void Reset ()
 
int Set (ppldd index, const char *value, int bytes=-1)
 
const char * Shift ()
 
size_t Size () const
 Anzahl Elemente im Array. Mehr ...
 
void Sort ()
 
int Text2Array (const char *text, const char *trenn)
 
int Text2Array (const CString &text, const char *trenn)
 
int Unshift (const char *value, int bytes=-1)
 

Geschützte Attribute

ppluint8 type
 

Private Attribute

ppldd maxnum
 
ppldd num
 
ppldd pos
 
void * rows
 

Dokumentation der Aufzählungstypen

enum ppl6::CVar::PPLDataType
inherited

Enumeration der verschiedenen Datenobjekte, die in der Library verwendet werden

Seit
Wurde mit Version 6.3.0 eingeführt.
Aufzählungswerte
UNKNOWN 

Unbekannter Datentyp.

CINT 

Klasse vom Typ CInt.

CSTRING 

Klasse vom Typ CString.

CASSOCARRAY 

Klasse vom Typ CAssocArray.

CBINARY 

Klasse vom Typ CBinary.

CWSTRING 

Klasse vom Typ CWString.

CARRAY 

Klasse vom Typ CArray.

CBOOL 

Klasse vom Typ CBool.

CDATETIME 

Klasse vom Typ CDateTime.

Beschreibung der Konstruktoren und Destruktoren

ppl6::CArray::CArray ( )
Beschreibung:
Der Standard-Konstruktor erstellt ein leeres Array
ppl6::CArray::CArray ( const CArray other)
Beschreibung:
Mit dem Copy-Konstruktor wird der Inhalt des Arrays other 1:1 kopiert.
Parameter
otherAnderes Array
ppl6::CArray::CArray ( const CString str,
const CString delimiter = CString("\n"),
size_t  limit = 0,
bool  skipemptylines = false 
)
Beschreibung:
Mit diesem Konstruktor wird der String str anhand des Trennzeichens delimiter in einzelne Elemente zerlegt
Parameter
strString
delimiterTrennzeichen oder Trennstring
limitMaximale Anzahl Elemente, normalerweise unbegrenzt
skipemptylinesLeere Elemente überspringen. Folgen zwei Trennzeichen hintereinander, würde normalerweise ein leeres Element in das Array eingefügt. Durch setzen dieses Parameters auf true werden keine leeren Elemente eingefügt.
Siehe auch
Dieser Konstruktor verwendet die Funktion Array::explode zum Zerlegen des Strings.
ppl6::CArray::~CArray ( )

Dokumentation der Elementfunktionen

int ppl6::CArray::Add ( const char *  value,
int  bytes = -1 
)
int ppl6::CArray::Add ( int  value)
int ppl6::CArray::Add ( const CString value,
int  bytes = -1 
)
int ppl6::CArray::Add ( const CWString value,
int  chars = -1 
)
int ppl6::CArray::Add ( const CArray a)
int ppl6::CArray::Addf ( const char *  fmt,
  ... 
)
void ppl6::CArray::Clear ( )
int ppl6::CArray::Copy ( const CArray a)
int ppl6::CArray::Copy ( const CArray a)
int ppl6::CArray::Copy ( const CAssocArray a)
int ppl6::CArray::Copy ( const CAssocArray a)
int CVar::DataType ( ) const
inherited

Diese Funktion liefert den Datentyp des Objekts zurück.

Rückgabe
ID aus der Enumeration CVar::PPLDataType
Seit
Wurde mit Version 6.3.0 eingeführt.
int ppl6::CArray::Explode ( const char *  text,
const char *  trenn,
int  limit = 0,
bool  skipemptylines = false 
)
int ppl6::CArray::Explode ( const CString text,
const char *  trenn,
int  limit = 0,
bool  skipemptylines = false 
)
int ppl6::CArray::File2Array ( CFileObject ff,
const char *  trenn 
)
int ppl6::CArray::File2Array ( const char *  filename,
const char *  trenn 
)
CArray & ppl6::CArray::fromArgs ( int  argc,
const char **  argv 
)
CArray & ppl6::CArray::fromArgs ( const CString args)
const char * ppl6::CArray::Get ( ppldd  index) const
const char * ppl6::CArray::GetFirst ( )
const char * ppl6::CArray::GetNext ( )
int ppl6::CArray::GetNumRows ( ) const
const char * ppl6::CArray::GetRandom ( ) const
CString ppl6::CArray::GetString ( ppldd  index) const
CString ppl6::CArray::Implode ( const CString trenn = CString("\n")) const
int CVar::IsType ( int  type) const
inherited
void ppl6::CArray::List ( ) const
void ppl6::CArray::MakeUnique ( )
int ppl6::CArray::Num ( ) const
Beschreibung:
Diese Funktion gibt die Anzahl Elemente im Array zurück.
Rückgabe
Anzahl Elemente
Zu beachten
Wird bei einem leeren Array ein String an der Position 5 eingefügt, werden die Positionen 0 bis 4 automatisch als leere Elemente interpretiert. Array::size wird daher 6 zurückgeben.
Siehe auch
Die Funktionen CArray::Size und CArray::Num sind identisch.
CArray & ppl6::CArray::operator= ( const CArray a)
CArray & ppl6::CArray::operator= ( const CArray a)
CArray & ppl6::CArray::operator= ( const CAssocArray a)
CArray & ppl6::CArray::operator= ( const CAssocArray a)
const char * ppl6::CArray::operator[] ( ppldd  index) const
const char * ppl6::CArray::Pop ( )
int ppl6::CArray::Push ( const char *  value,
int  bytes = -1 
)
void ppl6::CArray::Reserve ( ppldd  size)
Beschreibung:
Durch Aufruf dieser Funktion wird vorab Speicher allokiert, um die durch size angegebene Anzahl Elemente aufnehmen zu können. Die Funktion sollte immer dann aufgerufen werden, wenn schon vor dem Befüllen des Array bekannt ist, wieviele Elemente es aufnehmen soll. Insbesondere bei großen Arrays ist dies sinnvoll, da dadurch das Reallokieren und Kopieren von Speicher während der Befüllung reduziert wird.
Parameter
sizeAnzahl Elemente, die das Array aufnehmen soll
Zu beachten
Ist die Kapazität des Arrays bei Aufruf der Funktion bereits höher als der angegebene Wert size, bleibt das Array unverändert. Die Kapazität kann nachträglich nicht verkleinert werden.
Siehe auch
Mit der Funktion Array::capacity kann abgefragt werden, für wieviele Elemente derzeit Speicher reserviert ist.
void ppl6::CArray::Reset ( )
int ppl6::CArray::Set ( ppldd  index,
const char *  value,
int  bytes = -1 
)
const char * ppl6::CArray::Shift ( )
size_t ppl6::CArray::Size ( ) const
Beschreibung:
Diese Funktion gibt die Anzahl Elemente im Array zurück.
Rückgabe
Anzahl Elemente
Zu beachten
Wird bei einem leeren Array ein String an der Position 5 eingefügt, werden die Positionen 0 bis 4 automatisch als leere Elemente interpretiert. Array::size wird daher 6 zurückgeben.
Siehe auch
Die Funktionen CArray::Size und CArray::Num sind identisch.
void ppl6::CArray::Sort ( )
int ppl6::CArray::Text2Array ( const char *  text,
const char *  trenn 
)
int ppl6::CArray::Text2Array ( const CString text,
const char *  trenn 
)
int ppl6::CArray::Unshift ( const char *  value,
int  bytes = -1 
)

Dokumentation der Datenelemente

ppldd ppl6::CArray::maxnum
private
ppldd ppl6::CArray::num
private
ppldd ppl6::CArray::pos
private
void* ppl6::CArray::rows
private
ppluint8 ppl6::CVar::type
protectedinherited

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien: