Image, Audio und Video Extender Verwaltung und Programmierung

FindInstrument


Image Audio Video
  X  

Gibt die Spurnummer des ersten Auftretens eines bestimmten Instruments in einem MIDI-Ton zurück.

Kopfdatei

dmbaudio.h

Syntax

>>-FindInstrument--(--kennung--,--instrument--)----------------><
 

Parameter (Datentyp)

kennung (DB2AUDIO)
Name der Spalte oder Host-Variable, die die Kennung des Tons enthält.

instrument (VARCHAR(255))
Name des Instruments, nach dem gesucht werden soll. Der Audio Extender sucht nach einem Instrument, dessen Name exakt mit dem angegebenen Namen übereinstimmt.

Rückgabewerte (Datentyp)

Nummer der Spur, die das erste Auftreten eines angegebenen Instrumentennamens enthält (SMALLINT). Der Wert -1 wird zurückgegeben, wenn kein Instrument mit dem angegebenen Namen gefunden wird. NULL wird für Töne in anderen Formaten zurückgegeben.

Beispiele

Suchen des ersten Auftretens von PIANO in der MIDI-Tonaufzeichnung für Robert Smith, die in der Spalte 'sound' der Tabelle 'employee' gespeichert ist:

EXEC SQL BEGIN DECLARE SECTION;
      short hvInstr;
  EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT FINDINSTRUMENT(SOUND, 'PIANO')
      INTO :hvInstr
  FROM EMPLOYEE
      WHERE NAME = 'Robert Smith';


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]