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_ARGS2() [1/2]

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 3686 of file trio.c.

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

TRIO_ARGS2() [2/2]

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 3668 of file trio.c.

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

TRIO_ARGS3() [1/7]

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 3967 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_ARGS3() [2/7]

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 3942 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_ARGS3() [3/7]

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 3828 of file trio.c.

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

TRIO_ARGS3() [4/7]

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 3808 of file trio.c.

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

TRIO_ARGS3() [5/7]

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 3757 of file trio.c.

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

TRIO_ARGS3() [6/7]

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 3736 of file trio.c.

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

TRIO_ARGS3() [7/7]

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

Definition at line 4224 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_ARGS4() [1/4]

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 4058 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_ARGS4() [2/4]

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 4029 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_ARGS4() [3/4]

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 3866 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_ARGS4() [4/4]

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 3884 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_VARGS2()

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 3644 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_VARGS3() [1/4]

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 3914 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_VARGS3() [2/4]

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 3782 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_VARGS3() [3/4]

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 3709 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_VARGS3() [4/4]

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

Definition at line 4188 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_VARGS4() [1/2]

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 3997 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;
}

TRIO_VARGS4() [2/2]

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 3843 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;
}