NAME

p_stderr - Writes a formatted string to stderr.

SYNOPSIS

#include "l/l_sys_io.h"

Example compile flags (system dependent):
  -DLINUX_386 -DLINUX_386_P4  
   -I/home/kobus/include
   -L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
  -lKJB         -llapack -lblas -lg2c          -lXext -lX11 


long p_stderr
(
	const char *format_str,
	...
);

DESCRIPTION

The formating options are similar to the standard ones, except that the standard ones are not very standard! Thus the KJB library routine provides some semblence of platform independent IO. Also, there are additional formatting options available (see kjb_fprintf for details). This routine works together with the rest of the KJB library to implement paging and flushing of all files when stderr is written to.

RETURNS

ERROR on failure and the number of characters printed on success.

NOTES

This routine used to called "pse" in analogy with "pso", but it was found to be too easy to type the wrong one. Hence the less usual case was changed to a more obtuse name.

SEEALSO

kjb_fprintf

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTOR

Kobus Barnard

SEE ALSO

kjb_read_exact , kjb_read , kjb_read_2 , safe_pipe_write , kjb_write , kjb_write_2 , kjb_fread_exact , kjb_fread , kjb_fread_2 , kjb_fwrite , kjb_fwrite_2 , kjb_fflush , kjb_ioctl , set_blocking , set_no_blocking , fget_line , dget_line , fput_line , kjb_mkdir , kjb_mkdir_2 , kjb_unlink , kjb_unlink_2 , kjb_rmdir , kjb_fopen , kjb_freopen , kjb_fdopen , kjb_fclose , kjb_realpath , get_fd_name , get_user_fd_name , kjb_fseek , kjb_ftell , kjb_fputs , kjb_fgetc , kjb_fputc , pso , kjb_fprintf , pdo , kjb_vfprintf , is_file , is_directory , fp_get_path_type , get_path_type , get_file_size , fp_get_byte_size , get_file_age , get_file_mod_time , print_underlined , start_stdout_shadow , stop_stdout_shadow , start_stderr_shadow , stop_stderr_shadow , kjb_glob , kjb_simple_glob