/*

* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:

* FUNCTION

* <<fgetpos>>---record position in a stream or file

* INDEX

* fgetpos

* ANSI_SYNOPSIS

* #include <stdio.h>

* int fgetpos(FILE *<[fp]>, fpos_t *<[pos]>);

* TRAD_SYNOPSIS

* #include <stdio.h>

* int fgetpos(<[fp]>, <[pos]>)

* FILE *<[fp]>;

* fpos_t *<[pos]>;

* Objects of type <<FILE>> can have a ``position'' that records how much

* of the file your program has already read.  Many of the <<stdio>> functions

* depend on this position, and many change it as a side effect.

* You can use <<fgetpos>> to report on the current position for a file

* identified by <[fp]>; <<fgetpos>> will write a value

* representing that position at <<*<[pos]>>>.  Later, you can

* use this value with <<fsetpos>> to return the file to this

* position.

* In the current implementation, <<fgetpos>> simply uses a character

* count to represent the file position; this is the same number that

* would be returned by <<ftell>>.

* RETURNS

* <<fgetpos>> returns <<0>> when successful.  If <<fgetpos>> fails, the

* result is <<1>>.  Failure occurs on streams that do not support

* positioning; the global <<errno>> indicates this condition with the

* value <<ESPIPE>>.

* PORTABILITY

* <<fgetpos>> is required by the ANSI C standard, but the meaning of the

* value it records is not specified beyond requiring that it be

* acceptable as an argument to <<fsetpos>>.  In particular, other

* conforming C implementations may return a different result from

* <<ftell>> than what <<fgetpos>> writes at <<*<[pos]>>>.

* No supporting OS subroutines are required.

* 

*

*/

#include <stdio.h>

/**

Get position in a stream.

@return 0 value indicates success. non-zero value indicates error.

@param fp pointer to an open file. 

@param pos pointer to a fpos_t object where the position will be stored. 

*/

EXPORT_C int

fgetpos (FILE * fp, fpos_t * pos)

{

  *pos = ftell (fp);

  if (*pos != -1)

    return 0;

  return 1;

}