Printf

Functions
TRIO_PUBLIC int trio_printf	TRIO_VARGS2 ((format, va_alist), TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vprintf	TRIO_ARGS2 ((format, args), TRIO_CONST char *format, va_list args)
TRIO_PUBLIC int trio_printfv	TRIO_ARGS2 ((format, args), TRIO_CONST char *format, trio_pointer_t *args)
TRIO_PUBLIC int trio_fprintf	TRIO_VARGS3 ((file, format, va_alist), FILE *file, TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vfprintf	TRIO_ARGS3 ((file, format, args), FILE *file, TRIO_CONST char *format, va_list args)
TRIO_PUBLIC int trio_fprintfv	TRIO_ARGS3 ((file, format, args), FILE *file, TRIO_CONST char *format, trio_pointer_t *args)
TRIO_PUBLIC int trio_dprintf	TRIO_VARGS3 ((fd, format, va_alist), int fd, TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vdprintf	TRIO_ARGS3 ((fd, format, args), int fd, TRIO_CONST char *format, va_list args)
TRIO_PUBLIC int trio_dprintfv	TRIO_ARGS3 ((fd, format, args), int fd, TRIO_CONST char *format, trio_pointer_t *args)
TRIO_PUBLIC int trio_cprintf	TRIO_VARGS4 ((stream, closure, format, va_alist), trio_outstream_t stream, trio_pointer_t closure, TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vcprintf	TRIO_ARGS4 ((stream, closure, format, args), trio_outstream_t stream, trio_pointer_t closure, TRIO_CONST char *format, va_list args)
TRIO_PUBLIC int trio_cprintfv	TRIO_ARGS4 ((stream, closure, format, args), trio_outstream_t stream, trio_pointer_t closure, TRIO_CONST char *format, void **args)
TRIO_PUBLIC int trio_sprintf	TRIO_VARGS3 ((buffer, format, va_alist), char *buffer, TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vsprintf	TRIO_ARGS3 ((buffer, format, args), char *buffer, TRIO_CONST char *format, va_list args)
TRIO_PUBLIC int trio_sprintfv	TRIO_ARGS3 ((buffer, format, args), char *buffer, TRIO_CONST char *format, trio_pointer_t *args)
TRIO_PUBLIC int trio_snprintf	TRIO_VARGS4 ((buffer, max, format, va_alist), char *buffer, size_t max, TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vsnprintf	TRIO_ARGS4 ((buffer, max, format, args), char *buffer, size_t max, TRIO_CONST char *format, va_list args)
TRIO_PUBLIC int trio_snprintfv	TRIO_ARGS4 ((buffer, max, format, args), char *buffer, size_t max, TRIO_CONST char *format, trio_pointer_t *args)
TRIO_PUBLIC int trio_asprintf	TRIO_VARGS3 ((result, format, va_alist), char **result, TRIO_CONST char *format, TRIO_VA_DECL)
TRIO_PUBLIC int trio_vasprintf	TRIO_ARGS3 ((result, format, args), char **result, TRIO_CONST char *format, va_list args)

Detailed Description

Function Documentation

TRIO_PUBLIC int trio_vscanf TRIO_ARGS2	(	(format, args)	,
		TRIO_CONST char *	format,
		va_list	args
	)

Print to standard output stream.

Parameters

format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3671 of file trio.c.

{
  assert(VALID(format));

  return TrioFormat(stdout, 0, TrioOutStreamFile, format, TRIO_VA_LIST_ADDR(args), NULL);
}

TRIO_PUBLIC int trio_scanfv TRIO_ARGS2	(	(format, args)	,
		TRIO_CONST char *	format,
		trio_pointer_t *	args
	)

Print to standard output stream.

Parameters

format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3689 of file trio.c.

{
  assert(VALID(format));

  return TrioFormat(stdout, 0, TrioOutStreamFile, format, NULL, args);
}

TRIO_PUBLIC int trio_vfscanf TRIO_ARGS3	(	(file, format, args)	,
		FILE *	file,
		TRIO_CONST char *	format,
		va_list	args
	)

Print to file.

Parameters

file	File pointer.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3739 of file trio.c.

{
  assert(VALID(file));
  assert(VALID(format));

  return TrioFormat(file, 0, TrioOutStreamFile, format, TRIO_VA_LIST_ADDR(args), NULL);
}

TRIO_PUBLIC int trio_fscanfv TRIO_ARGS3	(	(file, format, args)	,
		FILE *	file,
		TRIO_CONST char *	format,
		trio_pointer_t *	args
	)

Print to file.

Parameters

file	File pointer.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3760 of file trio.c.

{
  assert(VALID(file));
  assert(VALID(format));

  return TrioFormat(file, 0, TrioOutStreamFile, format, NULL, args);
}

TRIO_PUBLIC int trio_vdscanf TRIO_ARGS3	(	(fd, format, args)	,
		int	fd,
		TRIO_CONST char *	format,
		va_list	args
	)

Print to file descriptor.

Parameters

fd	File descriptor.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3811 of file trio.c.

{
  assert(VALID(format));

  return TrioFormat(&fd, 0, TrioOutStreamFileDescriptor, format, TRIO_VA_LIST_ADDR(args), NULL);
}

TRIO_PUBLIC int trio_dscanfv TRIO_ARGS3	(	(fd, format, args)	,
		int	fd,
		TRIO_CONST char *	format,
		trio_pointer_t *	args
	)

Print to file descriptor.

Parameters

fd	File descriptor.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3831 of file trio.c.

{
  assert(VALID(format));

  return TrioFormat(&fd, 0, TrioOutStreamFileDescriptor, format, NULL, args);
}

TRIO_PUBLIC int trio_vsprintf TRIO_ARGS3	(	(buffer, format, args)	,
		char *	buffer,
		TRIO_CONST char *	format,
		va_list	args
	)

Print to string.

Parameters

buffer	Output string.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3945 of file trio.c.

{
  int status;

  assert(VALID(buffer));
  assert(VALID(format));

  status = TrioFormat(&buffer, 0, TrioOutStreamString, format, TRIO_VA_LIST_ADDR(args), NULL);
  *buffer = NIL;
  return status;
}

TRIO_PUBLIC int trio_sprintfv TRIO_ARGS3	(	(buffer, format, args)	,
		char *	buffer,
		TRIO_CONST char *	format,
		trio_pointer_t *	args
	)

Print to string.

Parameters

buffer	Output string.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 3970 of file trio.c.

{
  int status;

  assert(VALID(buffer));
  assert(VALID(format));

  status = TrioFormat(&buffer, 0, TrioOutStreamString, format, NULL, args);
  *buffer = NIL;
  return status;
}

TRIO_PUBLIC int trio_vasprintf TRIO_ARGS3	(	(result, format, args)	,
		char **	result,
		TRIO_CONST char *	format,
		va_list	args
	)

Definition at line 4227 of file trio.c.

{
  int status;
  trio_string_t *info;

  assert(VALID(format));

  *result = NULL;

  info = trio_xstring_duplicate("");
  if (info == NULL)
    {
      status = TRIO_ERROR_RETURN(TRIO_ENOMEM, 0);
    }
  else
    {
      status = TrioFormat(info, 0, TrioOutStreamStringDynamic,
              format, TRIO_VA_LIST_ADDR(args), NULL);
      if (status >= 0)
    {
      trio_string_terminate(info);
      *result = trio_string_extract(info);
    }
      trio_string_destroy(info);
    }
  return status;
}

TRIO_PUBLIC int trio_vcprintf TRIO_ARGS4	(	(stream, closure, format, args)	,
		trio_outstream_t	stream,
		trio_pointer_t	closure,
		TRIO_CONST char *	format,
		va_list	args
	)

Definition at line 3869 of file trio.c.

{
  trio_custom_t data;

  assert(VALID(stream));
  assert(VALID(format));

  data.stream.out = stream;
  data.closure = closure;
  return TrioFormat(&data, 0, TrioOutStreamCustom, format, TRIO_VA_LIST_ADDR(args), NULL);
}

TRIO_PUBLIC int trio_cprintfv TRIO_ARGS4	(	(stream, closure, format, args)	,
		trio_outstream_t	stream,
		trio_pointer_t	closure,
		TRIO_CONST char *	format,
		void **	args
	)

Definition at line 3887 of file trio.c.

{
  trio_custom_t data;

  assert(VALID(stream));
  assert(VALID(format));

  data.stream.out = stream;
  data.closure = closure;
  return TrioFormat(&data, 0, TrioOutStreamCustom, format, NULL, args);
}

TRIO_PUBLIC int trio_vsnprintfcat TRIO_ARGS4	(	(buffer, max, format, args)	,
		char *	buffer,
		size_t	max,
		TRIO_CONST char *	format,
		va_list	args
	)

Print at most max characters to string.

Parameters

buffer	Output string.
max	Maximum number of characters to print.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 4032 of file trio.c.

{
  int status;

  assert(VALID(buffer));
  assert(VALID(format));

  status = TrioFormat(&buffer, max > 0 ? max - 1 : 0,
              TrioOutStreamStringMax, format, TRIO_VA_LIST_ADDR(args), NULL);
  if (max > 0)
    *buffer = NIL;
  return status;
}

TRIO_PUBLIC int trio_snprintfv TRIO_ARGS4	(	(buffer, max, format, args)	,
		char *	buffer,
		size_t	max,
		TRIO_CONST char *	format,
		trio_pointer_t *	args
	)

Print at most max characters to string.

Parameters

buffer	Output string.
max	Maximum number of characters to print.
format	Formatting string.
args	Arguments.

Returns

Number of printed characters.

Definition at line 4061 of file trio.c.

{
  int status;

  assert(VALID(buffer));
  assert(VALID(format));

  status = TrioFormat(&buffer, max > 0 ? max - 1 : 0,
              TrioOutStreamStringMax, format, NULL, args);
  if (max > 0)
    *buffer = NIL;
  return status;
}

TRIO_PUBLIC int trio_scanf TRIO_VARGS2	(	(format, va_alist)	,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Print to standard output stream.

Parameters

format	Formatting string.
...	Arguments.

Returns

Number of printed characters.

Scan characters from standard input stream.

Parameters

format	Formatting string.
...	Arguments.

Returns

Number of scanned characters.

Definition at line 3647 of file trio.c.

{
  int status;
  va_list args;

  assert(VALID(format));

  TRIO_VA_START(args, format);
  status = TrioFormat(stdout, 0, TrioOutStreamFile, format, TRIO_VA_LIST_ADDR(args), NULL);
  TRIO_VA_END(args);
  return status;
}

TRIO_PUBLIC int trio_fscanf TRIO_VARGS3	(	(file, format, va_alist)	,
		FILE *	file,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Print to file.

Parameters

file	File pointer.
format	Formatting string.
...	Arguments.

Returns

Number of printed characters.

Definition at line 3712 of file trio.c.

{
  int status;
  va_list args;

  assert(VALID(file));
  assert(VALID(format));

  TRIO_VA_START(args, format);
  status = TrioFormat(file, 0, TrioOutStreamFile, format, TRIO_VA_LIST_ADDR(args), NULL);
  TRIO_VA_END(args);
  return status;
}

TRIO_PUBLIC int trio_dscanf TRIO_VARGS3	(	(fd, format, va_alist)	,
		int	fd,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Print to file descriptor.

Parameters

fd	File descriptor.
format	Formatting string.
...	Arguments.

Returns

Number of printed characters.

Definition at line 3785 of file trio.c.

{
  int status;
  va_list args;

  assert(VALID(format));

  TRIO_VA_START(args, format);
  status = TrioFormat(&fd, 0, TrioOutStreamFileDescriptor, format, TRIO_VA_LIST_ADDR(args), NULL);
  TRIO_VA_END(args);
  return status;
}

TRIO_PUBLIC int trio_sprintf TRIO_VARGS3	(	(buffer, format, va_alist)	,
		char *	buffer,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Print to string.

Parameters

buffer	Output string.
format	Formatting string.
...	Arguments.

Returns

Number of printed characters.

Definition at line 3917 of file trio.c.

{
  int status;
  va_list args;

  assert(VALID(buffer));
  assert(VALID(format));

  TRIO_VA_START(args, format);
  status = TrioFormat(&buffer, 0, TrioOutStreamString, format, TRIO_VA_LIST_ADDR(args), NULL);
  *buffer = NIL; /* Terminate with NIL character */
  TRIO_VA_END(args);
  return status;
}

TRIO_PUBLIC int trio_asprintf TRIO_VARGS3	(	(result, format, va_alist)	,
		char **	result,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Definition at line 4191 of file trio.c.

{
  va_list args;
  int status;
  trio_string_t *info;

  assert(VALID(format));

  *result = NULL;

  info = trio_xstring_duplicate("");
  if (info == NULL)
    {
      status = TRIO_ERROR_RETURN(TRIO_ENOMEM, 0);
    }
  else
    {
      TRIO_VA_START(args, format);
      status = TrioFormat(info, 0, TrioOutStreamStringDynamic,
              format, TRIO_VA_LIST_ADDR(args), NULL);
      TRIO_VA_END(args);
      if (status >= 0)
    {
      trio_string_terminate(info);
      *result = trio_string_extract(info);
    }
      trio_string_destroy(info);
    }
  return status;
}

TRIO_PUBLIC int trio_cprintf TRIO_VARGS4	(	(stream, closure, format, va_alist)	,
		trio_outstream_t	stream,
		trio_pointer_t	closure,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Definition at line 3846 of file trio.c.

{
  int status;
  va_list args;
  trio_custom_t data;

  assert(VALID(stream));
  assert(VALID(format));

  TRIO_VA_START(args, format);
  data.stream.out = stream;
  data.closure = closure;
  status = TrioFormat(&data, 0, TrioOutStreamCustom, format, TRIO_VA_LIST_ADDR(args), NULL);
  TRIO_VA_END(args);
  return status;
}

TRIO_PUBLIC int trio_snprintfcat TRIO_VARGS4	(	(buffer, max, format, va_alist)	,
		char *	buffer,
		size_t	max,
		TRIO_CONST char *	format,
		TRIO_VA_DECL
	)

Print at most max characters to string.

Parameters

buffer	Output string.
max	Maximum number of characters to print.
format	Formatting string.
...	Arguments.

Returns

Number of printed characters.

Definition at line 4000 of file trio.c.

{
  int status;
  va_list args;

  assert(VALID(buffer));
  assert(VALID(format));

  TRIO_VA_START(args, format);
  status = TrioFormat(&buffer, max > 0 ? max - 1 : 0,
              TrioOutStreamStringMax, format, TRIO_VA_LIST_ADDR(args), NULL);
  if (max > 0)
    *buffer = NIL;
  TRIO_VA_END(args);
  return status;
}