|
| Patrick's Programming Library Version 7.0.0 - Dokumentation |
Ein Array mit Strings. Mehr ...
Klassen | |
| class | Iterator |
| Iterator zum Durchwandern eines String Array. Mehr ... | |
Öffentliche Methoden | |
Konstruktoren und Destruktor | |
| Array () | |
| Konstruktor. Mehr ... | |
| Array (const Array &other) | |
| Copy-Konstruktor. Mehr ... | |
| Array (const String &str, const String &delimiter=String("\n"), size_t limit=0, bool skipemptylines=false) | |
| Konstruktor aus String. Mehr ... | |
| ~Array () | |
| Destruktor. Mehr ... | |
Elemente hinzufügen/verändern | |
| void | add (const String &value) |
| String anhängen. Mehr ... | |
| void | add (const String &value, size_t size) |
| Teilstring anhängen. Mehr ... | |
| void | add (const char *value, size_t size) |
| Teilstring anhängen. Mehr ... | |
| void | add (const Array &other) |
| Array hinzufügen. Mehr ... | |
| void | addf (const char *fmt,...) |
| Formatierten String anhängen. Mehr ... | |
| void | copy (const Array &other) |
| Array kopieren. Mehr ... | |
| void | set (size_t index, const String &value) |
| Wert eines Elements setzen. Mehr ... | |
| void | setf (size_t index, const char *fmt,...) |
| Formatierten String setzen. Mehr ... | |
| void | insert (size_t index, const String &value) |
| Element im Array einfügen. Mehr ... | |
| void | insert (size_t index, const Array &other) |
| Array einfügen. Mehr ... | |
| void | insertf (size_t index, const char *fmt,...) |
| Element mittels Formatstring einfügen. Mehr ... | |
| Array & | fromArgs (int argc, const char **argv) |
| Array aus den Aufrufparametern des Programms erzeugen. Mehr ... | |
| Array & | fromArgs (const String &args) |
| Array aus dem Aufrufstring des Programms erzeugen. Mehr ... | |
| Array & | explode (const String &text, const String &delimiter="\n", size_t limit=0, bool skipemptylines=false) |
| Array aus String erzeugen. Mehr ... | |
Elemente löschen | |
| void | clear () |
| Array löschen. Mehr ... | |
| String | erase (size_t index) |
| Das erste Element aus dem Array holen. Mehr ... | |
| String | shift () |
| Das erste Element aus dem Array holen. Mehr ... | |
| String | pop () |
| Das letzte Element aus dem Array holen. Mehr ... | |
Elemente auslesen | |
| const String & | get (ssize_t index) const |
| Element als Konstante auslesen. Mehr ... | |
| const String & | getRandom () const |
| Zufälliges Element als Konstante auslesen. Mehr ... | |
| String & | get (ssize_t index) |
| Element auslesen. Mehr ... | |
| String & | getRandom () |
| Zufälliges Element auslesen. Mehr ... | |
| String | getRest (size_t index, const String &delimiter=" ") |
| Inhalt des Arrays ab einer bestimmten Position als String zurückgeben. Mehr ... | |
| const char * | getPtr (ssize_t index) const |
| char Pointer auf ein Element auslesen Mehr ... | |
| const char * | getRandomPtr () const |
| Zufälliges Element als char Pointer auslesen. Mehr ... | |
| void | reset (Iterator &it) const |
| Iterator auf den Anfang setzen. Mehr ... | |
| const String & | getFirst (Iterator &it) const |
| Referenz auf das erste Element mittels Iterator auslesen. Mehr ... | |
| const String & | getNext (Iterator &it) const |
| Referenz auf das nächste Element mittels Iterator auslesen. Mehr ... | |
| String | implode (const String &delimiter="\n") const |
| Array zu einem String zusammenfügen. Mehr ... | |
Sonstiges | |
| size_t | count () const |
| Anzahl Elemente im Array. Mehr ... | |
| size_t | size () const |
| Anzahl Elemente im Array. Mehr ... | |
| size_t | capacity () const |
| Anzahl Elemente, für die Speicher reserviert ist. Mehr ... | |
| bool | empty () const |
| Array leer? Mehr ... | |
| void | reserve (size_t size) |
| Platz reservieren. Mehr ... | |
| void | list (const String &prefix=String()) const |
| Inhalt des Arrays ausgeben. Mehr ... | |
| void | sort () |
| Elemente nach ihrem Wert sortieren. Mehr ... | |
| void | sortReverse () |
| Elemente nach ihrem Wert in umgekehrter Reihenfolge sortieren. Mehr ... | |
| void | sortUnique () |
| Elemente nach ihrem Wert sortieren, Duplikate entfernen. Mehr ... | |
| void | makeUnique () |
| Duplikate entfernen. Mehr ... | |
| size_t | indexOf (const String &search) |
| bool | has (const String &search) |
Operatoren | |
| String & | operator[] (ssize_t index) |
| Element aus dem Array auslesen. Mehr ... | |
| const String & | operator[] (ssize_t index) const |
| Element aus dem Array als Konstante auslesen. Mehr ... | |
| Array & | operator= (const Array &other) |
| Inhalt eines anderen Arrays übernehmen. Mehr ... | |
| Array & | operator+= (const Array &other) |
| Inhalt eines anderen Arrays hinzufügen. Mehr ... | |
| bool | operator== (const Array &other) |
| Prüfen, ob zwei Arrays identisch sind. Mehr ... | |
| bool | operator!= (const Array &other) |
| Prüfen, ob zwei Arrays unterschiedlich sind. Mehr ... | |
Private Attribute | |
| size_t | numCapacity |
| Maximale Anzahl Elemente im Array. Mehr ... | |
| size_t | numElements |
| Anzahl Elemente im Array. Mehr ... | |
| void * | rows |
| Array mit den Datenelementen. Mehr ... | |
Verwandte Funktionen | |
(Es handelt sich hierbei nicht um Elementfunktionen.) | |
| Array | operator+ (const Array &a1, const Array &a2) |
| Zwei Arrays zusammenaddieren. Mehr ... | |
| Array | Sort (const Array &array, bool unique) |
| Inhalt eines Arrays alphabetisch sortieren. Mehr ... | |
| Array | SortReverse (const Array &array, bool unique) |
| Inhalt eines Arrays in umgekehrter Reihenfolge sortieren. Mehr ... | |
| ppl7::Array::Array | ( | ) |
| ppl7::Array::Array | ( | const Array & | other | ) |
other 1:1 kopiert.| other | Anderes Array |
| ppl7::Array::Array | ( | const String & | str, |
| const String & | delimiter = String("\n"), |
||
| size_t | limit = 0, |
||
| bool | skipemptylines = false |
||
| ) |
str anhand des Trennzeichens delimiter in einzelne Elemente zerlegt| str | String |
| delimiter | Trennzeichen oder Trennstring |
| limit | Maximale Anzahl Elemente, normalerweise unbegrenzt |
| skipemptylines | Leere 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. |
| ppl7::Array::~Array | ( | ) |
| void ppl7::Array::add | ( | const String & | value | ) |
| void ppl7::Array::add | ( | const String & | value, |
| size_t | size | ||
| ) |
| void ppl7::Array::add | ( | const char * | value, |
| size_t | size | ||
| ) |
| void ppl7::Array::add | ( | const Array & | other | ) |
| void ppl7::Array::addf | ( | const char * | fmt, |
| ... | |||
| ) |
| size_t ppl7::Array::capacity | ( | ) | const |
| void ppl7::Array::clear | ( | ) |
| void ppl7::Array::copy | ( | const Array & | other | ) |
other gefüllt. Falls der bestehende Inhalt nicht gelöscht werden soll, muss die Funktion Array::add(const Array &other) verwendet werden.| other | Zu kopierendes Array |
| size_t ppl7::Array::count | ( | ) | const |
| bool ppl7::Array::empty | ( | ) | const |
| String ppl7::Array::erase | ( | size_t | index | ) |
| OutOfBoundsEception | Wird geworfen, wenn der gewünschte Index größer als die Anzahl Elemente im Array ist. |
| Array & ppl7::Array::explode | ( | const String & | text, |
| const String & | delimiter = "\n", |
||
| size_t | limit = 0, |
||
| bool | skipemptylines = false |
||
| ) |
text wird anhand des Trennzeichens delimiter in einzelne Elemente zerlegt, die wiederum an das Array angefügt werden| text | Zu parsender String |
| delimiter | Trennzeichen oder Trennstring |
| limit | Maximale Anzahl Elemente, normalerweise unbegrenzt |
| skipemptylines | Leere 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. |
text leer, werden dem Array keine Elemente hinzugefügt.| Array & ppl7::Array::fromArgs | ( | int | argc, |
| const char ** | argv | ||
| ) |
| const String & ppl7::Array::get | ( | ssize_t | index | ) | const |
index des Arrays als Referenz zurück, dessen Inhalt nicht verändert werden kann. Ist index größer als die Anzahl Elemente des Arrays, wird eine Exception geworfen.| index | Gewünschtes Element |
| OutOfBoundsEception | Wird geworfen, wenn index größer als die Anzahl Elemente des Arrays ist |
| String & ppl7::Array::get | ( | ssize_t | index | ) |
index des Arrays als Referenz zurück. Ist index größer als die Anzahl Elemente des Arrays, wird eine Exception geworfen.| index | Gewünschtes Element |
| OutOfBoundsEception | Wird geworfen, wenn index größer als die Anzahl Elemente des Arrays ist |
it wird auf das erste Element gesetzt. Dieses gibt die Funktion zurück und erhöht den Iterator auf das nächste Element.| it | Iterator |
| OutOfBoundsEception | Wird geworfen, wenn das Array leer ist |
it wird auf das erste Element gesetzt. Dieses gibt die Funktion zurück und erhöht den Iterator auf das nächste Element.| it | Iterator |
| OutOfBoundsEception | Wird geworfen, wenn das Array leer ist |
| const char * ppl7::Array::getPtr | ( | ssize_t | index | ) | const |
index zurück. Liegt index ausserhalb des Arrays wird eine Exception geworfen.| index | Gewünschtes Element |
| OutOfBoundsEception | Wird geworfen, wenn index größer als die Anzahl Elemente des Arrays ist |
| const String & ppl7::Array::getRandom | ( | ) | const |
| String & ppl7::Array::getRandom | ( | ) |
| const char * ppl7::Array::getRandomPtr | ( | ) | const |
| bool ppl7::Array::has | ( | const String & | search | ) |
| size_t ppl7::Array::indexOf | ( | const String & | search | ) |
| void ppl7::Array::insert | ( | size_t | index, |
| const String & | value | ||
| ) |
index werden um eins nach hinten verschoben. Anschließend wird das neue Element value an der Position index eingefügt.| index | Position, an der das Element eingefügt werden soll |
| value | Wert des Elements |
| void ppl7::Array::insert | ( | size_t | index, |
| const Array & | other | ||
| ) |
| void ppl7::Array::insertf | ( | size_t | index, |
| const char * | fmt, | ||
| ... | |||
| ) |
index werden um eins nach hinten verschoben. Anschließend wird ein neuer Wert mittels des Formatstrings fmt und den zusätzlichen Parametern gebildet und an der Position index eingefügt.| index | Position, an der das Element eingefügt werden soll |
| fmt | Formatstring |
| ... | Zusätzliche optionale Parameter |
| prefix | Optionaler String, der jedem Element vorangestellt wird. |
| void ppl7::Array::makeUnique | ( | ) |
| bool ppl7::Array::operator!= | ( | const Array & | other | ) |
| other | Referenz auf ein zweites Array |
true zurück, wenn beide Arrays unterschiedlich sind, sonst false. other am Ende des bestehenden Arrays angefügt.| other | Zu kopierendes Array |
other übernommen.| other | Zu kopierendes Array |
| bool ppl7::Array::operator== | ( | const Array & | other | ) |
| other | Referenz auf ein zweites Array |
true zurück, wenn beide Arrays identisch sind, sonst false. | String & ppl7::Array::operator[] | ( | ssize_t | index | ) |
index des Arrays als Referenz zurück. Ist index größer als die Anzahl Elemente des Arrays, wird eine Exception geworfen.| index | Gewünschtes Element |
| OutOfBoundsEception | Wird geworfen, wenn index größer als die Anzahl Elemente des Arrays ist |
| const String & ppl7::Array::operator[] | ( | ssize_t | index | ) | const |
index des Arrays als Referenz zurück, dessen Inhalt nicht verändert werden kann. Ist index größer als die Anzahl Elemente des Arrays, wird eine Exception geworfen.| index | Gewünschtes Element |
| OutOfBoundsEception | Wird geworfen, wenn index größer als die Anzahl Elemente des Arrays ist |
| String ppl7::Array::pop | ( | ) |
| void ppl7::Array::reserve | ( | size_t | size | ) |
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.| size | Anzahl Elemente, die das Array aufnehmen soll |
size, bleibt das Array unverändert. Die Kapazität kann nachträglich nicht verkleinert werden.| void ppl7::Array::reset | ( | Iterator & | it | ) | const |
| it | Iterator |
| void ppl7::Array::set | ( | size_t | index, |
| const String & | value | ||
| ) |
value wird an der Position index des Arrays gesetzt. Der vorherige Wert des Arrays an dieser Stelle wird dadurch überschrieben.| index | Position innerhalb des Arrays, beginnend mit 0 |
| value | String |
| void ppl7::Array::setf | ( | size_t | index, |
| const char * | fmt, | ||
| ... | |||
| ) |
fmt und der optionalen Parameter wird ein neuer String gebildet, der an die Position index des Arrays gesetzt wird. Der vorherige Wert des Arrays an dieser Stelle wird überschrieben.| index | Position innerhalb des Arrays, beginnend mit 0 |
| fmt | Formatstring |
| ... | Optionale Parameter |
| String ppl7::Array::shift | ( | ) |
| EmptyDataException | Wird geworfen, wenn das Array leer ist |
| size_t ppl7::Array::size | ( | ) | const |
| void ppl7::Array::sort | ( | ) |
| void ppl7::Array::sortReverse | ( | ) |
| void ppl7::Array::sortUnique | ( | ) |
|
private |
|
private |
|
private |