_PutStr( ), API-Bibliotheksroutine

Gibt eine mit Nullzeichen abgeschlossene Zeichenfolge an der Ausgabeposition im aktuellen Ausgabefenster mit dem Attribut Normal (Farbe 0) aus.

void _PutStr(char FAR *str)
char FAR *str;               /* String to display. */

Hinweise

_PutStr( ) interpretiert Sonderzeichen wie z. B. einen Zeilenvorschub, Wagenrücklauf und ein akustisches Systemsignal (bell) als Steuerzeichen und zeigt diese nicht auf dem Bildschirm an.

Weitere Informationen zum Erstellen einer API-Bibliothek und ihrer Integration in Visual FoxPro finden Sie unter Zugreifen auf die Visual FoxPro-API.

Beispiel

Im folgenden Beispiel wird _PutStr( ) verwendet, um den zugehörigen Zeichentypparameter in Großbuchstaben auf dem Bildschirm anzuzeigen.

Visual FoxPro-Code

SET LIBRARY TO PUTSTR  
= XUPPER("upper")  && displays "UPPER" on the screen

C-Code

#include "pro_ext.h"

void NullTerminate(Value FAR *cVal)
{
   if (!_SetHandSize(cVal->ev_handle, cVal->ev_length + 1))
   {
      _Error(182); // "Insufficient memory"
   }
   ((char FAR *) _HandToPtr(cVal->ev_handle))[cVal->ev_length] = '\0';
}

FAR Example(ParamBlk FAR *parm)
{
   char FAR *pString;
   int i;

   NullTerminate(&parm->p[0].val);
   pString = _HandToPtr(parm->p[0].val.ev_handle);
   for (i = 0; i < parm->p[0].val.ev_length; i++)
   {
      if ('a' <= *pString && *pString <= 'z')
      {
         *pString += ('A' - 'a');
      }
      pString++;
   }
   _HLock(parm->p[0].val.ev_handle);
   _PutStr(_HandToPtr(parm->p[0].val.ev_handle));
   _HUnLock(parm->p[0].val.ev_handle);
}

FoxInfo myFoxInfo[] = {
   {"XUPPER", (FPFI) Example, 1, "C"},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Siehe auch

_PutChr( ), API-Bibliotheksroutine | _PutValue( ), API-Bibliotheksroutine | Zugreifen auf die Visual FoxPro-API | _WPutChr( ), API-Bibliotheksroutine | _WPutStr( ), API-Bibliotheksroutine