CAPL Script

Get Next C A Ndb Name

Syntax

dword getNextCANdbName( dword pos, char buffer[], dword size)

Function

Finds out the names of the other assigned databases withpos.

Parameters

pos Position number of the database to be found.

buffer

Buffer in which the database name is written.

size

Size of the buffer in Byte.

Return Values

If successful unequal 0, otherwise 0.

on start{char buffer[256];dword pos;pos = getFirstCANdbName( buffer, elcount( buffer));//Finds the name of the first database.//If a database is found, "pos" contains the value 1.//If none is found "pos" contains 0.while ( 0 != pos){write( "CANdb: %s", buffer);pos = getNextCANdbName( pos, buffer, elcount( buffer));//Finds the names of other databases.//If any other databases are found//"pos" contains the value 2, 3, etc//If no further databases are found//"pos" contains 0 and the loop is exited}}Example to find the third databaseon key '3'{char buffer[256];dword pos;dword DbcNumber = 2; //Position number of the second databasepos = getNextCANdbName(DbcNumber, buffer, elcount(buffer));//Returns the name of the third database.//Return value "pos" contains the value 3.//If no third database is found "pos" contains 0.write( "Database position number : %d Database name : %s",pos, buffer);}

getFirstCANdbName | getMessageName | getNextCANdbFilename