--[[

    文件名：promotion.lua

    功能描述：該文件通過函數promotion()實現晉級功能。
              文件中使用的參數members、nos、num都是從Java中傳入，為全局變量。
            members為參賽成員ArrayList，nos為編排后的晉級ArrayList，num為每小組晉級隊數。
            members的數據格式類似于：
              members[0][0]="member00"	members[0][1]="member01" ...
              
              members[1][0]="member00"	members[1][1]="member01" ...
              
              members[2][0]="member00"	members[2][1]="member01" ...
            
              編排后數據格式類似于：

              nos[0][0]="member00"	nos[0][1]="member01"	nos[0][2]="member02"

              nos[1][0]="member10"	nos[1][1]="member11"	nos[1][2]="member12"

              nos[2][0]="member20"	nos[2][1]="member21"	nos[2][2]="member22"

    參數列表：promotion()函數包含三個參數members、nos、num。

    參數類型：members是Java中的ArrayList類型，在Lua中是userdata類型；
            nos是Java中的ArrayList類型，在Lua中是userdata類型；
            num是Java中的int類型，在Lua中是Number類型。

    返回值：文件返回三個值list、nos、num

    返回值類型：members是Java中的ArrayList類型，在Lua中是userdata類型；
              nos是Java中的ArrayList類型，在Lua中是userdata類型；
              num是Java中的int類型，在Lua中是Number類型。

    返回值說明：members為參賽成員ArrayList，nos為編排后的晉級ArrayList，num為每小組晉級隊數。


    2007年6月22日	程峰

]]--



------------------------------------------------------------------------
-- 函數promotion()的定義，實現晉級編排
-- 參數members為參賽成員ArrayList，nos為編排后對陣的ArrayList
-- num為每小組晉級數
function promotion( members, nos, num )

    number=members:size()         -- 小組數

    for i=0, number-1 do
        member=luajava.newInstance("java.util.ArrayList")
        for j=0, num-1 do
            member:add((members:get(i)):get(j))
        end
        nos:add(member)
    end

end   -- end method consolation
-------------------------------------------------------------------------------



--判斷全局變量members是否正常傳入
if members==nil then
    print("Error. members object is nil")
    return
end

--判斷全局變量nos是否正常傳入
if nos==nil then
    print("Error. nos object is nil")
    return
end

--判斷全局變量num是否正常傳入
if num==nil then
    print("Error. num object is nil")
    return
end

promotion( members, nos, num )