fsetposfsetpos

Establece el indicador de posición de secuencia.Sets the stream-position indicator.

SintaxisSyntax

int fsetpos(
   FILE *stream,
   const fpos_t *pos
);

ParámetrosParameters

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

abrepos
Almacenamiento del indicador de posición.Position-indicator storage.

Valor devueltoReturn Value

Si se realiza correctamente, fsetpos devuelve 0.If successful, fsetpos returns 0. En caso de error, la función devuelve un valor distinto de cero y establece errno en una de las siguientes constantes de manifiesto (definidas en errno. H): EBADF, lo que significa que no se puede acceder al archivo o que el objeto al que apunta el flujo no es una estructura de archivos válida. o EINVAL, lo que significa que se pasó un valor no válido para la secuencia o el PDV .On failure, the function returns a nonzero value and sets errno to one of the following manifest constants (defined in ERRNO.H): EBADF, which means the file is not accessible or the object that stream points to is not a valid file structure; or EINVAL, which means an invalid value for stream or pos was passed. Si se pasa un parámetro no válido, estas funciones invocan al controlador de parámetros no válidos, tal y como se describe en Validación de parámetros.If an invalid parameter is passed in, these functions invoke the invalid parameter handler, as described in Parameter Validation.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de retorno.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, return codes.

ObservacionesRemarks

La función fsetpos establece el indicador de posición de archivo de la secuencia en el valor de pos, que se obtiene en una llamada anterior a fgetpos en la secuencia.The fsetpos function sets the file-position indicator for stream to the value of pos, which is obtained in a prior call to fgetpos against stream. La función borra el indicador de fin de archivo y deshace los efectos de ungetc en la secuencia.The function clears the end-of-file indicator and undoes any effects of ungetc on stream. Después de llamar a fsetpos, la siguiente operación en la secuencia puede ser de entrada o de salida.After calling fsetpos, the next operation on stream may be either input or output.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

RequisitosRequirements

FunciónFunction Encabezado necesarioRequired header
fsetposfsetpos <stdio.h><stdio.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

EjemploExample

Consulte el ejemplo de fgetpos.See the example for fgetpos.

Consulta tambiénSee also

E/S de secuenciaStream I/O
fgetposfgetpos