Copyright Digital Equipment Corp. All rights reserved.

Return_Values

   x                  The number of bytes (excluding the terminating
                      null byte) that would be written to str if n
                      is sufficiently large.
   Negative value     Indicates an output error occurred. The
                      function sets errno. For a list of possible
                      errno values set, see fprintf.