sudoku.h 3.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. /*====================================================================*
  2. - Copyright (C) 2001 Leptonica. All rights reserved.
  3. -
  4. - Redistribution and use in source and binary forms, with or without
  5. - modification, are permitted provided that the following conditions
  6. - are met:
  7. - 1. Redistributions of source code must retain the above copyright
  8. - notice, this list of conditions and the following disclaimer.
  9. - 2. Redistributions in binary form must reproduce the above
  10. - copyright notice, this list of conditions and the following
  11. - disclaimer in the documentation and/or other materials
  12. - provided with the distribution.
  13. -
  14. - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  15. - ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  16. - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  17. - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANY
  18. - CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  19. - EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20. - PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  21. - PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  22. - OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  23. - NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  24. - SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25. *====================================================================*/
  26. #ifndef SUDOKU_H_INCLUDED
  27. #define SUDOKU_H_INCLUDED
  28. /*
  29. * sudoku.h
  30. *
  31. * The L_Sudoku holds all the information of the current state.
  32. *
  33. * The input to sudokuCreate() is a file with any number of lines
  34. * starting with '#', followed by 9 lines consisting of 9 numbers
  35. * in each line. These have the known values and use 0 for the unknowns.
  36. * Blank lines are ignored.
  37. *
  38. * The @locs array holds the indices of the unknowns, numbered
  39. * left-to-right and top-to-bottom from 0 to 80. The array size
  40. * is initialized to @num. @current is the index into the @locs
  41. * array of the current guess: locs[current].
  42. *
  43. * The @state array is used to determine the validity of each guess.
  44. * It is of size 81, and is initialized by setting the unknowns to 0
  45. * and the knowns to their input values.
  46. */
  47. struct L_Sudoku
  48. {
  49. l_int32 num; /* number of unknowns */
  50. l_int32 *locs; /* location of unknowns */
  51. l_int32 current; /* index into @locs of current location */
  52. l_int32 *init; /* initial state, with 0 representing */
  53. /* the unknowns */
  54. l_int32 *state; /* present state, including inits and */
  55. /* guesses of unknowns up to @current */
  56. l_int32 nguess; /* shows current number of guesses */
  57. l_int32 finished; /* set to 1 when solved */
  58. l_int32 failure; /* set to 1 if no solution is possible */
  59. };
  60. typedef struct L_Sudoku L_SUDOKU;
  61. /* For printing out array data */
  62. enum {
  63. L_SUDOKU_INIT = 0,
  64. L_SUDOKU_STATE = 1
  65. };
  66. #endif /* SUDOKU_H_INCLUDED */