home *** CD-ROM | disk | FTP | other *** search
/ Tools / WinSN5.0Ver.iso / NETSCAP.50 / WIN1998.ZIP / ns / include / xp_mesg.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-04-08  |  1.8 KB  |  59 lines
  1. /* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
  2.  *
  3.  * The contents of this file are subject to the Netscape Public License
  4.  * Version 1.0 (the "NPL"); you may not use this file except in
  5.  * compliance with the NPL.  You may obtain a copy of the NPL at
  6.  * http://www.mozilla.org/NPL/
  7.  *
  8.  * Software distributed under the NPL is distributed on an "AS IS" basis,
  9.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
  10.  * for the specific language governing rights and limitations under the
  11.  * NPL.
  12.  *
  13.  * The Initial Developer of this code under the NPL is Netscape
  14.  * Communications Corporation.  Portions created by Netscape are
  15.  * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
  16.  * Reserved.
  17.  */
  18.  
  19. /*-----------------------------------------------------------------------------
  20.     Position String Formatting
  21.     %ns        argument n is a string
  22.     %ni        argument n is an integer
  23.     %%        literal %
  24.     
  25.     n must be from 1 to 9
  26.     
  27.     XP_MessageLen returns the length of the formatted message, including 
  28.     the terminating NULL. 
  29.     
  30.     XP_Message formats the message into the given buffer, not exceeding
  31.     bufferLen (which includes the terminating NULL). If there isn't enough 
  32.     space, XP_Message will truncate the text and terminate it (unlike
  33.     strncpy, which will truncate but not terminate).
  34.     
  35.     XP_StaticMessage is like XP_Message but maintains a private buffer 
  36.     which it resizes as necessary.
  37. -----------------------------------------------------------------------------*/
  38.  
  39. #ifndef _XP_Message_
  40. #define _XP_Message_
  41.  
  42. #include "xp_core.h"
  43.  
  44. XP_BEGIN_PROTOS
  45.  
  46. int
  47. XP_MessageLen (const char * format, ...);
  48.  
  49. void
  50. XP_Message (char * buffer, int bufferLen, const char * format, ...);
  51.  
  52. const char *
  53. XP_StaticMessage (const char * format, ...);
  54.  
  55. XP_END_PROTOS
  56.  
  57. #endif /* _XP_Message_ */
  58.  
  59.