PA_SetStringField

version 2003

PA_SetStringField (tNum; fNum; string)

The routine PA_SetStringField fills the string field number fNum of the current record of the table number tNum with string .

If the field is not a string field, the routine does nothing and sets an error in PA_GetLastError ().

By default, string needs to be a null terminated C string. If you have previously called PA_UsePStrings, you need to pass a Pascal string to the command.

By default, string needs to use the Macintosh characters set on Macintosh, and the ANSI characters set under Windows. You can call PA_UseMacCharacters or PA_UseAnsiCharacters to specifically use Macintosh or ANSI characters.

Initialize a selection of record to a default string

(No error, locking problem checking in this sample)

   void SetSelectionString( short tNum, short fNum, char *newValue )
   {
      PA_FirstRecord(tNum);
      while ( ! PA_EndSelection( tNum ) )
      {
         PA_Yield();
         PA_SetStringField( tNum, fNum, newValue );
         PA_SaveRecord( tNum );
         PA_NextRecord( tNum );
      }
   }

PA_GetStringField , PA_UseAnsiCharacters , PA_UseCStrings , PA_UseMacCharacters , PA_UsePStrings .

Use PA_GetLastError to see if an error occurred ( eER_InvalidFileNumber , eER_InvalidFieldNumber ).