PreviousElement()

Syntaxe

Resultat = PreviousElement(ListeChainee())

L'élément précédent dans la liste spécifiée devient l'élément courant. Cette fonction renvoie dans Resultat l'adresse du nouvel élément courant ou 0 s'il n'y a pas d'élément précédent ou s'il n'y a pas d'éléments dans la liste.

Argument

ListeChainee() - Le nom de votre variable liste chaînée, créée à l'aide de la commande NewList. Les parenthèses sont obligatoires après le nom de la liste.

Valeur de retour

La valeur renvoyée par cette commande peut être utilisée pour déterminer si l'élément précédent existe ou pas (il n'existera pas si vous êtes au début de la liste). Si l'élément précédent existe, cette commande renvoie une valeur différente de zéro. Si l'élément précédent n'existe pas alors la valeur renvoyée sera zéro. Pour programmeurs expérimentés:
La valeur renvoyée par cette commande est un pointeur vers l'élément précédent ou zéro si l'élément précédent n'existe pas. La structure de chaque élément est définie ci-dessous :

  Structure Element
    *Next.Element        ; Pointeur vers l'élément suivant de la liste ou zéro si c'est le dernier élément
    *Previous.Element    ; Pointeur vers l'élément précédent de la liste ou zéro si c'est le premier élément

    ; La structure utilisée par la liste suit directement ces 2 variables (ce qui implique que les
    ; données utilisateurs se situent à l'adresse du nouvel élément + 8 octets).
  EndStructure

Vous ne devriez pas changer les pointeurs du début de la liste, car ça casserait la structure interne de la liste.

Exemple:

  NewList nombres.w()

  For i=1 To 10
    AddElement(nombres())
    nombres() = i
  Next

  Repeat
    MessageRequester("Nombre ", Str(nombres()), #PB_MessageRequester_OK)
  Until PreviousElement(nombres()) = 0

OS Supportés

Tous