blob: 891e2c8af2198056b75d4d402e978014c47af0e0 [file] [log] [blame]
/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
* This file is part of libmount from util-linux project.
*
* Copyright (C) 2009-2018 Karel Zak <kzak@redhat.com>
*
* libmount is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*/
/**
* SECTION: iter
* @title: Iterator
* @short_description: unified iterator
*
* The iterator keeps the direction and the last position
* for access to the internal library tables/lists.
*/
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "mountP.h"
/**
* mnt_new_iter:
* @direction: MNT_INTER_{FOR,BACK}WARD direction
*
* Returns: newly allocated generic libmount iterator.
*/
struct libmnt_iter *mnt_new_iter(int direction)
{
struct libmnt_iter *itr = calloc(1, sizeof(*itr));
if (!itr)
return NULL;
itr->direction = direction;
return itr;
}
/**
* mnt_free_iter:
* @itr: iterator pointer
*
* Deallocates the iterator.
*/
void mnt_free_iter(struct libmnt_iter *itr)
{
free(itr);
}
/**
* mnt_reset_iter:
* @itr: iterator pointer
* @direction: MNT_INTER_{FOR,BACK}WARD or -1 to keep the direction unchanged
*
* Resets the iterator.
*/
void mnt_reset_iter(struct libmnt_iter *itr, int direction)
{
if (direction == -1)
direction = itr->direction;
memset(itr, 0, sizeof(*itr));
itr->direction = direction;
}
/**
* mnt_iter_get_direction:
* @itr: iterator pointer
*
* Returns: MNT_INTER_{FOR,BACK}WARD
*/
int mnt_iter_get_direction(struct libmnt_iter *itr)
{
return itr->direction;
}